List all vclusters in the current Kubernetes context.

This function retrieves all vclusters managed by the vcluster platform in the current Kubernetes context. It sets up the Kubernetes client internally and returns the list of vclusters as serialized JSON on success, or an error object if the command failed.

Args: kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[Dict, List, str]: List of vclusters on success, or error object if failed.

Describe a specific vcluster in detail.

This function retrieves detailed information about a specific vcluster, including its status, resources, and configuration. The information is returned as serialized JSON on success, or an error object if the command failed.

Args: name: The name of the vcluster to describe. namespace: Optional namespace where the vcluster is located. If not provided, defaults to the vcluster name. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[Dict, str]: Detailed vcluster information on success, or error object if failed.

Pause a running vcluster.

This function pauses a running vcluster, which stops the virtual cluster without deleting it. This is useful for temporarily suspending workloads while preserving the cluster state.

Args: name: The name of the vcluster to pause. namespace: Optional namespace where the vcluster is located. If not provided, defaults to the vcluster name. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[CommandResult, str]: CommandResult on success, or error object if failed.

Resume a paused vcluster.

This function resumes a previously paused vcluster, restoring its operation and allowing workloads to run again.

Args: name: The name of the vcluster to resume. namespace: Optional namespace where the vcluster is located. If not provided, defaults to the vcluster name. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[CommandResult, str]: CommandResult on success, or error object if failed.

Delete a vcluster.

This function deletes a vcluster and optionally its namespace. This action is irreversible - the cluster and all its resources will be permanently removed.

Args: name: The name of the vcluster to delete. namespace: Optional namespace where the vcluster is located. If not provided, defaults to the vcluster name. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[CommandResult, str]: CommandResult on success, or error object if failed.

Create a new vcluster.

This function creates a new vcluster with the specified name. Optionally, you can provide a values file to customize the vcluster configuration during creation. If the upgrade parameter is set to True, the cluster will be upgraded if it was created before.

Args: name: The name for the new vcluster. values: Optional path to a values file for vcluster configuration. upgrade: Optional flag to upgrade the cluster if it was created before. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[CommandResult, str]: CommandResult on success, or error object if failed.

Execute a command inside a vcluster.

This function connects to a running vcluster and executes the given command within the virtual cluster context. It uses vcluster connect with the server-side flag to establish the connection and run the command.

Args: name: The name of the vcluster to connect to and execute the command in. command: The command string to execute inside the vcluster. Supports standard shell quoting (e.g. "kubectl get pods -n default"). namespace: Optional namespace where the vcluster is located. If not provided, defaults to vcluster-<name>. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[CommandResult, Dict[str, str], str]: CommandResult with exit code and output on success, or error object if failed.

Disconnect from a vcluster.

Returns: Union[CommandResult, str]: CommandResult on success, or error object if failed.

Get labels for a specific namespace.

This function retrieves all labels associated with a Kubernetes namespace. Labels are key-value pairs that can be used to organize and select resources.

Args: namespace: The name of the namespace to get labels from. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[Dict[str, str], str]: Dictionary of labels on success, or error object if failed.

Create or update a label on a namespace.

This function creates a new label or updates an existing label on a Kubernetes namespace. Labels are key-value pairs used for organizing and selecting resources.

Args: namespace: The name of the namespace to label. key: The label key to set. value: The label value to assign. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[bool, str]: True on success, or error object if failed.

Delete a label from a namespace.

This function removes a label from a Kubernetes namespace. If the label doesn't exist, the operation is considered successful.

Args: namespace: The name of the namespace to remove the label from. key: The label key to delete. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[bool, str]: True on success (or if label didn't exist), or error object if failed.

Get annotations for a specific namespace.

This function retrieves all annotations associated with a Kubernetes namespace. Annotations are similar to labels but are typically used for storing non-identifying metadata.

Args: namespace: The name of the namespace to get annotations from. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[Dict[str, str], str]: Dictionary of annotations on success, or error object if failed.

Create or update an annotation on a namespace.

This function creates a new annotation or updates an existing annotation on a Kubernetes namespace. Annotations are key-value pairs used for storing non-identifying metadata such as descriptions, links, or configuration data.

Args: namespace: The name of the namespace to annotate. key: The annotation key to set. value: The annotation value to assign. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[bool, str]: True on success, or error object if failed.

Delete an annotation from a namespace.

This function removes an annotation from a Kubernetes namespace. If the annotation doesn't exist, the operation is considered successful.

Args: namespace: The name of the namespace to remove the annotation from. key: The annotation key to delete. kubeconfig_path: Optional path to a kubeconfig file. If not provided, the default kubeconfig from the environment will be used.

Returns: Union[bool, str]: True on success (or if annotation didn't exist), or error object if failed.