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.
Si vous utilisez le superviseur vSphere with Tanzu sur vSphere 8 comme cluster de gestion, après avoir installé la CLI Tanzu, vous pouvez le connecter au superviseur.
RemarqueLes instructions de cette rubrique sont spécifiques à l'installation de la CLI Tanzu à utiliser avec un superviseur vSphere with Tanzu sur vSphere 8. Si vous installez la CLI Tanzu afin de déployer des clusters de gestion autonomes sur vSphere sans superviseur, sur AWS ou Azure, reportez-vous à la rubrique correspondante dans le document Déploiement et gestion de clusters de gestion autonomes Tanzu Kubernetes Grid 2.3, section Installer la CLI Tanzu et la CLI Kubernetes à utiliser avec des clusters de gestion autonomes.
La CLI Tanzu communique avec le superviseur pour créer et gérer des clusters de charge de travail dans vSphere with Tanzu.
ImportantLe superviseur vSphere with Tanzu dans vSphere 8.0.1c et versions ultérieures exécute TKG v2.2. Les versions antérieures de vSphere 8 exécutent TKG v2.0, qui n'a pas été publié indépendamment du superviseur. En raison de la version antérieure de TKG intégrée au superviseur, certaines fonctionnalités qui sont disponibles si vous utilisez un cluster de gestion TKG 2.3 autonome ne le sont pas si vous utilisez un superviseur vSphere with Tanzu pour créer des clusters de charge de travail. Les versions ultérieures de TKG seront intégrées dans le superviseur dans les futures versions de mise à jour vSphere. Par conséquent, la version de TKG intégrée à la dernière version de vSphere with Tanzu à un moment donné peut ne pas être aussi récente que la dernière version autonome de TKG. Toutefois, les versions de la CLI Tanzu compatibles avec toutes les versions de TKG v2.x sont entièrement compatibles avec le superviseur dans toutes les versions de vSphere 8. Par exemple, la CLI Tanzu v1.0.0 est entièrement rétrocompatible avec les plug-ins TKG 2.2 que le superviseur fournit.
Attention :Les versions de la CLI Tanzu compatibles avec TKG 2.x et disposant du superviseur vSphere with Tanzu dans vSphere 8 ne sont pas compatibles avec le cluster superviseur dans vSphere 7. Pour utiliser la CLI Tanzu avec un cluster superviseur vSphere with Tanzu sur vSphere 7, utilisez la version de la CLI Tanzu de TKG v1.6. Pour utiliser les versions de la CLI Tanzu compatibles avec TKG 2.x et un superviseur, effectuez une mise à niveau vers vSphere 8. Vous pouvez déployer un cluster de gestion TKG 2.x autonome sur vSphere 7 si aucun cluster superviseur vSphere with Tanzu n'est présent. Pour plus d'informations sur la compatibilité entre la CLI Tanzu et les produits VMware, reportez-vous à la documentation de la CLI Tanzu.
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 :
Pour utiliser un cluster superviseur comme cluster de gestion, vous avez également besoin des éléments suivants :
Un compte vSphere 8 avec :
Une des versions suivantes :
kubectl vsphere
installé sur votre machine de démarrage, comme décrit dans la section Télécharger et installer les outils de la CLI Kubernetes pour vSphere.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.
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.
RemarquePour 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.
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
...
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 :
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 :
Program Files\tanzu
.tanzu-cli-windows_amd64.exe
dans le nouveau dossier Program Files\tanzu
.tanzu-cli-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
. 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.
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
.
RemarqueAprè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
ettanzu 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.
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.
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).
(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
.
gunzip kubectl-mac-v1.26.8+vmware.2.gz
gunzip kubectl-linux-v1.26.8+vmware.2.gz
kubectl-windows-v1.26.8+vmware.2.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.26.8+vmware.2
Installez le fichier binaire sur /usr/local/bin
:
sudo install kubectl-mac-v1.26.8+vmware.2 /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.26.8+vmware.2
Installez le fichier binaire sur /usr/local/bin
:
sudo install kubectl-linux-v1.26.8+vmware.2 /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.26.8+vmware.2.exe
dans le nouveau dossier Program Files\kubectl
.kubectl-windows-v1.26.8+vmware.2.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.
kubectl version
Avant de pouvoir utiliser la CLI Tanzu et kubectl
pour déployer des clusters de charge de travail et des modules de service sur Tanzu Kubernetes Grid, connectez la CLI Tanzu au superviseur, comme décrit ci-dessous.
Pour connecter la CLI Tanzu au superviseur, procédez comme suit :
Obtenez l’adresse IP du superviseur auprès de vCenter :
https://192.168.123.3
.Aucun fournisseur d'identité : Si vous n’utilisez pas de fournisseur d’identité externe :
(Facultatif) Configurez le plug-in kubectl vsphere
avec un certificat approuvé comme décrit dans la section Configurer la connexion sécurisée pour les clusters vSphere with Tanzu.
Exécutez kubectl vsphere login
pour vous connecter à vSphere. Pour plus d'informations sur cette étape, reportez-vous à la section Connexion à un superviseur en tant qu'utilisateur vCenter Single Sign-On avec Kubectl.
kubectl vsphere login --vsphere-username VSPHERE-USERNAME --server=SUPERVISOR-IP
Où VSPHERE-USERNAME
est le nom d'utilisateur de votre compte vCenter Single Sign-On (SSO), par exemple [email protected]
et SUPERVISOR-IP
correspond à l'adresse IP du superviseur obtenue ci-dessus.
Si vous n'avez pas configuré le plug-in kubectl vsphere
avec un certificat approuvé, vous pouvez vous connecter de manière non sécurisée en ajoutant --insecure-skip-tls-verify=true
à la commande ci-dessus.
Attention :Utilisez uniquement une connexion non sécurisée dans un environnement de développement.
Entrez le mot de passe que vous utilisez pour vous connecter à vCenter.
Lorsque vous vous connectez avec succès, la commande kubectl vsphere login
:
kubeconfig
local pour ajouter un jeton qui s'authentifie avec l'API KubernetesDéfinissez le contexte de kubectl
sur le superviseur.
kubectl config use-context SUPERVISOR-IP
Où SUPERVISOR-IP
est le contexte du superviseur ; reportez-vous à la section Obtenir et utiliser le contexte de superviseur dans Services et charges de travail vSphere with Tanzu.
Collectez des informations pour exécuter la commande tanzu context create
qui se connecte au superviseur :
kubeconfig
, qui est défini par défaut sur ~/.kube/config
et est défini par la variable d'environnement KUBECONFIG
.Exécutez la commande tanzu context create
en transmettant les valeurs ci-dessus, par exemple :
Aucun fournisseur d'identité :
tanzu context create my-supervisor --kubeconfig ~/.kube/config --kubecontext 192.168.123.3
Cela permet d'enregistrer le contexte du superviseur dans la CLI Tanzu et de télécharger les plug-ins propres au superviseur.
[ok] successfully logged in to management cluster using the kubeconfig my-supervisor
[i] Checking for required plugins...
[i] Installing plugin 'cluster:v0.29' with target 'kubernetes'
[i] Plugin binary for 'cluster:v0.29' found in cache
[i] Installing plugin 'feature:v0.29' with target 'kubernetes'
[i] Plugin binary for 'feature:v0.29' found in cache
[i] Installing plugin 'kubernetes-release:v0.29' with target 'kubernetes'
[i] Plugin binary for 'kubernetes-release:v0.29' found in cache
[i] Installing plugin 'namespaces:v1.0.0' with target 'kubernetes'
[i] Plugin binary for 'namespaces:v1.0.0' found in cache
[i] Successfully installed all required plugins
Avec un fournisseur d'identité :
tanzu context create --endpoint https://10.73.27.32 --name oidc-user
tanzu context use https://10.73.27.32 oidc-user
Detected a vSphere Supervisor being used
Log in by visiting this link:
...
https://10.27.62.33/wcp/pinniped/oauth2/authorize?..
...
Optionally, paste your authorization code: G2TcS145Q4e6A1YKf743n3BJlfQAQ_UdjXy38TtEEIo.ju4QV3PTsUvOigVUtQllZ7AJFU0YnjuLHTRVoNxvdZc
...
??? successfully logged in to management cluster using the kubeconfig oidc-user
Checking for required plugins...
All required plugins are already installed and up-to-date
Dans l'exemple ci-dessus, https://10.73.27.32
est l'adresse IP du plan de contrôle du superviseur. Pour plus d'informations sur cette étape, reportez-vous à la section Se connecter au superviseur à l'aide de la CLI Tanzu et d'un fournisseur d'identité externe.
Vérifiez que le superviseur a été ajouté en exécutant tanzu context list
, par exemple :
tanzu context list
NAME ISACTIVE ENDPOINT KUBECONFIGPATH KUBECONTEXT
my-supervisor true https://192.168.123.3:443 /home/vmware/.kube/config 192.168.123.3
La commande tanzu context use
doit désormais répertorier le superviseur en fonction du nom que vous avez fourni :
tanzu context use
? Select a server [Use arrows to move, type to filter]
> my-supervisor ()
+ new server
Exécutez tanzu plugin list
pour afficher la liste des plug-ins propres au superviseur, ainsi que les plug-ins autonomes de la CLI.
tanzu plugin list
Standalone Plugins
NAME DESCRIPTION TARGET VERSION STATUS
isolated-cluster Prepopulating images/bundle for internet-restricted environments global v0.30.2 installed
pinniped-auth Pinniped authentication operations (usually not directly invoked) global v0.30.2 installed
management-cluster Kubernetes management cluster operations kubernetes v0.30.2 installed
package Tanzu package management kubernetes v0.30.2 installed
secret Tanzu secret management kubernetes v0.30.2 installed
telemetry Configure cluster-wide settings for vmware tanzu telemetry kubernetes v0.30.2 installed
Plugins from Context: my-supervisor
NAME DESCRIPTION TARGET VERSION STATUS
cluster Kubernetes cluster operations kubernetes v0.29.0 installed
feature Operate on features and featuregates kubernetes v0.29.0 installed
kubernetes-release Kubernetes release operations kubernetes v0.29.0 installed
namespaces Discover vSphere Supervisor namespaces you have access to kubernetes v1.0.0 installed
RemarqueAvec vSphere 8.0.1c, la version des plug-ins pour le contexte du superviseur est v0.29.0.