En este tema se describe cómo instalar y administrar paquetes y repositorios de paquetes mediante la CLI de Tanzu.
NotaEl 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.
Antes de instalar los paquetes administrados por CLI desde el repositorio de paquetes standard
:
tanzu-standard
.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:
Paquetes: Consulte esta sección si desea:
Para obtener más información sobre los comandos tanzu package
tanzu, consulte tanzu package.
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-
.
En las siguientes secciones se describe cómo enumerar, agregar, actualizar y eliminar 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
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.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.
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:v2023.10.16 --namespace tkg-system
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.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.En las siguientes secciones se describe cómo enumerar, instalar, actualizar y eliminar paquetes.
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
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
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.
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
.
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:
Si aún no lo ha hecho, agregue el repositorio de paquetes que contiene el paquete. Consulte Agregar un repositorio de paquetes arriba.
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.
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
.
-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.kubectl create namespace my-packages
.Para ver la lista completa de marcas admitidas para este comando, utilice la opción --help
.
Para confirmar que el paquete se instaló, ejecute el comando tanzu package installed list
. Consulte Enumerar paquetes instalados arriba.
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.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.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.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
.Para personalizar los paquetes administrados por la CLI, puede aplicar superposiciones ytt
. Para obtener información sobre cómo descargar e instalar ytt
, consulte Instalar Carvel Tools.