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 de clusters de gestion autonomes Tanzu Kubernetes Grid 2.2, 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.

Tanzu Kubernetes Grid v2.0, v2.2 et le superviseur vSphere with Tanzu dans vSphere 8

Important

Le 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. Les clusters de gestion autonomes qui exécutent TKG 2.x sont disponibles à partir de TKG 2.1 et versions ultérieures. 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 la même que la version autonome de TKG que vous utilisez. 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.

Tanzu Kubernetes Grid v2.2 et vSphere with Tanzu dans vSphere 7

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.

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.2, vous avez besoin d'une machine de démarrage sur laquelle installer et exécuter la CLI Tanzu qui dispose des éléments suivants :

  • Un système d'exploitation Linux, Windows ou macOS exécuté sur une machine physique ou virtuelle disposant du matériel suivant :
    • Au moins 8 Go de RAM. VMware recommande 16 Go de RAM.
    • Un disque disposant de 50 Go de stockage disponible.
    • 2 ou 4 CPU à 2 cœurs.
  • Un navigateur ou un accès distant à partir d'une machine avec un navigateur, si vous prévoyez d'utiliser l'interface du programme d'installation de Tanzu Kubernetes Grid pour déployer des clusters de gestion autonomes. Vous pouvez utiliser la CLI Tanzu sans navigateur, mais pour les premiers déploiements, il est fortement recommandé d'utiliser l'interface du programme d'installation.
  • L'heure système est synchronisée avec un serveur NTP (Network Time Protocol).
  • Si votre machine de démarrage exécute Windows, VMware recommande d'installer le sous-système Windows pour Linux (WSL) avec Ubuntu 20.04.4 LTS, ce qui vous permet d'exécuter des commandes Linux sous Windows. Pour plus d'informations sur WSL, reportez-vous à la section Installer WSL de la documentation de Microsoft.

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

  5. Sous Téléchargements de produits (Product Downloads), faites défiler l'écran jusqu'à la section intitulée CLI VMware Tanzu 2.2.0 (VMware Tanzu CLI 2.2.0).

    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.

    cd cli
    
  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.29.0/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
    
    Linux
    Installez le fichier binaire sur /usr/local/bin :
    sudo install core/v0.29.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.29.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.2 utilise la CLI Tanzu v0.29.0 qui se trouve dans Tanzu Framework v0.29.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).

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

    1. Désinstallez les plug-ins existants :

      tanzu plugin clean
      
    2. Installez tous les plug-ins de cette version :

      tanzu plugin sync
      
    3. Vérifiez l'état et la version d'installation du plug-in :

      tanzu plugin list
      
Remarque

Lorsque 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 et 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.2.0.

  5. Sous Téléchargements de produits (Product Downloads), faites défiler l'écran jusqu'à la section Kubectl 1.25.7 pour VMware Tanzu Kubernetes Grid 2.2.0 (Kubectl 1.25.7 for VMware Tanzu Kubernetes Grid 2.2.0).

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

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

      sudo install kubectl-mac-v1.25.7+vmware.2 /usr/local/bin/kubectl
      
    3. Exécutez kubectl version pour vérifier que la version correcte de kubectl est installée et exécutable.

      kubectl version
      
    Linux
    1. Rendez exécutable le fichier téléchargé :

      chmod ugo+x kubectl-linux-v1.25.7+vmware.2
      
    2. Installez le fichier binaire sur /usr/local/bin :

      sudo install kubectl-linux-v1.25.7+vmware.2 /usr/local/bin/kubectl
      
    3. Exécutez kubectl version pour vérifier que la version correcte de kubectl est installée et exécutable.

      kubectl version
      
    Windows
    1. Créez un dossier Program Files\kubectl.
    2. Recherchez et copiez le fichier kubectl-windows-v1.25.7+vmware.2.exe dans le nouveau dossier Program Files\kubectl.
    3. Renommez kubectl-windows-v1.25.7+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 la CLI Tanzu 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 [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.

    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.29.0   installed
      login               Login to the platform                                                          default    v0.29.0   installed
      pinniped-auth       Pinniped authentication operations (usually not directly invoked)              default    v0.29.0   installed
      management-cluster  Kubernetes management-cluster operations                           kubernetes  default    v0.29.0   installed
      package             Tanzu package management                                           kubernetes  default    v0.29.0   installed
      secret              Tanzu secret management                                            kubernetes  default    v0.29.0   installed
      telemetry           Configure cluster-wide telemetry settings                          kubernetes  default    v0.29.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 v0.29.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 v0.25.0. Cela est dû au fait que le superviseur dans vSphere with Tanzu exécute TKG 2.0 plutôt que TKG 2.2. Cependant, les plug-ins v0.25.0 sont entièrement compatibles avec la version v0.29.0 de la CLI Tanzu et les plug-ins autonomes.

  7. (Facultatif) Consultez la section Création de clusters de charge de travail pour continuer.
check-circle-line exclamation-circle-line close-line
Scroll to top icon