This section includes tips to help you to troubleshoot common problems that you might encounter when installing Tanzu Kubernetes Grid and deploying workload clusters.
You can use SSH to connect to individual nodes of management clusters or workload clusters. To do so, the SSH key pair that you created when you deployed the management cluster must be available on the machine on which you run the SSH command. Consquently, you must run
ssh
commands on the machine on which you run
tanzu
commands.
The SSH keys that you register with the management cluster, and consequently that are used by any workload clusters that you deploy from the management cluster, are associated with the following user accounts:
vSphere management cluster and Tanzu Kubernetes nodes running on both Photon OS and Ubuntu:
capv
AWS bastion nodes:
ubuntu
AWS management cluster and Tanzu Kubernetes nodes running on Ubuntu:
ubuntu
AWS management cluster and Tanzu Kubernetes nodes running on Amazon Linux:
ec2-user
Azure management cluster and Tanzu Kubernetes nodes (always Ubuntu):
capi
To connect to a node by using SSH, run one of the following commands from the machine that you use as the bootstrap machine:
vSphere nodes:
ssh capv@
node_address
AWS bastion nodes and management cluster and workload nodes on Ubuntu:
ssh ubuntu@
node_address
AWS management cluster and Tanzu Kubernetes nodes running on Amazon Linux:
ssh ec2-user@
node_address
Azure nodes:
ssh capi@
node_address
Because the SSH key is present on the system on which you are running the
ssh
command, no password is required.
To clean up your
kubectl
state by deleting some or all of its users, contexts, and clusters:
Open your
~/.kube/config
and
~/.kube-tkg/config
files.
For the
user
objects that you want to delete, run:
kubectl config unset users.USER-NAME
kubectl config unset users.USER-NAME --kubeconfig ~/.kube-tkg/config
Where
USER-NAME
is the
name
property of each top-level
user
object, as listed in the
config
files.
For the
context
objects that you want to delete, run:
kubectl config unset contexts.CONTEXT-NAME
kubectl config unset contexts.CONTEXT-NAME --kubeconfig ~/.kube-tkg/config
Where
CONTEXT-NAME
is the
name
property of each top-level
context
object, as listed in the
config
files, typically of the form
contexts.mycontext-admin@mycontext
.
For the
cluster
objects that you want to delete, run:
kubectl config unset clusters.CLUSTER-NAME
kubectl config unset clusters.CLUSTER-NAME --kubeconfig ~/.kube-tkg/config
Where
CLUSTER-NAME
is the
name
property of each top-level
cluster
object, as listed in the
config
files.