Instalar y administrar paquetes

En esta sección 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:

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.
    • 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 suele estar en projects.registry.vmware.com/tkg. 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.

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

Si el espacio de nombres de destino no existe en el clúster, puede crearlo ejecutando el siguiente comando:

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

La marca --create-namespace crea el espacio de nombres si no existe en el clúster de destino.

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.

Si el repositorio de paquetes que va a actualizar no existe en el clúster de destino, puede crearlo ejecutando el siguiente comando:

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

La marca --create crea el repositorio de paquetes si no existe en el clúster de destino.

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 generar un archivo de configuración predeterminado para un paquete, utilice la marca --generate-default-values-file del comando tanzu package available get:

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --generate-default-values-file

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 -f 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:

    • Si el espacio de nombres de destino existe en el clúster, ejecute:

      tanzu package install PACKAGE-NAME -p AVAILABLE-PACKAGE-NAME -v AVAILABLE-PACKAGE-VERSION -f PACKAGE-CONFIGURATION-FILE -n PACKAGE-NAMESPACE
      
    • Si el espacio de nombres de destino no existe en el clúster, ejecute:

      tanzu package install PACKAGE-NAME -p AVAILABLE-PACKAGE-NAME -v AVAILABLE-PACKAGE-VERSION -f PACKAGE-CONFIGURATION-FILE -n PACKAGE-NAMESPACE --create-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.
    • PACKAGE-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.

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

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:

  1. En un terminal, 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.
  2. (Opcional) Si usted u otro usuario crearon un espacio de nombres para este paquete mediante el parámetro --create-namespace con tanzu package install, asegúrese de que el espacio de nombres esté vacío y, a continuación, elimine el espacio de nombres.

Aplicar superposiciones a paquetes

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

check-circle-line exclamation-circle-line close-line
Scroll to top icon