Installer la CLI Tanzu et la CLI Kubernetes à utiliser avec des clusters de gestion autonomes

Cette rubrique explique comment installer la CLI (interface de ligne de commande) Tanzu sur une machine de démarrage. La machine de démarrage est l'ordinateur portable, l'hôte ou le serveur à partir duquel vous déployez des clusters de gestion et de charge de travail, et qui conserve les fichiers de configuration Tanzu et Kubernetes pour vos déploiements. La machine de démarrage est généralement locale, mais il peut également s'agir d'une machine physique ou d'une machine virtuelle à laquelle vous accédez à distance. Pour plus d'informations sur la CLI Tanzu, y compris une référence de commande, reportez-vous à la documentation de la CLI VMware Tanzu v1.0.x.

Pour déployer Tanzu Kubernetes Grid sur vSphere sans superviseur, sur AWS ou sur Azure, utilisez la CLI Tanzu pour créer un cluster de gestion autonome sur chaque fournisseur de cloud de votre environnement. La CLI Tanzu communique avec ce cluster de gestion pour créer et gérer des clusters de charge de travail sur votre infrastructure du cloud.

Remarque
Les instructions de cette rubrique sont spécifiques à l'installation de la CLI Tanzu afin de déployer des clusters de gestion autonomes sur vSphere sans superviseur, sur AWS ou sur Azure. Si vous installez la CLI Tanzu pour l'utiliser avec un superviseur vSphere with Tanzu sur vSphere 8, reportez-vous à la rubrique correspondante dans la section Créer et gérer des clusters de charge de travail TKG 2.3 avec la CLI Tanzu, Installer la CLI Tanzu et la CLI Kubernetes à utiliser avec un superviseur vSphere with Tanzu.

Conditions requises

La machine de démarrage sur laquelle vous installez et exécutez la CLI Tanzu à utiliser avec Tanzu Kubernetes Grid doit répondre à certaines exigences. Il existe d'autres conditions requises selon que vous prévoyez d'utiliser la CLI Tanzu avec un superviseur vSphere with Tanzu comme cluster de gestion, de déployer des clusters de gestion autonomes, ou les deux.

Pour exécuter la CLI Tanzu avec Tanzu Kubernetes Grid v2.3, vous avez besoin d'une machine de démarrage sur laquelle installer et exécuter la CLI Tanzu qui dispose des éléments suivants :

Un système d'exploitation Linux, Windows ou macOS exécuté sur une machine physique ou virtuelle disposant du matériel suivant :
- Au moins 8 Go de RAM. VMware recommande 16 Go de RAM.
- Un disque disposant de 50 Go de stockage disponible.
- 2 ou 4 CPU à 2 cœurs.
Un navigateur ou un accès distant à partir d'une machine avec un navigateur, si vous prévoyez d'utiliser l'interface du programme d'installation de Tanzu Kubernetes Grid pour déployer des clusters de gestion autonomes. Vous pouvez utiliser la CLI Tanzu sans navigateur, mais pour les premiers déploiements, il est fortement recommandé d'utiliser l'interface du programme d'installation.
L'heure système est synchronisée avec un serveur NTP (Network Time Protocol).
Si votre machine de démarrage exécute Windows, VMware recommande d'installer le sous-système Windows pour Linux (WSL) avec Ubuntu 20.04.4 LTS, ce qui vous permet d'exécuter des commandes Linux sous Windows. Pour plus d'informations sur WSL, reportez-vous à la section Installer WSL de la documentation de Microsoft.
Sur VMware Cloud on AWS et Azure VMware Solution, la machine de démarrage doit être une machine virtuelle cloud et non une machine physique locale. Pour obtenir des instructions sur la configuration, reportez-vous à la section Préparer le déploiement de clusters de gestion dans un environnement VMware Cloud.
Pour déployer des clusters de gestion autonomes, il existe des conditions requises supplémentaires selon le système d'exploitation exécuté par la machine de démarrage :
macOS
- Une application Docker Desktop installée et en cours d'exécution sur votre machine de démarrage.
- Allouez au moins 6 Go de mémoire dans Docker Desktop pour recevoir le conteneur kind. Reportez-vous à la section Paramètres du poste de travail Docker dans la documentation kind.
Linux
- Une application Docker installée et en cours d'exécution sur votre machine de démarrage. Utilisez apt plutôt que snap pour installer Docker à partir d'un gestionnaire de modules. Pour obtenir des instructions sur l'installation de l'application cliente Docker dans un environnement à accès restreint à Internet, reportez-vous à la section Préparer un environnement à accès restreint à Internet.
- Ajoutez votre compte d'utilisateur non racine au groupe d'utilisateurs docker. Créez le groupe s'il n'existe pas. Cela permet à la CLI Tanzu d'accéder au socket Docker, qui appartient à l'utilisateur root. Pour plus d'informations, reportez-vous à la section Gérer Docker en tant qu'utilisateur non racine dans la documentation de Docker.
- Si votre machine de démarrage exécute Ubuntu 22.04, assurez-vous que le filtrage de chemin inverse est désactivé. Pour désactiver le filtrage de chemin inverse, ajoutez le remplacement suivant :
  
  # New file /etc/sysctl.d/90-override.conf ipv4.conf.all.rp_filter = 0
- Si votre machine de démarrage dispose d'un noyau Linux créé après le correctif de sécurité Linux de mai 2021, vous devez activer kind, que la CLI Tanzu utilise pour créer le cluster de démarrage local, pour écrire dans un fichier de contrôle que les versions récentes de Linux configurent en lecture seule par défaut.
  
  La modification de cette autorisation de fichier dépend de votre distribution Linux. Par exemple, avec une distribution Fedora de Linux 5.11 ou 5.12, exécutez :
  
  sudo sysctl net/netfilter/nf_conntrack_max=131072
  
  Avec une distribution Debian, ajoutez nf_conntrack_max=131072 au fichier sysctl.conf et exécutez :
  
  sudo modprobe nf_conntrack
  
  Si vous effectuez un dépannage comme décrit dans Utiliser un cluster de démarrage existant pour déployer et supprimer des clusters de gestion, vous devez utiliser kind v0.11 ou version ultérieure pour créer le cluster de démarrage préexistant et persistant.
Windows
- Une application Docker Desktop installée et en cours d'exécution sur votre machine de démarrage.
- Allouez au moins 6 Go de mémoire dans Docker Desktop pour recevoir le conteneur kind. Reportez-vous à la section Paramètres du poste de travail Docker dans la documentation kind.
- Si votre machine de démarrage exécute le sous-système Windows pour Linux et qu'elle dispose d'un noyau Linux créé après le correctif de sécurité Linux de mai 2021, par exemple, Linux 5.11 et 5.12 avec Fedora, exécutez la commande suivante :
  
  sudo sysctl net/netfilter/nf_conntrack_max=131072
  
  Cela permet à kind, que la CLI tanzu utilise pour créer le cluster de démarrage local, d'écrire dans un fichier de contrôle que les versions récentes de Linux configurent en lecture seule par défaut.
  Si vous effectuez un dépannage comme décrit dans Utiliser un cluster de démarrage existant pour déployer et supprimer des clusters de gestion, vous devez utiliser kind v0.11 ou version ultérieure pour créer le cluster de démarrage préexistant et persistant.

Installer la CLI Tanzu

Pour installer la CLI Tanzu à utiliser avec Tanzu Kubernetes Grid v2.3, installez une version compatible de la CLI Tanzu principale et les plug-ins de la CLI Tanzu pour Tanzu Kubernetes Grid v2.3. Les commandes fournies par ces plug-ins activent les opérations de cluster et de module. Pour connaître la liste des versions de la CLI compatible, reportez-vous à la Matrice d'interopérabilité des produits.

Installer la CLI Tanzu principale

Pour installer la CLI Tanzu principale, suivez les étapes ci-dessous : pour voir les étapes, cliquez sur l'onglet Installer à l'aide d'un gestionnaire de modules ou Installer à partir d'une version binaire.

Une fois l'installation de la CLI Tanzu principale terminée, passez à la section Installer les plug-ins de la CLI Tanzu pour TKG v2.3.

Remarque
Pour conserver une installation existante de la CLI Tanzu, déplacez le fichier binaire de la CLI de /usr/local/bin/tanzu vers un autre emplacement avant de procéder comme suit.

Installer à l'aide d'un gestionnaire de modules

Pour installer la CLI Tanzu à l'aide d'un gestionnaire de modules :

Choisissez une version compatible de la CLI Tanzu. Pour obtenir la liste des versions de la CLI compatibles avec cette version de Tanzu Kubernetes Grid, reportez-vous à la Matrice d'interopérabilité des produits.

Suivez les instructions de votre gestionnaire de modules ci-dessous.

APT (Debian ou Ubuntu) :

Si la version que vous souhaitez installer est la dernière version disponible de la CLI Tanzu, par exemple, v1.0.0, exécutez :

sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install -y tanzu-cli

Si vous souhaitez installer une version antérieure de la CLI Tanzu, par exemple, v0.90.1, exécutez :

sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install tanzu-cli=0.90.1

Chocolatey (Windows) :
- Si la version que vous souhaitez installer est la dernière version disponible de la CLI Tanzu, par exemple, v1.0.0, exécutez :
```
choco install tanzu-cli
```
- Si vous souhaitez installer une version antérieure de la CLI Tanzu, par exemple, v0.90.1, exécutez :
```
choco install tanzu-cli --version 0.90.1
```
Homebrew (MacOS) :
- Si la version que vous souhaitez installer est la dernière version disponible de la CLI Tanzu, par exemple, v1.0.0, exécutez :
```
brew update
brew install vmware-tanzu/tanzu/tanzu-cli
```
- Si vous souhaitez installer une version antérieure de la CLI Tanzu, par exemple, v0.90.1, exécutez :
```
brew update
brew tap-new local/tap
brew extract --version=0.90.1 vmware-tanzu/tanzu/tanzu-cli local/tap
brew install [email protected]
```

YUM ou DNF (RHEL) :

Si la version que vous souhaitez installer est la dernière version disponible de la CLI Tanzu, par exemple, v1.0.0, exécutez :

cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF

sudo yum install -y tanzu-cli # If you are using DNF, run sudo dnf install -y tanzu-cli.

Si vous souhaitez installer une version antérieure de la CLI Tanzu, par exemple, v0.90.1, exécutez :

cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF

sudo yum install tanzu-cli-0.90.1 # If you are using DNF, run sudo dnf install tanzu-cli-0.90.1.

Vérifiez que la version correcte de l'interface de ligne de commande est correctement installée. Par exemple :
```
tanzu version
version: v1.0.0
...
```

Installer à partir d'une version binaire

Vous pouvez télécharger le fichier binaire de la CLI Tanzu à partir de VMware Customer Connect ou de GitHub. Pour connaître la liste de toutes les versions de la CLI compatibles, reportez-vous la Matrice d'interopérabilité des produits.

Pour télécharger une version binaire de la CLI Tanzu à partir de Customer Connect, puis l'installer :

Téléchargez et décompressez le fichier binaire de la CLI Tanzu :
1. Accédez à la page CLI VMware Tanzu (VMware Tanzu CLI) sur VMware Customer Connect et, sous Téléchargements de produits (Product Downloads) pour la CLI Tanzu v1.0.0, recherchez et téléchargez le fichier binaire de la CLI Tanzu de votre système d'exploitation (SE).
2. Décompressez le fichier de la CLI Tanzu pour votre système d'exploitation. Pour décompresser le fichier, utilisez l'outil d'extraction de votre choix. Par exemple, sous Linux ou macOS, vous pouvez utiliser la commande tar.
  - macOS :
```
tar -xvf tanzu-cli-darwin-amd64.tar.gz
```
  - Linux :
```
tar -xvf tanzu-cli-linux-amd64.tar.gz
```
  - Windows :
    
    Utilisez l'outil d'extraction Windows pour décompresser tanzu-cli-windows-amd64.zip.
Rendez l'interface de ligne de commande disponible pour le système :
- macOS :
  
  Installez le fichier binaire sur /usr/local/bin :
```
install tanzu-cli-darwin_amd64 /usr/local/bin/tanzu
```
- Linux :
  
  Installez le fichier binaire sur /usr/local/bin :
```
sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
```
- Windows :
  1. Créez un dossier Program Files\tanzu.
  2. Copiez le fichier tanzu-cli-windows_amd64.exe dans le nouveau dossier Program Files\tanzu.
  3. Renommez tanzu-cli-windows_amd64.exe en tanzu.exe.
  4. Cliquez avec le bouton droit sur le dossier tanzu, sélectionnez Propriétés (Properties) > Sécurité (Security) et assurez-vous que votre compte d'utilisateur dispose de l'autorisation Contrôle total (Full Control).
  5. Utilisez la recherche Windows pour rechercher env.
  6. Sélectionnez Modifier les variables d'environnement système (Edit the system environment variables) puis cliquez sur le bouton Variables d'environnement (Environment Variables).
  7. Sélectionnez la ligne Path sous Variables système (System variables), puis cliquez sur Modifier (Edit).
  8. Cliquez sur Nouveau (New) pour ajouter une nouvelle ligne et entrez le chemin d'accès à la CLI tanzu. La valeur du chemin d'accès ne doit pas inclure l'extension .exe. Par exemple, C:\Program Files\tanzu.
Vérifiez que la version correcte de l'interface de ligne de commande est correctement installée. Par exemple :
```
tanzu version
version: v1.0.0
...
```

Pour télécharger et installer la CLI Tanzu à partir d'une version binaire sur GitHub, suivez les instructions de la section À partir de versions binaires du projet GitHub du document Installation de la CLI Tanzu.

Installer les plug-ins de la CLI Tanzu pour TKG v2.3

Pour installer les plug-ins autonomes de la CLI Tanzu pour Tanzu Kubernetes Grid v2.3 :

Répertoriez les plug-ins autonomes de la CLI Tanzu pour Tanzu Kubernetes Grid v2.3 :

tanzu plugin group get vmware-tkg/default:v2.3.1

La sortie est semblable à ceci :

Plugins in Group:  vmware-tkg/tkg:v2.3.1
NAME                TARGET      VERSION
isolated-cluster    global      v0.30.2
management-cluster  kubernetes  v0.30.2
package             kubernetes  v0.30.2
pinniped-auth       global      v0.30.2
secret              kubernetes  v0.30.2
telemetry           kubernetes  v0.30.2

Pour répertorier toutes les versions disponibles du groupe de plug-ins vmware-tkg/default, exécutez :

tanzu plugin group search -n vmware-tkg/default --show-details

Installez les plug-ins autonomes pour Tanzu Kubernetes Grid v2.3 :
```
tanzu plugin install --group vmware-tkg/default:v2.3.1
```
Vérifiez que les plug-ins ont été installés :
```
tanzu plugin list
```
Chaque nom de plug-in et chaque version de plug-in renvoyés par tanzu plugin group get vmware-tkg/default:v2.3.1 doivent être inclus dans la sortie de tanzu plugin list.

Remarque
Après avoir installé la CLI Tanzu et les plug-ins autonomes pour Tanzu Kubernetes Grid, mais avant de l'avoir utilisée pour vous connecter à un cluster de gestion, tous les groupes de commandes de CLI propres au contexte, tels que tanzu cluster et tanzu kubernetes-release, ne sont pas disponibles et ne sont pas inclus dans la sortie --help de la CLI Tanzu. La CLI Tanzu installe automatiquement les plug-ins contextuels lorsque vous vous connectez à un cluster de gestion. Pour plus d'informations sur les plug-ins de la CLI Tanzu et sur leur installation, reportez-vous à la section Installer les plug-ins de la CLI Tanzu.

Installer la CLI Kubernetes

Téléchargez et décompressez la CLI Kubernetes, kubectl sur votre machine de démarrage, puis rendez-la disponible pour votre système.

Accédez à VMware Customer Connect et connectez-vous avec les informations d'identification de VMware Customer Connect.
Accédez à Téléchargements de produits Tanzu Kubernetes Grid v2.3.1 (Tanzu Kubernetes Grid v2.3.1 Product Downloads).
Faites défiler l'écran jusqu'à la section Kubectl 1.26.8 pour VMware Tanzu Kubernetes Grid 2.3.1 (Kubectl 1.26.8 for VMware Tanzu Kubernetes Grid 2.3.1).

macOS

Recherchez kubectl cli v1.26.8 pour Mac (kubectl cli v1.26.8 for Mac), puis cliquez sur Télécharger maintenant (Download Now).

Linux

Recherchez kubectl cli v1.26.8 pour Linux (kubectl cli v1.26.8 for Linux), puis cliquez sur Télécharger maintenant (Download Now).

Windows

Recherchez kubectl cli v1.26.8 pour Windows (kubectl cli v1.26.8 for Linux), puis cliquez sur Télécharger maintenant (Download Now).
(Facultatif) Vérifiez que vos fichiers téléchargés ne sont pas modifiés par rapport à l'original. VMware fournit une somme de contrôle SHA-1, SHA-256 et MD5 pour chaque téléchargement. Pour obtenir ces sommes de contrôle, cliquez sur En savoir plus (Read More) sous l'entrée que vous souhaitez télécharger. Pour plus d'informations, reportez-vous à la page Utilisation des algorithmes de hachage cryptographiques.
Pour décompresser le fichier binaire kubectl pour votre système d'exploitation, utilisez l'outil d'extraction de votre choix. Par exemple, la commande gunzip.
macOS
```
gunzip kubectl-mac-v1.26.8+vmware.2.gz
```
Linux
```
gunzip kubectl-linux-v1.26.8+vmware.2.gz
```
Windows

Utilisez l'outil d'extraction Windows pour décompresser kubectl-windows-v1.26.8+vmware.2.exe.gz.
Rendez l'interface de ligne de commande disponible pour le système :
macOS
1. Rendez exécutable le fichier téléchargé :
  
  chmod ugo+x kubectl-mac-v1.26.8+vmware.2
2. Installez le fichier binaire sur /usr/local/bin :
  
  sudo install kubectl-mac-v1.26.8+vmware.2 /usr/local/bin/kubectl
3. Exécutez kubectl version pour vérifier que la version correcte de kubectl est installée et exécutable.
  
  kubectl version
Linux
1. Rendez exécutable le fichier téléchargé :
  
  chmod ugo+x kubectl-linux-v1.26.8+vmware.2
2. Installez le fichier binaire sur /usr/local/bin :
  
  sudo install kubectl-linux-v1.26.8+vmware.2 /usr/local/bin/kubectl
3. Exécutez kubectl version pour vérifier que la version correcte de kubectl est installée et exécutable.
  
  kubectl version
Windows
1. Créez un dossier Program Files\kubectl.
2. Recherchez et copiez le fichier kubectl-windows-v1.26.8+vmware.2.exe dans le nouveau dossier Program Files\kubectl.
3. Renommez kubectl-windows-v1.26.8+vmware.2.exe en kubectl.exe.
4. Cliquez avec le bouton droit sur le dossier kubectl, sélectionnez Propriétés (Properties) > Sécurité (Security) et assurez-vous que votre compte d'utilisateur dispose de l'autorisation Contrôle total (Full Control).
5. Utilisez la recherche Windows pour rechercher env.
6. Sélectionnez Modifier les variables d'environnement système (Edit the system environment variables) puis cliquez sur le bouton Variables d'environnement (Environment Variables).
7. Sélectionnez la ligne Path sous Variables système (System variables) et cliquez sur Modifier (Edit).
8. Cliquez sur Nouveau (New) pour ajouter une nouvelle ligne et entrez le chemin d'accès à la CLI kubectl.
9. Exécutez kubectl version pour vérifier que la version correcte de l'interface de ligne de commande est correctement installée.
  
  kubectl version

Tâches suivantes

Pour déployer des clusters de gestion autonomes sur votre fournisseur de cloud, suivez les instructions de la section Déploiement de clusters de gestion autonomes.