Une fois que l'administrateur vSphere vous a fourni l'adresse IP du plan de contrôle Kubernetes sur le Superviseur, vous pouvez vous connecter au Superviseur et obtenir les contextes auxquels vous avez accès. Dans vSphere IaaS control plane, les contextes correspondent aux espaces de noms sur le Superviseur.

Une fois que vous êtes connecté à Superviseur, Plug-in vSphere pour kubectl génère le contexte du cluster. Dans Kubernetes, un contexte de configuration contient un cluster, un espace de noms et un utilisateur. Vous pouvez afficher le contexte du cluster dans le fichier .kube/config. Ce fichier est communément appelé fichier kubeconfig.
Note : Si vous disposez d'un fichier kubeconfig existant, celui-ci est ajouté à chaque contexte du cluster. Plug-in vSphere pour kubectl respecte la variable d'environnement KUBECONFIG déjà utilisée par kubectl elle-même. Bien que cela ne soit pas obligatoire, il peut être utile de définir cette variable avant d'exécuter kubectl vsphere login ... afin que les informations soient écrites dans un nouveau fichier au lieu d'être ajoutées à votre fichier kubeconfig actuel.

Conditions préalables

  • Obtenez vos informations d'identification vCenter Single Sign-On.
  • Obtenez l'adresse IP du plan de contrôle du Superviseur.
  • Obtenez le nom de l'Espace de noms vSphere.
  • Obtenez la confirmation que vous disposez des autorisations Modification sur l'Espace de noms vSphere.
  • Téléchargez et installez les outils d'interface de ligne de commande Kubernetes pour vSphere. Consultez la documentation de Installation et configuration du plan de contrôle IaaS vSphere.
  • Vérifiez que le certificat desservi par le plan de contrôle Kubernetes est approuvé sur votre système, soit en faisant en sorte que l'autorité de certification de signature soit installée en tant que racine d'approbation, soit en ajoutant le certificat en tant que racine d'approbation directement. Reportez-vous à la section Configurer la connexion sécurisée pour les clusters de plan de contrôle IaaS vSphere dans la documentation de Installation et configuration du plan de contrôle IaaS vSphere.

Procédure

  1. Pour afficher la syntaxe et les options de la commande pour la connexion, exécutez la commande suivante. 
    kubectl vsphere login --help
  2. Exécutez la commande suivante pour vous connecter à Superviseur. 
    kubectl vsphere login --server=<KUBERNETES-CONTROL-PLANE-IP-ADDRESS> --vsphere-username <VCENTER-SSO-USER>
    Par exemple : 
    kubectl vsphere login --server=10.92.42.13 --vsphere-username [email protected]
    Cette action crée un fichier de configuration avec le jeton Web JSON (JWT) afin de s'authentifier auprès de l'API Kubernetes.
  3. Entrez le mot de passe de l'utilisateur pour vous authentifier.
    Une fois que vous êtes connecté à Superviseur, vous pouvez voir les contextes de configuration auxquels vous pouvez accéder. Par exemple : 
    You have access to the following contexts:
tanzu-ns-1
tkg-cluster-1
tkg-cluster-2
  4. Pour afficher les détails des contextes de configuration auxquels vous pouvez accéder, exécutez la commande kubectl suivante : 
    kubectl config get-contexts
    L'interface de ligne de commande affiche les détails de chaque contexte disponible.
  5. Pour basculer entre les contextes, utilisez la commande suivante : 
    kubectl config use-context <example-context-name>

Que faire ensuite

Pour vous connecter à un cluster Tanzu Kubernetes Grid, reportez-vous à la section Se connecter à un cluster Tanzu Kubernetes en tant qu'utilisateur vCenter Single Sign-On dans Utilisation du service TKG avec le plan de contrôle IaaS vSphere.