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.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, 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.
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.0.
Sous Téléchargements de produits (Product Downloads) faites défiler le menu jusqu'à la section étiquetée CLI VMware Tanzu 2.1.0 (VMware CLI Tanzu 2.1.0 CLI).
(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.0/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
/usr/local/bin :
sudo install core/v0.28.0/tanzu-core-linux_amd64 /usr/local/bin/tanzu
Program Files\tanzu.cli décompressé, recherchez et copiez le fichier core\v0.28.0\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 utilise la CLI Tanzu v0.28.0 qui se trouve dans Tanzu Framework v0.28.0 :
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).
Une fois que vous avez installé le fichier exécutable principal tanzu, vous devez installer les plug-ins de CLI qui facilitent les opérations de cluster de charge de travail et de module.
(Facultatif) Supprimez les plug-ins existants de toutes les installations précédentes de l'interface de ligne de commande.
tanzu plugin clean
Accédez au dossier tanzu qui contient le dossier cli.
Exécutez la commande suivante dans le répertoire tanzu pour installer tous les plug-ins de cette version.
tanzu plugin sync
Vérifiez l’état d’installation du plug-in.
tanzu plugin list
Si l'opération réussit, vous devez voir une liste de tous les plug-ins installés. Par exemple :
Standalone Plugins
NAME DESCRIPTION TARGET DISCOVERY VERSION STATUS
isolated-cluster isolated-cluster operations default v0.28.0 installed
login Login to the platform default v0.28.0 installed
pinniped-auth Pinniped authentication operations (usually not directly invoked) default v0.28.0 installed
management-cluster Kubernetes management-cluster operations kubernetes default v0.28.0 installed
package Tanzu package management kubernetes default v0.28.0 installed
secret Tanzu secret management kubernetes default v0.28.0 installed
telemetry Configure cluster-wide telemetry settings kubernetes default v0.28.0 installed
RemarqueAprès avoir installé la CLI Tanzu, mais avant de l'avoir utilisée pour vous connecter à un cluster de gestion, tous les groupes de commandes de CLI spécifiques au contexte (
tanzu cluster,tanzu kubernetes-release) ne sont pas disponibles et ne sont pas inclus dans la sortie--helpde 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.0.
Sous Téléchargements de produits (Product Downloads), faites défiler le menu jusqu'à la section Kubectl 1.24.9 pour VMware Tanzu Kubernetes Grid 2.1.0 (Kubectl 1.24.9 for VMware Tanzu Kubernetes Grid 2.1.0).
(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 l'interface de ligne de commande 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.9+vmware.1.gz
gunzip kubectl-linux-v1.24.9+vmware.1.gz
kubectl-windows-v1.24.9+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.9+vmware.1
Installez le fichier binaire sur /usr/local/bin :
sudo install kubectl-mac-v1.24.9+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.9+vmware.1
Installez le fichier binaire sur /usr/local/bin :
sudo install kubectl-linux-v1.24.9+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.9+vmware.1.exe dans le nouveau dossier Program Files\kubectl.kubectl-windows-v1.24.9+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 Tanzu CLI 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
yttytt 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.kappkapp 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.kbldkbld 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.imgpkgimgpkg 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.
