Installer la CLI Tanzu et d'autres outils à utiliser avec un superviseur vSphere with Tanzu

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 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.

Remarque

Les 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, ou sur AWS ou Azure, reportez-vous à la rubrique correspondante dans Déploiement et gestion des clusters de gestion autonomes Tanzu Kubernetes Grid 2.1, Installer la CLI Tanzu et d'autres outils à 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.

Important

Vous ne pouvez pas utiliser la version de la CLI Tanzu fournie avec TKG 2.1 pour vous connecter à un cluster superviseur sur vSphere 7. Si vous utilisez la CLI Tanzu pour vous connecter à un cluster superviseur sur vSphere 7 et que vous ne pouvez pas effectuer la mise à niveau vers vSphere 8, ne procédez pas à la mise à niveau vers Tanzu Kubernetes Grid version 2.1 ou ne la déployez pas. Vous pouvez déployer un cluster de gestion sur vSphere 7 si aucun cluster superviseur vSphere with Tanzu n'est présent.

Pour plus d'informations sur la CLI Tanzu, y compris une référence de commande, reportez-vous à la documentation de CLI VMware Tanzu.

Conditions requises

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 :

  • Un système d'exploitation Linux, Windows ou macOS disposant d'une configuration système minimale de 6 Go de RAM et un 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.

Pour utiliser un cluster superviseur comme cluster de gestion, vous avez également besoin des éléments suivants :

Téléchargez et décompressez la CLI Tanzu

Téléchargez les fichiers de la version compatible de la CLI Tanzu sur la page de téléchargements de Tanzu Kubernetes Grid.

  1. Accédez à VMware Customer Connect et connectez-vous avec les informations d'identification de VMware Customer Connect.

  2. Visitez la page de téléchargements de Tanzu Kubernetes Grid.

  3. Dans la ligne VMware Tanzu Kubernetes Grid, cliquez sur Accéder aux téléchargements (Go to Downloads).

  4. Dans le menu déroulant Sélectionner une version (Select Version), sélectionnez 2.1.0.

  5. 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).

    macOS
    Recherchez CLI VMware Tanzu pour Mac (VMware CLI Tanzu for Mac) et cliquez sur Télécharger maintenant (Download Now).
    Linux
    Recherchez CLI VMware Tanzu pour Linux (VMware CLI Tanzu for Linux) et cliquez sur Télécharger maintenant (Download Now).
    Windows
    Recherchez CLI VMware Tanzu pour Windows (VMware CLI Tanzu for Windows) et cliquez sur Télécharger maintenant (Download Now).
  6. (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.

  7. 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.

  8. 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.

    macOS
    tar -xvf tanzu-cli-bundle-darwin-amd64.tar.gz
    
    Linux
    tar -xvf tanzu-cli-bundle-linux-amd64.tar.gz
    
    Windows
    Utilisez l'outil d'extraction Windows pour décompresser 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.

Initialiser la CLI Tanzu

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.

  1. Accédez au sous-dossier cli sous le dossier tanzu que vous avez décompressé dans la section précédente.

  2. Rendez l'interface de ligne de commande disponible pour le système :

    macOS
    Installez le fichier binaire sur /usr/local/bin :
    sudo install core/v0.28.0/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
    
    Linux
    Installez le fichier binaire sur /usr/local/bin :
    sudo install core/v0.28.0/tanzu-core-linux_amd64 /usr/local/bin/tanzu
    
    Windows
    1. Créez un dossier Program Files\tanzu.
    2. Dans le dossier cli décompressé, recherchez et copiez le fichier core\v0.28.0\tanzu-core-windows_amd64.exe dans le nouveau dossier Program Files\tanzu.
    3. Renommez tanzu-core-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.
  3. Sur la ligne de commande d'un nouveau terminal, initialisez la CLI Tanzu :

    tanzu init
    
  4. 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).

Installer les plug-ins de CLI Tanzu

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.

  1. (Facultatif) Supprimez les plug-ins existants de toutes les installations précédentes de l'interface de ligne de commande.

    tanzu plugin clean
    
  2. Accédez au dossier tanzu qui contient le dossier cli.

  3. Exécutez la commande suivante dans le répertoire tanzu pour installer tous les plug-ins de cette version.

    tanzu plugin sync
    
  4. 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
    
Remarque

Aprè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 --help 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.

  1. Accédez à VMware Customer Connect et connectez-vous avec les informations d'identification de VMware Customer Connect.

  2. Visitez la page de téléchargements de Tanzu Kubernetes Grid.

  3. Dans la ligne VMware Tanzu Kubernetes Grid, cliquez sur Accéder aux téléchargements (Go to Downloads).

  4. Dans le menu déroulant Sélectionner une version (Select Version), sélectionnez 2.1.0.

  5. 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).

    macOS
    Recherchez kubectl cluster cli v1.24.9 pour Mac (kubectl cluster cli v1.24.9 for Mac) et cliquez sur Télécharger maintenant (Download Now).
    Linux
    Recherchez kubectl cluster cli v1.24.9 pour Linux (kubectl cluster cli v1.24.9 for Linux) et cliquez sur Télécharger maintenant (Download Now).
    Windows
    Recherchez kubectl cluster cli v1.24.9 for Windows (kubectl cluster cli v1.24.9 for Windows) et cliquez sur Télécharger maintenant (Download Now).
  6. (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.

  7. 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.

    macOS
    gunzip kubectl-mac-v1.24.9+vmware.1.gz
    
    Linux
    gunzip kubectl-linux-v1.24.9+vmware.1.gz
    
    Windows
    Utilisez l'outil d'extraction Windows pour décompresser kubectl-windows-v1.24.9+vmware.1.exe.gz.
  8. 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.24.9+vmware.1
      
    2. Installez le fichier binaire sur /usr/local/bin :

      sudo install kubectl-mac-v1.24.9+vmware.1 /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.24.9+vmware.1
      
    2. Installez le fichier binaire sur /usr/local/bin :

      sudo install kubectl-linux-v1.24.9+vmware.1 /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.24.9+vmware.1.exe dans le nouveau dossier Program Files\kubectl.
    3. Renommez kubectl-windows-v1.24.9+vmware.1.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.

Aide de la CLI Tanzu

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.

Installer les outils Carvel

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.

Rechercher les outils Carvel

  1. 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.

  2. Ouvrez le dossier cli.

    cd cli
    

Installer 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.

macOS
  1. 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
    
  2. 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
    
  3. Exécutez ytt --version pour vérifier que la version correcte de ytt est installée et exécutable.

    ytt --version
    
Linux
  1. 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
    
  2. 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
    
  3. Exécutez ytt --version pour vérifier que la version correcte de ytt est installée et exécutable.

    ytt --version
    
Windows
  1. Décompressez le fichier binaire ytt.

    gunzip ytt-windows-amd64-v0.43.1+vmware.1.gz
    
  2. Renommez ytt-windows-amd64-v0.43.1+vmware.1 en ytt.exe

  3. Créez un dossier Program Files\ytt et copiez le fichier ytt.exe dans celui-ci.
  4. Cliquez avec le bouton droit sur le dossier 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).
  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 à l'outil ytt.
  9. Sur la ligne de commande d'un nouveau terminal, exécutez ytt version pour vérifier que la version correcte de ytt est correctement installée.


Installer 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.

macOS
  1. 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
    
  2. 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
    
  3. Exécutez kapp --version pour vérifier que la version correcte de kapp est installée et exécutable.

    kapp --version
    
Linux
  1. 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
    
  2. 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
    
  3. Exécutez kapp --version pour vérifier que la version correcte de kapp est installée et exécutable.

    kapp --version
    
Windows
  1. Décompressez le fichier binaire kapp.

    gunzip kapp-windows-amd64-v0.53.2+vmware.1.gz
    
  2. Renommez kapp-windows-amd64-v0.53.2+vmware.1 en kapp.exe

  3. Créez un dossier Program Files\kapp et copiez le fichier kapp.exe dans celui-ci.
  4. Cliquez avec le bouton droit sur le dossier 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).
  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 à l'outil kapp.
  9. Sur la ligne de commande d'un nouveau terminal, exécutez kapp version pour vérifier que la version correcte de kapp est correctement installée.


Installer kbld

kbld est un outil de création et de résolution d'images.

macOS
  1. 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
    
  2. 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
    
  3. Exécutez kbld --version pour vérifier que la version correcte de kbld est installée et exécutable.

Linux
  1. 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
    
  2. 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
    
  3. Exécutez kbld --version pour vérifier que la version correcte de kbld est installée et exécutable.

    kbld --version
    
Windows
  1. Décompressez le fichier binaire kbld.

    gunzip kbld-windows-amd64-v0.35.1+vmware.1.gz
    
  2. Renommez kbld-windows-amd64-v0.35.1+vmware.1 en kbld.exe

  3. Créez un dossier Program Files\kbld et copiez le fichier kbld.exe dans celui-ci.
  4. Cliquez avec le bouton droit sur le dossier 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).
  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 à l'outil kbld.
  9. Sur la ligne de commande d'un nouveau terminal, exécutez kbld version pour vérifier que la version correcte de kbld est correctement installée.


Installer 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.

macOS
  1. 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
    
  2. 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
    
  3. Exécutez imgpkg --version pour vérifier que la version correcte de imgpkg est installée et exécutable.

    imgpkg --version
    
Linux
  1. 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
    
  2. 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
    
  3. Exécutez imgpkg --version pour vérifier que la version correcte de imgpkg est installée et exécutable.

    imgpkg --version
    
Windows
  1. Décompressez le fichier binaire imgpkg.

    gunzip imgpkg-windows-amd64-v0.31.1+vmware.1.gz
    
  2. Renommez imgpkg-windows-amd64-v0.31.1+vmware.1 en imgpkg.exe

  3. Créez un dossier Program Files\imgpkg et copiez le fichier imgpkg.exe dans celui-ci.
  4. Cliquez avec le bouton droit sur le dossier 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).
  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 à l'outil imgpkg.
  9. Sur la ligne de commande d'un nouveau terminal, exécutez imgpkg version pour vérifier que la version correcte de imgpkg est correctement installée.


Tâches suivantes

Avant de pouvoir utiliser les outils de la CLI Tanzu, kubectl et Carvel pour déployer des clusters de charge de travail et des modules de service pour Tanzu Kubernetes Grid, connectez la CLI Tanzu au superviseur comme décrit ci-dessous.

Connecter la CLI Tanzu au superviseur

Pour enregistrer le superviseur avec la CLI Tanzu, puis vous connecter au superviseur, procédez comme suit. Vous devez enregistrer le superviseur avec la CLI Tanzu une seule fois. Une fois que le superviseur est enregistré, vous pouvez ignorer l'étape de tanzu login.

  1. Obtenez l’adresse IP du superviseur auprès de vCenter :

    1. Dans la vue Hôtes et clusters (Hosts and Clusters), sélectionnez le centre de données qui héberge le superviseur.
    2. Sous Espaces de noms (Namespaces), sélectionnez l'espace de noms contenant les trois instances SupervisorControlPlaneVM ou adjacents à celles-ci.
    3. Dans le volet principal, sous Résumé (Summary) > État (Status) > Lien vers les outils de la CLI (Link to CLI Tools) cliquez sur Copier le lien (Copy link) et enregistrez l'URL, par exemple https://192.168.123.3.
  2. Aucun fournisseur d'identité : Si vous n’utilisez pas de fournisseur d’identité externe :

    1. (Facultatif) Installez et 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.

    2. 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
      

      VSPHERE-USERNAME est le nom d'utilisateur de votre compte vCenter Single Sign-On (SSO), par exemple administrator@vsphere.local 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.

    3. Entrez le mot de passe que vous utilisez pour vous connecter à vCenter.

      Lorsque vous vous connectez avec succès, la commande kubectl vsphere login :

      • Crée ou modifie votre fichier kubeconfig local pour ajouter un jeton qui s'authentifie avec l'API Kubernetes
      • Répertorie tous les contextes Kubernetes auxquels vous avez accès. Cette liste doit inclure l’adresse IP du superviseur.
    4. Définissez le contexte de kubectl sur le superviseur.

      kubectl config use-context SUPERVISOR-IP
      

      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.

  3. Collectez des informations pour exécuter la commande tanzu login qui se connecte au superviseur :

    • Choisissez un nom pour la CLI tanzu à utiliser pour le superviseur.
    • Chemin d'accès au fichier local kubeconfig, qui est défini par défaut sur ~/.kube/config et est défini par la variable d'environnement KUBECONFIG.
  4. Exécutez la commande tanzu login en transmettant les valeurs ci-dessus, par exemple :

    Aucun fournisseur d'identité :

    tanzu login --name my-supervisor --kubeconfig ~/.kube/config --context 192.168.123.3
    

    Une fois connecté, la CLI télécharge les plug-ins spécifiques au superviseur.

    ???  successfully logged in to management cluster using the kubeconfig my-supervisor
    Checking for required plugins...
    Installing plugin 'cluster:v0.25' with target 'kubernetes'
    Installing plugin 'feature:v0.25' with target 'kubernetes'
    Installing plugin 'kubernetes-release:v0.25' with target 'kubernetes'
    Installing plugin 'namespaces:v1.0.0' with target 'kubernetes'
    Successfully installed all required plugins
    

    Avec un fournisseur d'identité :

    tanzu login --endpoint https://10.73.27.32 --name 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.

  5. Vérifiez que le superviseur a été ajouté en exécutant tanzu config server list, par exemple :

    tanzu config server list
    
    NAME           TYPE               ENDPOINT                   PATH                       CONTEXT
    my-supervisor  managementcluster  https://192.168.123.3:443  /home/vmware/.kube/config  192.168.123.3
    

    La commande tanzu login doit désormais répertorier le superviseur en fonction du nom que vous avez fourni :

    tanzu login
    
    ? Select a server  [Use arrows to move, type to filter]
    > my-supervisor  ()
     + new server
    
  6. Exécutez tanzu plugin list pour afficher la liste des plug-ins spécifiques au superviseur ainsi que les plug-ins de CLI principaux.

    tanzu plugin list
    
    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
    
    Plugins from Context:  my-supervisor
      NAME                DESCRIPTION                                                TARGET      VERSION  STATUS
      cluster             Kubernetes cluster operations                              kubernetes  v0.25.0  installed
      feature             Operate on features and featuregates                       kubernetes  v0.25.0  installed
      kubernetes-release  Kubernetes release operations                              kubernetes  v0.25.0  installed
      namespaces          Discover vSphere Supervisor namespaces you have access to  kubernetes  v1.0.0   installed
    
    Remarque

    Dans l'exemple ci-dessus, les plug-ins autonomes, par exemple login et pinniped-auth, qui ont été installés lorsque vous avez installé la CLI Tanzu, sont de version 0.28.0. Les plug-ins du contexte du superviseur, qui ont été installés lorsque vous avez connecté la CLI Tanzu au superviseur, par exemple cluster ou kubernetes-release, sont de version 0.25.0. Cela est dû au fait que le superviseur dans vSphere with Tanzu exécute une version de TKG 2 légèrement antérieure à celle de TKG 2.1. Cependant, les plug-ins v0.25.0 sont entièrement compatibles avec la version v0.28.0 de la CLI Tanzu et les plug-ins autonomes.

  7. (Facultatif) Vous pouvez ensuite créer des clusters de charge de travail.
check-circle-line exclamation-circle-line close-line
Scroll to top icon