Installer et déployer le Webhook PVCSI vSphere

Installez et déployez le Webhook PVCSI vSphere dans un cluster Service TKG. Le Webhook PVCSI vSphere est un composant avec rappel qui répond aux demandes d'admission CSI. Il est responsable de la validation des objets Kubernetes, tels que les réclamations de volume persistant, les volumes persistants, les classes de stockage, etc.

Le Webhook PVCSI vSphere s'installe automatiquement dans un Superviseur. Cette rubrique s'applique uniquement aux clusters Service TKG.

Conditions requises

Vous disposez d'un Superviseur en cours d'exécution.
Vous avez installé l'interface de ligne de commande Tanzu et kubectl. Pour plus d'informations, consultez Installation des outils d'interface de ligne de commande pour les clusters du Service TKG.
Vous vous êtes connecté au cluster TKG. Pour plus d'informations, consultez Connexion à des clusters Service TKG à l'aide de l'authentification vCenter SSO.

Préparer un cluster de Service TKG pour l'installation du Webhook PVCSI vSphere

Suivez ces étapes pour préparer votre cluster de Service TKG pour l'installation du Webhook PVCSI vSphere.

Procédure

Obtenez les informations d'identification de l'administrateur du cluster TKG sur lequel vous souhaitez déployer le Webhook PVCSI vSphere.
```
tanzu cluster kubeconfig get my-cluster --admin
```
Changez de contexte pour utiliser l'Espace de noms vSphere dans lequel le cluster TKG cible est provisionné.
```
kubectl config use-context my-cluster-admin@my-cluster
```
Si le cluster ne dispose pas d'un référentiel de modules sur lequel le module vsphere-pv-csi-webhook est installé, tel que le référentiel tanzu-standard, installez-en un.
Vous pouvez ignorer cette étape si votre cluster cible est un cluster hérité basé sur un plan. Pour les clusters basés sur un plan, le référentiel de modules tanzu-standard est automatiquement activé dans l'espace de noms tanzu-package-repo-global.
```
tanzu package repository add PACKAGE-REPO-NAME --url PACKAGE-REPO-ENDPOINT --namespace tkg-system
```
- PACKAGE-REPO-NAME est le nom du référentiel de modules, tel que tanzu-standard, ou le nom d'un registre d'images privé configuré avec les variables ADDITIONAL_IMAGE_REGISTRY.
- PACKAGE-REPO-ENDPOINT est l'URL du référentiel de modules.
Si vous ne l'avez pas déjà fait, installez le module cert-manager.
Pour plus d'informations, consultez Installer le gestionnaire de certificats.

Résultats

Vous pouvez désormais déployer le Webhook PVCSI vSphere.

Déployer le Webhook PVCSI vSphere

Suivez ces étapes pour déployer le Webhook PVCSI vSphere sur un cluster Service TKG.

Procédure

Vérifiez que le module Webhook PVCSI vSphere est disponible dans le cluster.
```
tanzu package available list -A
```
Si le module n'est pas disponible, assurez-vous que le référentiel de modules contenant le module Webhook PVCSI requis vSphere est correctement installé. Pour obtenir des instructions, reportez-vous à l'étape 3 de Préparer un cluster de Service TKG pour l'installation du Webhook PVCSI vSphere.

Obtenez la version du module disponible.

tanzu package available list vsphere-pv-csi-webhook.tanzu.vmware.com -A

Installez le module avec la version disponible appropriée.
```
tanzu package install vsphere-pv-csi-webhook --package vsphere-pv-csi-webhook.tanzu.vmware.com --version AVAILABLE-PACKAGE-VERSION --namespace TARGET-NAMESPACE
```
- TARGET-NAMESPACE spécifie l'espace de noms dans lequel vous souhaitez installer le module vsphere-pv-csi-webhook.
  Note : TARGET-NAMESPACE doit être identique à l'espace de noms dans lequel le module vsphere-pv-csi est installé.
  Si vous ne spécifiez pas l'indicateur --namespace, l'interface de ligne de commande Tanzu installe le module et ses ressources dans l'espace de noms par défaut, par exemple vmware-system-csi pour le module vsphere-pv-csi-webhook. L'espace de noms spécifié doit déjà exister, par exemple, à partir de l'exécution de kubectl create namespace vmware-system-csi.
- AVAILABLE-PACKAGE-VERSION spécifie la version du module que vous avez obtenue à l'étape 2.
Vérifiez que le module Webhook PVCSI vSphere a été installé.
```
tanzu package installed list -A
```
Pour afficher plus de détails sur le module, vous pouvez également exécuter la commande suivante :
```
tanzu package installed get vsphere-pv-csi-webhook --namespace TARGET-NAMESPACE
```
Vérifiez que l'application vsphere-pv-csi-webhook a été correctement rapprochée dans votre TARGET-NAMESPACE.
```
kubectl get apps -A
```
Si l'état n'est pas Reconcile Succeeded, affichez les détails de l'état complet de l'application vsphere-pv-csi-webhook. L'affichage de l'état complet peut vous aider à résoudre le problème.
```
kubectl get app vsphere-pv-csi-webhook --namespace TARGET-NAMESPACE -o yaml
```
Si le dépannage ne vous aide pas à résoudre le problème, désinstallez le module à l'aide de la commande suivante, avant de le réinstaller.
```
tanzu package installed delete vsphere-pv-csi-webhook --namespace TARGET-NAMESPACE
```
Vérifiez que vsphere-pv-csi-webhook est en cours d'exécution en répertoriant tous les espaces du cluster.
```
kubectl get pods -A
```
Vérifiez que les espaces vsphere-pv-csi-webhook sont créés dans vmware-system-csi OU TARGET-NAMESPACE.