Cette rubrique explique comment installer et initialiser la CLI 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.
Si vous prévoyez d'utiliser Tanzu Kubernetes Grid sur vSphere sans superviseur, ou sur AWS ou Azure, utilisez la CLI Tanzu pour créer un cluster de gestion autonome sur chaque fournisseur de cloud que vous utilisez. 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.
RemarqueLes 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, ou sur AWS ou 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.1 avec la CLI Tanzu, Installer la CLI Tanzu et d'autres outils à utiliser avec un superviseur vSphere with Tanzu.
Pour plus d'informations sur la CLI Tanzu, y compris une référence de commande, reportez-vous à la documentation de CLI VMware Tanzu.
La machine de démarrage sur laquelle vous installez et exécutez la CLI Tanzu 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, ou de déployer des clusters de gestion autonomes, ou les deux.
Pour exécuter la CLI Tanzu avec Tanzu Kubernetes Grid v2.1, vous avez besoin d'une machine de démarrage sur laquelle installer et exécuter la CLI Tanzu qui dispose des éléments suivants :
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 :
kind
. Reportez-vous à la section Paramètres du poste de travail Docker dans la documentation kind
.apt
plutôt que snap
pour installer Docker à partir d'une CLI. 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.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 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 modprob 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.
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.
Téléchargez les fichiers de la version compatible de la CLI Tanzu sur la page de téléchargements de Tanzu Kubernetes Grid.
Accédez à VMware Customer Connect et connectez-vous avec les informations d'identification de VMware Customer Connect.
Visitez la page de téléchargements de Tanzu Kubernetes Grid.
Dans la ligne VMware Tanzu Kubernetes Grid, cliquez sur Accéder aux téléchargements (Go to Downloads).
Dans le menu déroulant Sélectionner une version (Select Version), sélectionnez 2.1.1.
Sous Téléchargements de produits (Product Downloads), faites défiler l'écran jusqu'à la section intitulée CLI VMware Tanzu 2.1.1 (VMware Tanzu CLI 2.1.1).
(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.
Sur votre système, créez un répertoire nommé tanzu
. Si vous avez précédemment décompressé les artefacts des versions précédentes dans ce dossier, supprimez le contenu existant du dossier.
Dans le dossier tanzu
, décompressez le fichier de bundle de la CLI Tanzu pour votre système d'exploitation. Pour décompresser le fichier de bundle, utilisez l'outil d'extraction de votre choix. Par exemple, sous Linux ou macOS, vous pouvez utiliser la commande tar
.
tar -xvf tanzu-cli-bundle-darwin-amd64.tar.gz
tar -xvf tanzu-cli-bundle-linux-amd64.tar.gz
tanzu-cli-bundle-windows-amd64.zip
.
Après avoir décompressé le fichier de bundle, dans votre dossier tanzu
, vous verrez un dossier cli
avec plusieurs sous-dossiers et fichiers.
Une fois que vous avez téléchargé et décompressé la CLI Tanzu sur votre machine de démarrage, vous devez la rendre disponible pour le système.
Accédez au sous-dossier cli
sous le dossier tanzu
que vous avez décompressé dans la section précédente.
Rendez l'interface de ligne de commande disponible pour le système :
/usr/local/bin
:
sudo install core/v0.28.1/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
/usr/local/bin
:
sudo install core/v0.28.1/tanzu-core-linux_amd64 /usr/local/bin/tanzu
Program Files\tanzu
.cli
décompressé, recherchez et copiez le fichier core\v0.28.1\tanzu-core-windows_amd64.exe
dans le nouveau dossier Program Files\tanzu
.tanzu-core-windows_amd64.exe
en tanzu.exe
.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).env
.Path
sous Variables système (System variables), puis cliquez sur Modifier (Edit).tanzu
.Sur la ligne de commande d'un nouveau terminal, initialisez la CLI Tanzu :
tanzu init
Vérifiez que la version correcte de l'interface de ligne de commande est correctement installée. La version de la CLI est la même que la version actuelle de Tanzu Framework, qui inclut la CLI Tanzu. Tanzu Kubernetes Grid 2.1.1 utilise la CLI Tanzu 0.28.1 qui se trouve dans Tanzu Framework v0.28.1 :
tanzu version
Si vous exécutez sur macOS, vous pouvez rencontrer l’erreur suivante :
"tanzu" cannot be opened because the developer cannot be verified.
Si cela se produit, vous devez créer une exception de sécurité pour le fichier exécutable tanzu
. Localisez l'application tanzu
dans l'outil de recherche, appuyez sur la touche Ctrl et cliquez sur l'application, puis sélectionnez Ouvrir (Open).
Si des plug-ins de CLI Tanzu existants sont installés sur votre machine à partir d'une installation précédente de la CLI, mettez-les à jour vers la version actuelle de la CLI :
Désinstallez les plug-ins existants :
tanzu plugin clean
Installez tous les plug-ins de cette version :
tanzu plugin sync
Vérifiez l'état et la version d'installation du plug-in :
tanzu plugin list
RemarqueLorsque vous installez la CLI Tanzu, sans encore l'utiliser pour vous connecter à un cluster de gestion, tous les groupes de commandes de CLI propres au contexte, tels que
tanzu cluster
ettanzu kubernetes-release
, ne sont pas disponibles et ne sont pas inclus dans la sortie--help
de la CLI Tanzu.
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.
Visitez la page de téléchargements de Tanzu Kubernetes Grid.
Dans la ligne VMware Tanzu Kubernetes Grid, cliquez sur Accéder aux téléchargements (Go to Downloads).
Dans le menu déroulant Sélectionner une version (Select Version), sélectionnez 2.1.1.
Sous Téléchargements de produits (Product Downloads), faites défiler la page jusqu'à la section Kubectl 1.24.10 pour VMware Tanzu Kubernetes Grid 2.1.1 (Kubectl 1.24.10 for VMware Tanzu Kubernetes Grid 2.1.1).
(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.
Accédez au répertoire tanzu
que vous avez créé dans la section Télécharger et décompresser la CLI Tanzu ci-dessus, puis décompressez le fichier binaire kubectl
pour votre système d'exploitation. Pour décompresser le fichier de bundle, utilisez l'outil d'extraction de votre choix. Par exemple, la commande gunzip
.
gunzip kubectl-mac-v1.24.10+vmware.1.gz
gunzip kubectl-linux-v1.24.10+vmware.1.gz
kubectl-windows-v1.24.10+vmware.1.exe.gz
.
Rendez l'interface de ligne de commande disponible pour le système :
Rendez exécutable le fichier téléchargé :
chmod ugo+x kubectl-mac-v1.24.10+vmware.1
Installez le fichier binaire sur /usr/local/bin
:
sudo install kubectl-mac-v1.24.10+vmware.1 /usr/local/bin/kubectl
Exécutez kubectl version
pour vérifier que la version correcte de kubectl
est installée et exécutable.
kubectl version
Rendez exécutable le fichier téléchargé :
chmod ugo+x kubectl-linux-v1.24.10+vmware.1
Installez le fichier binaire sur /usr/local/bin
:
sudo install kubectl-linux-v1.24.10+vmware.1 /usr/local/bin/kubectl
Exécutez kubectl version
pour vérifier que la version correcte de kubectl
est installée et exécutable.
kubectl version
Program Files\kubectl
.kubectl-windows-v1.24.10+vmware.1.exe
dans le nouveau dossier Program Files\kubectl
.kubectl-windows-v1.24.10+vmware.1.exe
en kubectl.exe
.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).env
.Path
sous Variables système (System variables) et cliquez sur Modifier (Edit).kubectl
.Exécutez kubectl version
pour vérifier que la version correcte de l'interface de ligne de commande est correctement installée.
Exécutez tanzu --help
pour afficher la liste des commandes fournies par la CLI Tanzu.
Vous pouvez afficher le texte d'aide de n'importe quel groupe de commandes avec l'option --help
pour afficher des informations sur cette commande ou ce groupe de commandes spécifique. Par exemple, tanzu login --help
, tanzu management-cluster --help
ou tanzu management-cluster create --help
.
Pour plus d'informations sur la CLI Tanzu, reportez-vous à la page la CLI Tanzu Command Reference.
Le projet open source Carvel fournit à Kubernetes un ensemble d'outils à un seul objectif fiables et composables qui facilitent la création, la configuration et le déploiement d'applications sur Kubernetes.
Tanzu Kubernetes Grid fournit des fichiers binaires pour ytt
, kapp
, kbld
et imgpkg
, qui sont fournis avec la CLI Tanzu. Le bundle inclut également vendir
, un outil de structure d'annuaire Kubernetes, qui n'est actuellement pas requis par les utilisateurs finaux, mais qui est fourni à des fins pratiques.
Accédez à l'emplacement sur votre machine d'environnement de démarrage où vous avez décompressé le fichier tar du bundle de CLI Tanzu pour votre système d'exploitation.
Par exemple, le dossier tanzu
que vous avez créé au cours de la procédure précédente.
Ouvrez le dossier cli
.
cd cli
ytt
ytt
est un outil de ligne de commande pour la création de modèles et l'application de correctifs aux fichiers YAML. Vous pouvez également utiliser ytt
pour collecter des fragments et des piles de YAML en blocs modulaires pour faciliter la réutilisation. Tanzu Kubernetes Grid utilise ytt
pour prendre en charge la personnalisation basée sur la superposition pour les clusters et les plans de cluster. Vous devrez peut-être ytt
pour utiliser des superpositions de personnalisation.
Décompressez le fichier binaire ytt
et rendez-le exécutable.
gunzip ytt-darwin-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-darwin-amd64-v0.43.1+vmware.1
Déplacez le fichier binaire vers /usr/local/bin
et renommez-le en ytt
:
sudo mv ./ytt-darwin-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
Exécutez ytt --version
pour vérifier que la version correcte de ytt
est installée et exécutable.
ytt --version
Décompressez le fichier binaire ytt
et rendez-le exécutable.
gunzip ytt-linux-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-linux-amd64-v0.43.1+vmware.1
Déplacez le fichier binaire vers /usr/local/bin
et renommez-le en ytt
:
sudo mv ./ytt-linux-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
Exécutez ytt --version
pour vérifier que la version correcte de ytt
est installée et exécutable.
ytt --version
Décompressez le fichier binaire ytt
.
gunzip ytt-windows-amd64-v0.43.1+vmware.1.gz
Renommez ytt-windows-amd64-v0.43.1+vmware.1
en ytt.exe
Program Files\ytt
et copiez le fichier ytt.exe
dans celui-ci.ytt
, 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).env
.Path
sous Variables système (System variables), puis cliquez sur Modifier (Edit).ytt
.ytt version
pour vérifier que la version correcte de ytt
est correctement installée.kapp
kapp
est la CLI de déploiement d'applications pour Kubernetes. Elle vous permet d'installer, de mettre à niveau et de supprimer plusieurs ressources Kubernetes en tant qu'application unique.
Décompressez le fichier binaire kapp
et rendez-le exécutable.
gunzip kapp-darwin-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-darwin-amd64-v0.53.2+vmware.1
Déplacez le fichier binaire vers /usr/local/bin
et renommez-le en kapp
:
sudo mv ./kapp-darwin-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
Exécutez kapp --version
pour vérifier que la version correcte de kapp
est installée et exécutable.
kapp --version
Décompressez le fichier binaire kapp
et rendez-le exécutable.
gunzip kapp-linux-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-linux-amd64-v0.53.2+vmware.1
Déplacez le fichier binaire vers /usr/local/bin
et renommez-le en kapp
:
sudo mv ./kapp-linux-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
Exécutez kapp --version
pour vérifier que la version correcte de kapp
est installée et exécutable.
kapp --version
Décompressez le fichier binaire kapp
.
gunzip kapp-windows-amd64-v0.53.2+vmware.1.gz
Renommez kapp-windows-amd64-v0.53.2+vmware.1
en kapp.exe
Program Files\kapp
et copiez le fichier kapp.exe
dans celui-ci.kapp
, 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).env
.Path
sous Variables système (System variables), puis cliquez sur Modifier (Edit).kapp
.kapp version
pour vérifier que la version correcte de kapp
est correctement installée.kbld
kbld
est un outil de création et de résolution d'images.
Décompressez le fichier binaire kbld
et rendez-le exécutable.
gunzip kbld-darwin-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-darwin-amd64-v0.35.1+vmware.1
Déplacez le fichier binaire vers /usr/local/bin
et renommez-le en kbld
:
sudo mv ./kbld-darwin-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
Exécutez kbld --version
pour vérifier que la version correcte de kbld
est installée et exécutable.
Décompressez le fichier binaire kbld
et rendez-le exécutable.
gunzip kbld-linux-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-linux-amd64-v0.35.1+vmware.1
Déplacez le fichier binaire vers /usr/local/bin
et renommez-le en kbld
:
sudo mv ./kbld-linux-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
Exécutez kbld --version
pour vérifier que la version correcte de kbld
est installée et exécutable.
kbld --version
Décompressez le fichier binaire kbld
.
gunzip kbld-windows-amd64-v0.35.1+vmware.1.gz
Renommez kbld-windows-amd64-v0.35.1+vmware.1
en kbld.exe
Program Files\kbld
et copiez le fichier kbld.exe
dans celui-ci.kbld
, 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).env
.Path
sous Variables système (System variables), puis cliquez sur Modifier (Edit).kbld
.kbld version
pour vérifier que la version correcte de kbld
est correctement installée.imgpkg
imgpkg
est un outil qui permet à Kubernetes de stocker les configurations et les images de conteneur associées en tant qu'images OCI, et de transférer ces images. imgpkg
est requis pour déployer Tanzu Kubernetes Grid dans des environnements à accès restreint à Internet et pour créer vos propres images de machine. Il est également requis lors de la configuration du module Harbor.
Décompressez le fichier binaire imgpkg
et rendez-le exécutable.
gunzip imgpkg-darwin-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-darwin-amd64-v0.31.1+vmware.1
Déplacez le fichier binaire vers /usr/local/bin
et renommez-le en imgpkg
:
sudo mv ./imgpkg-darwin-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
Exécutez imgpkg --version
pour vérifier que la version correcte de imgpkg
est installée et exécutable.
imgpkg --version
Décompressez le fichier binaire imgpkg
et rendez-le exécutable.
gunzip imgpkg-linux-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-linux-amd64-v0.31.1+vmware.1
Déplacez le fichier binaire vers /usr/local/bin
et renommez-le en imgpkg
:
sudo mv ./imgpkg-linux-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
Exécutez imgpkg --version
pour vérifier que la version correcte de imgpkg
est installée et exécutable.
imgpkg --version
Décompressez le fichier binaire imgpkg
.
gunzip imgpkg-windows-amd64-v0.31.1+vmware.1.gz
Renommez imgpkg-windows-amd64-v0.31.1+vmware.1
en imgpkg.exe
Program Files\imgpkg
et copiez le fichier imgpkg.exe
dans celui-ci.imgpkg
, 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).env
.Path
sous Variables système (System variables), puis cliquez sur Modifier (Edit).imgpkg
.imgpkg version
pour vérifier que la version correcte de imgpkg
est correctement installée.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.