Installer et gérer des modules

Cette rubrique décrit comment installer et gérer des modules et des référentiels de modules à l'aide de la CLI Tanzu.

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

Préparation de l'installation des modules gérés via CLI

Avant d'installer des modules gérés via CLI à partir du référentiel de modules standard :

Installez la CLI Tanzu.
Ajoutez le référentiel de modules 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.
Consultez la section Contenu du référentiel standard Tanzu.
Installez le gestionnaire de certificats pour la gestion des certificats dans les clusters de charge de travail.

Présentation de l'installation

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 :
- Répertorier tous les référentiels de modules disponibles pour le cluster cible ou ajoutés à ce dernier
- Obtenir les détails d'un référentiel de modules disponible ou ajouté
- Ajouter, mettre à jour ou supprimer un référentiel de modules
Modules : reportez-vous à cette section si vous souhaitez effectuer les actions suivantes :
- Répertorier tous les modules disponibles pour le cluster cible ou ajoutés à ce dernier
- Obtenir les détails d'un module disponible ou installé
- Installer, mettre à jour ou supprimer un module

Pour plus d'informations sur les commandes de tanzu package, reportez-vous à la section Module Tanzu.

Espaces de noms du module et espaces de noms système

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

Référentiels de modules

Les sections ci-dessous décrivent comment répertorier, ajouter, mettre à jour et supprimer des référentiels de modules.

Répertorier les 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
```

Obtenir les détails d'un référentiel de modules

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.

Ajouter un référentiel de modules

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.
- Reportez-vous à la section Répertorier les référentiels de modules (List Package Repositories) pour obtenir cette valeur depuis la CLI Tanzu ou, dans Tanzu Mission Control, consultez la liste Modules complémentaires (Addons) > Référentiels (Repositories) dans le volet Cluster.
- Si vous omettez une balise de référentiel de modules à la fin de l'URL, le système utilise la balise de la dernière version de Tanzu Kubernetes Grid.
- Cette URL ne peut pas se trouver sous 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.

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

tanzu package repository add tanzu-standard --url projects.registry.vmware.com/tkg/packages/standard/repo:v2.1.1 --namespace tkg-system

Mettre à jour un référentiel de modules

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.

Supprimer un référentiel de modules

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.

Modules

Les sections ci-dessous décrivent comment répertorier, installer, mettre à jour et supprimer des modules.

Répertorier les modules disponibles

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

Obtenir les détails d'un module disponible

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

Répertorier les modules installés

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.

Obtenir les détails d'un module installé

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.

Installer un module

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.
  - Si l'indicateur -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.
  - L'espace de noms spécifié doit déjà exister, par exemple en exécutant 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.

Mettre à jour un module

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.
(Facultatif) 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.
(Facultatif) 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é.

Remarque
Pour les clusters de charge de travail mis à niveau de TKG 2.1.0 vers la version 2.1.1, la mise à jour des configurations cert-manager, external-dns et grafana peut nécessiter la mise à niveau de la version du module, comme décrit dans la liste des problèmes connus sur la page La mise à jour de la configuration nécessite une mise à niveau pour certains modules.

Supprimer un module

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

Application de superpositions aux modules

Pour personnaliser les modules gérés par l'interface de ligne de commande, vous pouvez appliquer des superpositions ytt.