Instalar y administrar paquetes

En este tema se describe cómo instalar y administrar paquetes y repositorios de paquetes mediante la CLI de Tanzu.

Nota

El complemento de la CLI de tanzu package está destinado solo a paquetes administrados por CLI. No utilice los comandos proporcionados en este tema para instalar y administrar paquetes administrados automáticamente. Tanzu Kubernetes Grid administra automáticamente su ciclo de vida. Para obtener más información sobre los paquetes administrados automáticamente, consulte Paquetes administrados automáticamente.

Preparar la instalación de paquetes administrados por CLI

Antes de instalar los paquetes administrados por CLI desde el repositorio de paquetes standard:

1. Instalar la CLI de Tanzu.
2. Agregar el repositorio de paquetes tanzu-standard. Si tiene como objetivo un clúster basado en planes (heredado), omita este paso. Para los clústeres basados en planes, el repositorio de paquetes tanzu-standard se habilita automáticamente en cada clúster, en el espacio de nombres tanzu-package-repo-global.
3. Revise el Contenido del repositorio estándar de Tanzu..
4. Instalar el administrador de certificados para la administración de certificados en clústeres de carga de trabajo.

Descripción general de la instalación

Para obtener instrucciones sobre cómo instalar y administrar paquetes mediante la CLI de Tanzu, consulte las secciones que aparecen a continuación.

• Repositorios de paquetes: Consulte esta sección si desea:

  • Enumerar todos los repositorios de paquetes disponibles para el clúster de destino o agregarse a este
  • Obtener los detalles de un repositorio de paquetes disponible o agregado
  • Agregar, actualizar o eliminar un repositorio de paquetes

• Paquetes: Consulte esta sección si desea:

  • Enumerar todos los paquetes disponibles o instalados en el clúster de destino
  • Obtener los detalles de un paquete disponible o instalado
  • Instalar, actualizar o eliminar un paquete

Para obtener más información sobre los comandos tanzu packagetanzu, consulte tanzu package.

Espacios de nombres del paquete y espacios de nombres del sistema

Los repositorios de paquetes y los paquetes se instalan en el espacio de nombres que elija. Si no establece la opción --namespace, la CLI de Tanzu tiene como destino el espacio de nombres default.

Los componentes de los servicios empaquetados se ejecutan en un espacio de nombres del sistema que es independiente del lugar en el que se implementan los paquetes. Por ejemplo, los componentes Contour y Envoy se ejecutan en el espacio de nombres tanzu-system-ingress y los componentes de Harbor se ejecutan en tanzu-system-registry.

No instale paquetes en ningún espacio de nombres tanzu-system-.

Repositorios de paquetes

En las siguientes secciones se describe cómo enumerar, agregar, actualizar y eliminar repositorios de paquetes.

Enumerar repositorios de paquetes

El comando tanzu package repository list enumera todos los repositorios de paquetes que están disponibles en el clúster de destino. Esta lista incluye repositorios de paquetes que se agregaron al clúster de destino mediante la ejecución del comando tanzu package repository add. Para agregar un repositorio de paquetes al clúster, consulte Agregar un repositorio de paquetes a continuación.

• Para enumerar los repositorios de paquetes en todos los espacios de nombres del clúster de destino, ejecute:

  tanzu package repository list -A
  

• Para enumerar los repositorios de paquetes en un espacio de nombres específico, ejecute:

  tanzu package repository list -n NAMESPACE
  

  Donde NAMESPACE es el espacio de nombres de destino. La opción --namespace o -n, es obligatoria si desea enumerar los repositorios de paquetes en un espacio de nombres que no sea default.

  Para enumerar los repositorios de paquetes en el espacio de nombres default, también puede ejecutar:

  tanzu package repository list
  

Obtener los detalles de un repositorio de paquetes

El comando tanzu package repository get recupera los detalles de un repositorio de paquetes.

Para recuperar los detalles de un repositorio de paquetes, ejecute:

tanzu package repository get REPOSITORY-NAME -n REPOSITORY-NAMESPACE

Donde:

• REPOSITORY-NAME es el nombre del repositorio de paquetes en el clúster de destino.
• REPOSITORY-NAMESPACE es el espacio de nombres del repositorio de paquetes en el clúster de destino.

Agregar un repositorio de paquetes

El comando tanzu package repository add agrega un repositorio de paquetes.

Para agregar un repositorio de paquetes al clúster de destino, ejecute:

tanzu package repository add REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE

Donde:

• REPOSITORY-NAME es el nombre que elige para el repositorio de paquetes.
• REPOSITORY-URL es la URL del registro de OCI del repositorio del paquete.
  • Consulte Repositorios de paquetes de lista para obtener este valor de la CLI de Tanzu, o bien en Tanzu Mission Control, consulte la lista Complementos (Addons) > Repositorios (Repositories) en el panel Clúster (Cluster).
  • Si omite una etiqueta de repositorio de paquetes al final de la URL, el sistema utiliza la etiqueta de la versión más reciente de Tanzu Kubernetes Grid.
  • Esta URL no puede estar en projects.registry.vmware.com/tce.
• REPOSITORY-NAMESPACE es el espacio de nombres de destino del repositorio de paquetes. Si no se especifica esta opción, la CLI de Tanzu agrega el repositorio de paquetes al espacio de nombres default.

Por ejemplo, para agregar el repositorio de paquetes standard, que contiene paquetes administrados por CLI incluidos en Tanzu Kubernetes Grid, ejecute el siguiente comando. El --namespace de destino del repositorio de paquetes standard es tkg-system.

Nota

Si tiene como objetivo un clúster basado en planes (heredado), omita este paso. Para los clústeres basados en planes, el repositorio de paquetes tanzu-standard se habilita automáticamente en cada clúster, en el espacio de nombres 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

Actualizar un repositorio de paquetes

El comando tanzu package repository update actualiza un repositorio de paquetes con una nueva versión publicada en una URL.

Para actualizar un repositorio de paquetes en el clúster de destino, ejecute:

tanzu package repository update REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE

Donde:

• REPOSITORY-NAME es el nombre del repositorio de paquetes del clúster.
• REPOSITORY-URL es la nueva URL del repositorio del paquete. Si no especifica una etiqueta de repositorio de paquetes en la URL, el sistema utiliza la etiqueta de repositorio de paquetes de la versión más reciente de Tanzu Kubernetes Grid.
• REPOSITORY-NAMESPACE es el espacio de nombres del repositorio de paquetes en el clúster.

Eliminar un repositorio de paquetes

El comando tanzu package repository delete elimina un repositorio de paquetes. Para eliminar un repositorio de paquetes del clúster de destino, ejecute:

tanzu package repository delete REPOSITORY-NAME -n REPOSITORY-NAMESPACE

Donde:

• REPOSITORY-NAME es el nombre del repositorio del paquete.
• REPOSITORY-NAMESPACE es el espacio de nombres del repositorio de paquetes.

Paquetes

En las siguientes secciones se describe cómo enumerar, instalar, actualizar y eliminar paquetes.

Enumerar paquetes disponibles

El comando tanzu package available list enumera todos los paquetes y las versiones de paquetes disponibles.

Enumerar paquetes disponibles:

• Para enumerar los paquetes disponibles en todos los espacios de nombres del clúster de destino, ejecute:

  tanzu package available list -A
  

• Para enumerar los paquetes disponibles en un espacio de nombres específico, ejecute:

  tanzu package available list -n NAMESPACE
  

  Donde NAMESPACE es el espacio de nombres desde el que desea recuperar la lista de paquetes disponibles. Para enumerar los paquetes disponibles en el espacio de nombres default, también puede ejecutar:

  tanzu package available list
  

Enumerar versiones de paquetes disponibles:

• Para enumerar las versiones de paquetes disponibles para un paquete en todos los espacios de nombres del clúster de destino, ejecute:

  tanzu package available list AVAILABLE-PACKAGE-NAME -A
  

  Donde AVAILABLE-PACKAGE-NAME es el nombre del paquete que recuperó ejecutando el comando tanzu package available list.

• Para enumerar las versiones de paquetes disponibles para un paquete en un espacio de nombres específico, ejecute:

  tanzu package available list AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE
  

  Donde:

  • AVAILABLE-PACKAGE-NAME es el nombre del paquete que recuperó ejecutando el comando tanzu package available list.
  • AVAILABLE-PACKAGE-NAMESPACE es el espacio de nombres del paquete disponible.

  Para enumerar las versiones de paquetes disponibles para un paquete en el espacio de nombres default, también puede ejecutar:

  tanzu package available list AVAILABLE-PACKAGE-NAME
  

Obtener los detalles de un paquete disponible

El comando tanzu package available get recupera los detalles de un paquete disponible.

Para recuperar los detalles de un paquete disponible, ejecute:

tanzu package available get AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE

O:

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE

Donde:

• AVAILABLE-PACKAGE-NAME es el nombre del paquete disponible. Puede recuperar este nombre ejecutando el comando tanzu package available list.
• AVAILABLE-PACKAGE-VERSION es la versión del paquete disponible. Puede recuperar la lista de versiones de paquetes disponibles ejecutando el comando tanzu package available list AVAILABLE-PACKAGE-NAME.
• AVAILABLE-PACKAGE-NAMESPACE es el espacio de nombres del paquete disponible.

Para recuperar la configuración predeterminada de un paquete disponible, utilice el marcador --default-values-file-output del comando tanzu package available get:

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --default-values-file-output FILE-PATH

Para recuperar el esquema de valores de un paquete disponible, incluido el valor predeterminado de cada clave, utilice la marca --values-schema del comando tanzu package available get. De este modo, se recupera la sección valuesSchema del recurso de api Package Kubernetes para el paquete disponible. Puede establecer el formato de salida, -o, para el esquema de valores en yaml, json o table.

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --values-schema

Enumerar paquetes instalados

El comando tanzu package installed list enumera todos los paquetes que están instalados actualmente en el clúster de destino.

Para enumerar los paquetes instalados en todos los espacios de nombres de un clúster, ejecute:

tanzu package installed list -A

Para enumerar los paquetes instalados en un espacio de nombres específico, ejecute:

tanzu package installed list -n NAMESPACE

Donde NAMESPACE es el espacio de nombres desde el que desea recuperar la lista de paquetes instalados.

Obtener los detalles de un paquete instalado

El comando tanzu package installed get recupera los detalles de un paquete instalado.

Para recuperar los detalles de un paquete instalado, ejecute:

tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE

Donde:

• INSTALLED-PACKAGE-NAME es el nombre del paquete instalado.
• INSTALLED-PACKAGE-NAMESPACE es el espacio de nombres en el que se instala el paquete.

Si desea guardar la configuración actual de un paquete instalado en un archivo, ejecute:

tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE --values-file-output FILE-PATH

Donde FILE-PATH es la ruta de acceso al archivo. Por ejemplo, values.yaml.

Instalar un paquete

El comando tanzu package install instala un paquete administrado por cli.

Para instalar un paquete administrado por la CLI en el clúster de destino:

1. Si aún no lo ha hecho, agregue el repositorio de paquetes que contiene el paquete. Consulte Agregar un repositorio de paquetes arriba.

2. Anote el nombre y la versión del paquete que desea instalar. Para ver el nombre y la versión del paquete, ejecute el comando tanzu package available list. Consulte Enumerar paquetes disponibles más arriba.

3. Instale el paquete:

   tanzu package install PACKAGE-NAME -p AVAILABLE-PACKAGE-NAME -v AVAILABLE-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n TARGET-NAMESPACE
   

   Donde:

   • PACKAGE-NAME es el nombre que elija para el paquete.
   • AVAILABLE-PACKAGE-NAME es el nombre del paquete que anotó anteriormente.
   • AVAILABLE-PACKAGE-VERSION es la versión del paquete que anotó anteriormente.
   • PACKAGE-CONFIGURATION-FILE es el archivo de configuración que preparó para el paquete. Si no se especifica esta opción, el paquete se instala con la configuración predeterminada.

   • TARGET-NAMESPACE es el espacio de nombres en el que se instalará el paquete (PackageInstall), la aplicación de paquete (App) y cualquier otro recurso de Kubernetes que describa el paquete. Por ejemplo, el espacio de nombres my-packages o tanzu-cli-managed-packages.

     • Si no se especifica la marca -n, la CLI de Tanzu utiliza el espacio de nombres default. No instale el contenido del paquete, como pods y servicios, en este espacio de nombres. El espacio de nombres para el contenido del paquete se establece por separado, en la configuración del paquete.
     • El espacio de nombres especificado ya debe existir, por ejemplo, al haber ejecutado kubectl create namespace my-packages.

   Para ver la lista completa de marcas admitidas para este comando, utilice la opción --help.

4. Para confirmar que el paquete se instaló, ejecute el comando tanzu package installed list. Consulte Enumerar paquetes instalados arriba.

Actualizar un paquete

El comando tanzu package installed update actualiza la versión y la configuración de un paquete administrado por cli.

Antes de actualizar la versión de un paquete administrado por CLI, por lo general, se actualiza su repositorio como se describe en Actualizar un repositorio de paquetes.

Para actualizar la versión y la configuración de un paquete administrado por CLI, ejecute:

tanzu package installed update INSTALLED-PACKAGE-NAME -v TARGET-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n INSTALLED-PACKAGE-NAMESPACE

Donde:

• INSTALLED-PACKAGE-NAME es el nombre que seleccionó para el paquete. Para ver el nombre del paquete, puede ejecutar el comando tanzu package installed list. Para obtener más información, consulte Enumerar paquetes instalados.
• (Opcional) TARGET-PACKAGE-VERSION es la versión a la que desea actualizar el paquete. No es necesario si va a actualizar la configuración del paquete, no la versión.
• (Opcional) PACKAGE-CONFIGURATION-FILE es la ruta de acceso al archivo .yaml que contiene la configuración actualizada del paquete. No es necesario si va a actualizar la versión del paquete, no la configuración. Para recuperar la configuración actual, consulte Obtener los detalles de un paquete instalado.
• INSTALLED-PACKAGE-NAMESPACE es el espacio de nombres en el que se instala el paquete.

Nota

Para los clústeres de carga de trabajo actualizados de TKG v2.1.0 a v2.1.1, la actualización de las configuraciones de cert-manager, external-dns y grafana pueden requerir actualizar la versión del paquete, como se describe en la lista de Problemas conocidos La actualización de la configuración requiere actualizar algunos paquetes.

Eliminar un paquete

El comando tanzu package installed delete elimina un paquete administrado por la CLI.

Para eliminar un paquete administrado por la CLI del clúster de destino, ejecute:

tanzu package installed delete INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE

Donde:

• INSTALLED-PACKAGE-NAME es el nombre del paquete que desea eliminar. Para ver el nombre del paquete, puede ejecutar el comando tanzu package installed list. Para obtener más información, consulte Enumerar paquetes instalados.
• INSTALLED-PACKAGE-NAMESPACE es el espacio de nombres en el que se instala el paquete. Si no especifica un espacio de nombres, se utiliza el espacio de nombres default.

Aplicar superposiciones a paquetes

Para personalizar los paquetes administrados por la CLI, puede aplicar superposiciones ytt.