Cette rubrique décrit comment installer et gérer des modules et des référentiels de modules à l'aide de la CLI Tanzu.
Remarquele plug-in d'interface de ligne de commande de
tanzu package
est destiné uniquement aux modules gérés par l'interface de ligne de commande. N'utilisez pas les commandes fournies dans cette rubrique pour installer et gérer des modules gérés automatiquement. Leur cycle de vie est géré automatiquement par Tanzu Kubernetes Grid. Pour plus d'informations sur les modules gérés automatiquement, reportez-vous à la section Paramètres gérés automatiquement.
Avant d'installer des modules gérés via CLI à partir du référentiel de modules standard
:
tanzu-standard
. Si vous ciblez un cluster basé sur un plan (hérité), ignorez cette étape. Pour les clusters basés sur un plan, le référentiel de modules tanzu-standard
est automatiquement activé dans chaque cluster, dans l'espace de noms tanzu-package-repo-global
.Pour obtenir des instructions sur l'installation et la gestion des modules à l'aide de la CLI Tanzu, reportez-vous aux sections ci-dessous.
Référentiels de modules : reportez-vous à cette section si vous souhaitez effectuer les actions suivantes :
Modules : reportez-vous à cette section si vous souhaitez effectuer les actions suivantes :
Pour plus d'informations sur les commandes de tanzu package
, reportez-vous à la section Module Tanzu.
Vous installez les référentiels de modules et les modules dans l'espace de noms de votre choix. Si vous ne définissez pas l'option --namespace
, la CLI Tanzu cible l'espace de noms default
.
Les composants des services en module s'exécutent dans un espace de noms système distinct de l'emplacement dans lequel les modules sont eux-mêmes déployés. Par exemple, les composants Contour et Envoy s'exécutent dans l'espace de noms tanzu-system-ingress
et les composants Harbor s'exécutent dans tanzu-system-registry
.
N'installez pas de modules dans un espace de noms tanzu-system-
.
Les sections ci-dessous décrivent comment répertorier, ajouter, mettre à jour et supprimer des référentiels de modules.
La commande tanzu package repository list
répertorie tous les référentiels de modules disponibles dans le cluster cible. Cette liste inclut les référentiels de modules qui ont été ajoutés au cluster cible en exécutant la commande tanzu package repository add
. Pour ajouter un référentiel de modules à votre cluster, reportez-vous à la section Ajouter un référentiel de modules ci-dessous.
Pour répertorier les référentiels de modules dans tous les espaces de noms du cluster cible, exécutez :
tanzu package repository list -A
Pour répertorier les référentiels de modules dans un espace de noms spécifique, exécutez :
tanzu package repository list -n NAMESPACE
Où NAMESPACE
est l'espace de noms cible. L'option --namespace
, ou -n
, est requise si vous souhaitez répertorier les référentiels de modules dans un espace de noms autre que default
.
Pour répertorier les référentiels de modules dans l'espace de noms default
, vous pouvez également exécuter :
tanzu package repository list
La commande tanzu package repository get
récupère les détails d'un référentiel de modules.
Pour récupérer les détails d'un référentiel de modules, exécutez :
tanzu package repository get REPOSITORY-NAME -n REPOSITORY-NAMESPACE
Où :
REPOSITORY-NAME
est le nom du référentiel de modules dans le cluster cible.REPOSITORY-NAMESPACE
est l'espace de noms du référentiel de modules dans le cluster cible.La commande tanzu package repository add
ajoute un référentiel de modules.
Pour ajouter un référentiel de modules au cluster cible, exécutez :
tanzu package repository add REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE
Où :
REPOSITORY-NAME
est un nom que vous choisissez pour le référentiel de modules.REPOSITORY-URL
est l'URL du registre OCI du référentiel de modules.
projects.registry.vmware.com/tce
.REPOSITORY-NAMESPACE
est l'espace de noms cible du référentiel de modules. Si cette option n'est pas spécifiée, la CLI Tanzu ajoute le référentiel de modules à l'espace de noms default
.Par exemple, pour ajouter le référentiel de modules standard
, qui contient les modules gérés par l'interface de ligne de commande inclus dans Tanzu Kubernetes Grid, exécutez la commande ci-dessous. Le --namespace
cible pour le référentiel de modules standard
est tkg-system
.
RemarqueSi vous ciblez un cluster basé sur un plan (hérité), ignorez cette étape. Pour les clusters basés sur un plan, le référentiel de modules
tanzu-standard
est automatiquement activé dans chaque cluster, dans l'espace de nomstanzu-package-repo-global
.
tanzu package repository add tanzu-standard --url projects.registry.vmware.com/tkg/packages/standard/repo:v2.2.0 --namespace tkg-system
La commande tanzu package repository update
met à jour un référentiel de modules avec une nouvelle version publiée sur une URL.
Pour mettre à jour un référentiel de modules dans le cluster cible, exécutez :
tanzu package repository update REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE
Où :
REPOSITORY-NAME
est le nom du référentiel de modules dans le cluster.REPOSITORY-URL
est la nouvelle URL du référentiel de modules. Si vous ne spécifiez pas de balise de référentiel de modules dans l'URL, le système utilise la balise de référentiel de modules de la dernière version de Tanzu Kubernetes Grid.REPOSITORY-NAMESPACE
est l'espace de noms du référentiel de modules dans le cluster.La commande de suppression du référentiel de modules tanzu package repository delete
supprime un référentiel de modules. Pour supprimer un référentiel de modules du cluster cible, exécutez :
tanzu package repository delete REPOSITORY-NAME -n REPOSITORY-NAMESPACE
Où :
REPOSITORY-NAME
est le nom du référentiel de modules.REPOSITORY-NAMESPACE
est l'espace de noms du référentiel de modules.Les sections ci-dessous décrivent comment répertorier, installer, mettre à jour et supprimer des modules.
La commande tanzu package available list
répertorie tous les modules et versions de module disponibles.
Répertorier les modules disponibles :
Pour répertorier les modules disponibles dans tous les espaces de noms du cluster cible, exécutez :
tanzu package available list -A
Pour répertorier les modules disponibles dans un espace de noms spécifique, exécutez :
tanzu package available list -n NAMESPACE
Où NAMESPACE
est l'espace de noms pour lequel vous souhaitez récupérer la liste des modules disponibles. Pour répertorier les modules disponibles dans l'espace de noms default
, vous pouvez également exécuter :
tanzu package available list
Répertorier les versions de module disponibles :
Pour répertorier les versions de module disponibles pour un module dans tous les espaces de noms du cluster cible, exécutez :
tanzu package available list AVAILABLE-PACKAGE-NAME -A
Où AVAILABLE-PACKAGE-NAME
est le nom de module que vous avez récupéré en exécutant la commande tanzu package available list
.
Pour répertorier les versions de module disponibles pour un module dans un espace de noms spécifique, exécutez :
tanzu package available list AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE
Où :
AVAILABLE-PACKAGE-NAME
est le nom de module que vous avez récupéré en exécutant la commande tanzu package available list
.AVAILABLE-PACKAGE-NAMESPACE
est l'espace de noms du module disponible.Pour répertorier les versions de module disponibles pour un module dans l'espace de noms default
, vous pouvez également exécuter :
tanzu package available list AVAILABLE-PACKAGE-NAME
La commande tanzu package available get
récupère les détails d'un module disponible.
Pour récupérer les détails d'un module disponible, exécutez :
tanzu package available get AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE
Ou :
tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE
Où :
AVAILABLE-PACKAGE-NAME
est le nom du module disponible. Vous pouvez récupérer ce nom en exécutant la commande tanzu package available list
.AVAILABLE-PACKAGE-VERSION
est la version du module disponible. Vous pouvez récupérer la liste des versions de module disponibles en exécutant la commande tanzu package available list AVAILABLE-PACKAGE-NAME
.AVAILABLE-PACKAGE-NAMESPACE
est l'espace de noms du module disponible.Pour récupérer la configuration par défaut d'un module disponible, utilisez l'indicateur --default-values-file-output
de la commande tanzu package available get
:
tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --default-values-file-output FILE-PATH
Pour récupérer le schéma de valeurs d'un module disponible, y compris la valeur par défaut de chaque clé, utilisez l'indicateur --values-schema
de la commande tanzu package available get
. Cela récupère la section valuesSchema
de la ressource d'API Kubernetes Package
pour le module disponible. Vous pouvez définir le format de sortie (-o
) pour le schéma de valeurs sur yaml
, json
ou table
.
tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --values-schema
La commande tanzu package installed list
répertorie tous les modules actuellement installés dans le cluster cible.
Pour répertorier les modules installés dans tous les espaces de noms d'un cluster, exécutez :
tanzu package installed list -A
Pour répertorier les modules installés dans un espace de noms spécifique, exécutez :
tanzu package installed list -n NAMESPACE
Où NAMESPACE
est l'espace de noms pour lequel vous souhaitez récupérer la liste des modules installés.
La commande tanzu package installed get
récupère les détails d'un module installé.
Pour récupérer les détails d'un module installé, exécutez :
tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE
Où :
INSTALLED-PACKAGE-NAME
est le nom du module installé.INSTALLED-PACKAGE-NAMESPACE
est l'espace de noms dans lequel le module est installé.Si vous souhaitez enregistrer la configuration actuelle d'un module installé dans un fichier, exécutez :
tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE --values-file-output FILE-PATH
Où FILE-PATH
est le chemin d'accès au fichier. Par exemple, values.yaml
.
La commande tanzu package install
installe un module géré par l'interface de ligne de commande.
Pour installer un module géré par l'interface de ligne de commande dans le cluster cible :
Si vous ne l'avez pas déjà fait, ajoutez le référentiel de modules qui contient le module. Reportez-vous à la section Ajouter un référentiel de modules ci-dessus.
Notez le nom et la version du module que vous souhaitez installer. Pour afficher le nom et la version du module, exécutez la commande tanzu package available list
. Reportez-vous à la section Répertorier les modules disponibles ci-dessus.
Installez le module :
tanzu package install PACKAGE-NAME -p AVAILABLE-PACKAGE-NAME -v AVAILABLE-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n TARGET-NAMESPACE
Où :
PACKAGE-NAME
est un nom que vous choisissez pour le module.AVAILABLE-PACKAGE-NAME
est le nom de module que vous avez noté ci-dessus.AVAILABLE-PACKAGE-VERSION
est la version du module que vous avez notée ci-dessus.PACKAGE-CONFIGURATION-FILE
est le fichier de configuration que vous avez préparé pour le module. Si cette option n'est pas spécifiée, le module est installé avec la configuration par défaut.TARGET-NAMESPACE
est l'espace de noms dans lequel installer le module (PackageInstall
), l'application de module (App
) et toutes les autres ressources Kubernetes qui décrivent le module. Par exemple, l'espace de noms my-packages
ou tanzu-cli-managed-packages
.
-n
n'est pas spécifié, la CLI Tanzu utilise l'espace de noms default
. N'installez pas le contenu du module, tel que les espaces et les services, dans cet espace de noms. L'espace de noms du contenu du module est défini séparément dans la configuration du module.kubectl create namespace my-packages
.Pour afficher la liste complète des indicateurs pris en charge pour cette commande, utilisez l'option --help
.
Pour confirmer que le module a été installé, exécutez la commande tanzu package installed list
. Reportez-vous à la section Répertorier les modules installés ci-dessus.
La commande tanzu package installed update
met à jour la version et la configuration d'un module géré par l'interface de ligne de commande.
Avant de mettre à jour la version d'un module géré par l'interface de ligne de commande, vous mettez généralement à jour son référentiel comme décrit dans la section Mettre à jour un référentiel de modules.
Pour mettre à jour la version et la configuration d'un module géré par l'interface de ligne de commande, exécutez :
tanzu package installed update INSTALLED-PACKAGE-NAME -v TARGET-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n INSTALLED-PACKAGE-NAMESPACE
Où :
INSTALLED-PACKAGE-NAME
est le nom que vous avez choisi pour le module. Pour afficher le nom du module, vous pouvez exécuter la commande tanzu package installed list
. Pour plus d'informations, reportez-vous à la section Répertorier les modules installés.TARGET-PACKAGE-VERSION
est la version vers laquelle vous souhaitez mettre à jour le module. Non requis si vous mettez à jour la configuration du module, mais pas la version.PACKAGE-CONFIGURATION-FILE
est le chemin d'accès au fichier .yaml
qui contient la configuration du module mise à jour. Non requis si vous mettez à jour la version du module, mais pas la configuration. Pour récupérer la configuration actuelle, reportez-vous la section Obtenir les détails d'un module installé.INSTALLED-PACKAGE-NAMESPACE
est l'espace de noms dans lequel le module est installé.La commande tanzu package installed delete
supprime un module géré par l'interface de ligne de commande.
Pour supprimer un module géré via CLI du cluster cible, exécutez :
tanzu package installed delete INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE
Où :
INSTALLED-PACKAGE-NAME
est le nom du module que vous souhaitez supprimer. Pour afficher le nom du module, vous pouvez exécuter la commande tanzu package installed list
. Pour plus d'informations, reportez-vous à la section Répertorier les modules installés.INSTALLED-PACKAGE-NAMESPACE
est l'espace de noms dans lequel le module est installé. Si vous ne spécifiez pas d'espace de noms, l'espace de noms default
est utilisé.Pour personnaliser les modules gérés par l'interface de ligne de commande, vous pouvez appliquer des superpositions ytt
.