Connect to Supervisor using the vSphere Plugin for kubectl and authenticate with your vCenter Single Sign-On credentials.
Note: If you have an existing kubeconfig file, it is appended with each cluster context. The vSphere Plugin for kubectl respects the KUBECONFIG environment variable that kubectl itself uses. Although not required, it can be useful to set this variable before running
kubectl vsphere login ...so that the information is written to a new file, instead of being added to your current
- Install the Kubernetes CLI Tools for vSphere.
- Get your vCenter Single Sign-On credentials.
- Get the IP address of the Supervisor control plane from your vSphere administrator.
- Get the name of the vSphere Namespace from the your vSphere administrator.
- Verify that you have Edit permissions on the vSphere Namespace. See Configure vSphere Namespace Permissions for vCenter Single Sign-On Users and Groups.
- Verify that the certificate served by the Kubernetes control plane is trusted on your system, either by having the signing CA installed as a Trust Root or by adding the certificate as a Trust Root directly. See Configure Secure Login for vCenter Single Sign-On Authentication.
- To view the command syntax and options for logging in, run the following command.
kubectl vsphere login --help
- To connect to the Supervisor, run the following command.
kubectl vsphere login --server=<KUBERNETES-CONTROL-PLANE-IP-ADDRESS> --vsphere-username <VCENTER-SSO-USER>For example:
kubectl vsphere login --server=10.92.42.13 --vsphere-username firstname.lastname@example.orgThis action creates a configuration file with the JSON Web Token (JWT) to authenticate to the Kubernetes API.
- To authenticate, enter the password for the user.
After you connect to the Supervisor, you are presented with the configuration contexts can access. For example:
You have access to the following contexts: tanzu-ns-1 tkg-cluster-1 tkg-cluster-2
- To view details of the configuration contexts which you can access to, run the following
kubectl config get-contextsThe CLI displays the details for each available context.
- To switch between contexts, use the following command:
kubectl config use-context <example-context-name>