tanzu context

Manages Tanzu CLI contexts.

Usage

System commands | Primarily used for: Tanzu CLI

Syntax:

tanzu context [COMMAND]

Aliases

context, ctx, and contexts

Global Flags

-h, --help

Help text.

tanzu context create

Creates a Tanzu CLI context.

Usage

tanzu context create CONTEXT-NAME [FLAGS]

Examples

To create a Tanzu Kubernetes Grid (TKG) management cluster context, for example, my-management-cluster, using an endpoint:

tanzu context create my-management-cluster --endpoint "https://example.com" --endpoint-ca-certificate PATH-TO-CA-CERTIFICATE

To create a TKG management cluster context using a kubeconfig path and context:

tanzu context create my-management-cluster --kubeconfig PATH-TO-KUBECONFIG --kubecontext KUBECONFIG-CONTEXT

Note: The command in the example above replaces tanzu login --kubeconfig PATH-TO-KUBECONFIG --context KUBECONFIG-CONTEXT --name SERVER-NAME.

To create a TKG management cluster context using the default kubeconfig path and a kubeconfig context:

tanzu context create my-management-cluster --kubecontext KUBECONFIG-CONTEXT

Flags

--endpoint

The endpoint that you are creating the context for.

--endpoint-ca-certificate

The path to the endpoint CA bundle for TLS verification.

-h, --help

Help text.

--insecure-skip-tls-verify

Skip TLS certificate verification when creating a context using --endpoint.

--kubeconfig

The path to the kubeconfig file of the cluster. If only the --kubecontext flag is set, tanzu context create reads the KUBECONFIG environment variable. If the KUBECONFIG environment variable is not set, the default kubeconfig path, $HOME/.kube/config, is used.

--kubecontext

The context in the kubeconfig file to use.

tanzu context delete

Deletes a context from the Tanzu CLI.

Note: This command replaces tanzu config server delete.

Usage

tanzu context delete CONTEXT-NAME [FLAGS]

Example

To delete a context named my-management-cluster:

tanzu context delete my-management-cluster

Flags

-h, --help

Help text.

-y, --yes

When specified, tanzu context delete skips the confirmation step.

tanzu context get

Displays the specified context.

Usage

tanzu context get CONTEXT-NAME [FLAGS]

Example

To get a context named my-management-cluster:

tanzu context get my-management-cluster

Flags

-h, --help

Help text.

-o, --output

Output format. Supported values are yaml and json. Default is yaml.

tanzu context list

Lists Tanzu CLI contexts.

Note: This command replaces tanzu config server list.

Usage

tanzu context list [FLAGS]

Example

To list all Tanzu CLI contexts:

tanzu context list

Flags

--current

When specified, the command lists only active contexts.

-h, --help

Help text.

-o, --output

Output format. Supported values are yaml, json, and table. Default is table.

-t, --target

Context type. Supported values are k8s and tmc.

tanzu context unset

Unsets the specified context.

Usage

tanzu context unset CONTEXT-NAME [FLAGS]

Example

To unset a context named my-management-cluster:

tanzu context unset my-management-cluster

Flags

-h, --help

Help text.

-t, --target

The target with which the specified context is associated. Supported values are kubernetes, or k8s, and mission-control, or tmc.

tanzu context use

Sets the current context for the Tanzu CLI.

Note: This command replaces tanzu login --server SERVER-NAME.

Usage

tanzu context use CONTEXT-NAME [FLAGS]

Example

To set the current context to my-management-cluster:

tanzu context use my-management-cluster

Flags

-h, --help

Help text.