En este tema se explica cómo instalar e inicializar la interfaz de línea de comandos (CLI) de Tanzu en una máquina de arranque. La máquina de arranque es el equipo portátil, el host o el servidor desde el que se implementan los clústeres de carga de trabajo y administración, y que mantiene los archivos de configuración de Tanzu y Kubernetes para las implementaciones. La máquina de arranque suele ser local, pero también puede ser una máquina física o una máquina virtual a la que se accede de forma remota.
Si pretende utilizar Tanzu Kubernetes Grid en vSphere sin supervisor, o en AWS o Azure, utilice la CLI de Tanzu para crear un clúster de administración independiente en cada proveedor de nube que utilice. La CLI de Tanzu se comunica con este clúster de administración para crear y administrar clústeres de carga de trabajo en su infraestructura de nube de destino.
NotaLas instrucciones de este tema son específicas para instalar la CLI de Tanzu con el fin de implementar clústeres de administración independientes en vSphere sin un supervisor, o en AWS o Azure. Si va a instalar la CLI de Tanzu para usarla con un supervisor de vSphere with Tanzu en vSphere 8, consulte el tema correspondiente en Crear y administrar clústeres de carga de trabajo de TKG 2.1 con la CLI de Tanzu, Instalar la CLI de Tanzu y otras herramientas para su uso con un supervisor de vSphere with Tanzu.
Para obtener más información sobre la CLI de Tanzu, incluida una referencia de comandos, consulte la documentación de la CLI de VMware Tanzu.
La máquina de arranque en la que instala y ejecuta la CLI de Tanzu debe cumplir ciertos requisitos. Existen más requisitos en función de si desea utilizar la CLI de Tanzu con un supervisor de vSphere with Tanzu como clúster de administración, implementar clústeres de administración independientes, o ambos.
Para ejecutar la CLI de Tanzu con Tanzu Kubernetes Grid v2.1, necesita una máquina de arranque en la que instalar y ejecutar la CLI de Tanzu que tiene:
Si su máquina de arranque se ejecuta Windows, VMware recomienda instalar Windows Subsistema para Linux (WSL) con Ubuntu 20.04.4 LTS, lo que le permite ejecutar comandos de Linux en Windows. Para obtener más información sobre WSL, consulte Instalar WSL en la documentación de Microsoft.
En VMware Cloud on AWS y Azure VMware Solution, la máquina de arranque debe ser una máquina virtual en la nube, no una máquina física local. Consulte Preparar para implementar clústeres de administración en un entorno de VMware Cloud para obtener instrucciones de configuración.
Para implementar clústeres de administración independientes, existen requisitos adicionales en función del sistema operativo en el que se ejecute la máquina de arranque:
kind
. Consulte Configuración de Docker Desktop en la documentación de kind
.apt
en lugar de snap
para instalar Docker desde una CLI. Para obtener instrucciones sobre cómo instalar la aplicación cliente de Docker en un entorno con acceso a Internet restringido, consulte Preparar un entorno con acceso a Internet restringido.docker
. Cree el grupo si aún no existe. Esto permite que la CLI de Tanzu acceda al socket de Docker, que pertenece al usuario root
. Para obtener más información, consulte la Administrar Docker como usuario no raíz en la documentación de Docker.Si la máquina de arranque tiene un kernel de Linux compilado después de la revisión de seguridad de Linux de mayo de 2021, debe habilitar kind
, que la CLI de Tanzu utiliza para crear el clúster de arranque local, para escribir en un archivo de control que las versiones recientes de Linux se hacen de solo lectura de forma predeterminada.
La forma en que cambie este permiso de archivo depende de la distribución de Linux. Por ejemplo, con una distribución de Fedora de Linux 5.11 y 5.12, ejecute:
sudo sysctl net/netfilter/nf_conntrack_max=131072
Con una distribución Debian, agregue nf_conntrack_max=131072
al archivo sysctl.conf
y ejecute:
sudo modprob nf_conntrack
Si está solucionando problemas como se describe en Usar un clúster de arranque existente para implementar y eliminar clústeres de administración, debe utilizar kind
v0.11 o una versión posterior para crear el clúster de arranque persistente y preexistente.
kind
. Consulte Configuración de Docker Desktop en la documentación de kind
.Si la máquina de arranque ejecuta Windows Subsystem for Linux y tiene un kernel de Linux compilado después de la revisión de seguridad de Linux de mayo de 2021 (por ejemplo, Linux 5.11 y 5.12 con Fedora), ejecute lo siguiente:
sudo sysctl net/netfilter/nf_conntrack_max=131072
Esto permite que kind
, que la CLI tanzu
utiliza para crear el clúster de arranque local, escriba en un archivo de control que las versiones recientes de Linux hacen de solo lectura de forma predeterminada.
Si está solucionando problemas como se describe en Usar un clúster de arranque existente para implementar y eliminar clústeres de administración, debe utilizar kind
v0.11 o una versión posterior para crear el clúster de arranque persistente y preexistente.
Descargue los archivos de la versión compatible de la CLI de Tanzu desde la página de descargas de Tanzu Kubernetes Grid.
Vaya a VMware Customer Connect e inicie sesión con las credenciales de VMware Customer Connect.
En la fila VMware Tanzu Kubernetes Grid, haga clic en Ir a descargas (Go to Downloads).
En el menú desplegable Seleccionar versión (Select Version), seleccione 2.1.1.
En Descargas de productos (Product Downloads), desplácese hasta la sección con la etiqueta CLI de VMware Tanzu 2.1.1 (VMware Tanzu CLI 2.1.1).
(Opcional) Compruebe que los archivos descargados no se cambien del original. VMware proporciona un SHA-1, un SHA-256 y una suma de comprobación MD5 para cada descarga. Para obtener estas sumas de comprobación, haga clic en Leer más (Read More) en la entrada que desea descargar. Para obtener más información, consulte Usar hashes criptográficos.
En el sistema, cree un nuevo directorio denominado tanzu
. Si desempaquetó previamente artefactos de versiones anteriores en esta carpeta, elimine el contenido existente de la carpeta.
En la carpeta tanzu
, desempaquete el archivo del paquete CLI de Tanzu para su sistema operativo. Para desempaquetar el archivo de paquete, utilice la herramienta de extracción que desee. Por ejemplo, en Linux o macOS, puede usar el comando tar
.
tar -xvf tanzu-cli-bundle-darwin-amd64.tar.gz
tar -xvf tanzu-cli-bundle-linux-amd64.tar.gz
tanzu-cli-bundle-windows-amd64.zip
.
Después de desempaquetar el archivo del paquete, en la carpeta tanzu
, verá una carpeta cli
con varias subcarpetas y archivos.
Después de descargar y desempaquetar la CLI de Tanzu en el equipo de arranque, debe ponerlo a disposición del sistema.
Desplácese hasta la subcarpeta cli
en la carpeta tanzu
que desempaquetó en la sección anterior.
Haga que la CLI esté disponible para el sistema:
/usr/local/bin
:
sudo install core/v0.28.1/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
/usr/local/bin
:
sudo install core/v0.28.1/tanzu-core-linux_amd64 /usr/local/bin/tanzu
Program Files\tanzu
.cli
desempaquetada, busque y copie el archivo core\v0.28.1\tanzu-core-windows_amd64.exe
en la nueva carpeta Program Files\tanzu
.tanzu-core-windows_amd64.exe
a tanzu.exe
.tanzu
, seleccione Propiedades (Properties) > Seguridad (Security) y asegúrese de que su cuenta de usuario tenga el permiso Control completo (Full Control).env
.Path
en Variables del sistema (System variables) y haga clic en Editar (Edit).tanzu
.En la línea de comandos de un terminal nuevo, inicialice la CLI de Tanzu:
tanzu init
Compruebe que la versión correcta de la CLI esté instalada correctamente. La versión de la CLI es la misma que la versión actual de Tanzu Framework, que se incluye en la CLI de Tanzu. Tanzu Kubernetes Grid 2.1.1 utiliza CLI de Tanzu v0.28.1, que se encuentra en Tanzu Framework v0.28.1:
tanzu version
Si ejecuta en macOS, es posible que se produzca el siguiente error:
"tanzu" cannot be opened because the developer cannot be verified.
Si esto sucede, debe crear una excepción de seguridad para el ejecutable tanzu
. Busque la aplicación tanzu
en Finder, haga clic con la botón secundario en la aplicación y seleccione Abrir (Open).
Si tiene complementos de la CLI de Tanzu instalados en su máquina de una instalación de CLI anterior, actualice los complementos a la versión actual de la CLI:
Desinstale los complementos existentes:
tanzu plugin clean
Instale todos los complementos para esta versión:
tanzu plugin sync
Compruebe el estado de instalación y la versión del complemento:
tanzu plugin list
NotaDespués de instalar la CLI de Tanzu pero antes de usarla para iniciar sesión en un clúster de administración, todos los grupos de comandos de la CLI específicos del contexto, como
tanzu cluster
ytanzu kubernetes-release
, no están disponibles y no se incluyen en los resultados de--help
de la CLI de Tanzu.
Descargue y desempaquete la CLI de Kubernetes, kubectl
, en el equipo de arranque y, a continuación, póntela a disposición del sistema.
Vaya a VMware Customer Connect e inicie sesión con las credenciales de VMware Customer Connect.
En la fila VMware Tanzu Kubernetes Grid, haga clic en Ir a descargas (Go to Downloads).
En el menú desplegable Seleccionar versión (Select Version), seleccione 2.1.1.
En Descargas de productos (Product Downloads), desplácese hasta la sección denominada Kubectl 1.24.10 para VMware Tanzu Kubernetes Grid 2.1.1.
(Opcional) Compruebe que los archivos descargados no se cambien del original. VMware proporciona un SHA-1, un SHA-256 y una suma de comprobación MD5 para cada descarga. Para obtener estas sumas de comprobación, haga clic en Leer más (Read More) en la entrada que desea descargar. Para obtener más información, consulte Usar hashes criptográficos.
Desplácese hasta el directorio tanzu
que creó en Descargar y desempaquetar la CLI de Tanzu anterior y desempaquetar el archivo binario kubectl
para su sistema operativo. Para desempaquetar el archivo de paquete, utilice la herramienta de extracción que desee. Por ejemplo, el comando gunzip
.
gunzip kubectl-mac-v1.24.10+vmware.1.gz
gunzip kubectl-linux-v1.24.10+vmware.1.gz
kubectl-windows-v1.24.10+vmware.1.exe.gz
.
Haga que la CLI esté disponible para el sistema:
Haga que el archivo descargado sea ejecutable:
chmod ugo+x kubectl-mac-v1.24.10+vmware.1
Instale el archivo binario en /usr/local/bin
:
sudo install kubectl-mac-v1.24.10+vmware.1 /usr/local/bin/kubectl
Ejecute kubectl version
para comprobar que la versión correcta de kubectl
esté instalada y sea ejecutable.
kubectl version
Haga que el archivo descargado sea ejecutable:
chmod ugo+x kubectl-linux-v1.24.10+vmware.1
Instale el archivo binario en /usr/local/bin
:
sudo install kubectl-linux-v1.24.10+vmware.1 /usr/local/bin/kubectl
Ejecute kubectl version
para comprobar que la versión correcta de kubectl
esté instalada y sea ejecutable.
kubectl version
Program Files\kubectl
.kubectl-windows-v1.24.10+vmware.1.exe
en la nueva carpeta Program Files\kubectl
.kubectl-windows-v1.24.10+vmware.1.exe
a kubectl.exe
.kubectl
, seleccione Propiedades (Properties) > Seguridad (Security) y asegúrese de que su cuenta de usuario tenga el permiso Control completo (Full Control).env
.Path
en Variables del sistema (System variables) y haga clic en Editar (Edit).kubectl
.Ejecute kubectl version
para comprobar que la versión correcta de la CLI esté instalada correctamente.
Ejecute tanzu --help
para ver la lista de comandos que proporciona la CLI de Tanzu.
Puede ver el texto de ayuda de cualquier grupo de comandos con la opción --help
para ver información sobre ese grupo de comandos o comandos específico. Por ejemplo, tanzu login --help
, tanzu management-cluster --help
o tanzu management-cluster create --help
.
Para obtener más información sobre la CLI de Tanzu, consulte la referencia CLI de Tanzu Command Reference.
El proyecto de código abierto de Carvel: proporciona un conjunto de herramientas de composición confiables de un solo propósito que ayudan en la creación, la configuración y la implementación de aplicaciones en Kubernetes.
Tanzu Kubernetes Grid proporciona binarios firmados para ytt
, kapp
,kbld
y imgpkg
, que se incluyen con la CLI de Tanzu. El paquete también incluye vendir
, una herramienta de estructura de directorios de Kubernetes que actualmente no requieren los usuarios finales, pero que se proporciona para su comodidad.
Desplácese hasta la ubicación de la máquina del entorno de arranque en la que desempaquetó el archivo tar del paquete de la CLI de Tanzu para el sistema operativo.
Por ejemplo, la carpeta tanzu
que creó en el procedimiento anterior.
Abra la carpeta cli
.
cd cli
ytt
ytt
es una herramienta de línea de comandos para aplicar plantillas y revisiones a archivos YAML. También puede utilizar ytt
para recopilar fragmentos y pilas de YAML en fragmentos modulares para volver a utilizarlos fácilmente. Tanzu Kubernetes Grid utiliza ytt
para admitir la personalización basada en superposición para clústeres y planes de clústeres. Es posible que necesite ytt
para usar superposiciones de personalización.
Descomprima el ytt
binario y haga que sea ejecutable.
gunzip ytt-darwin-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-darwin-amd64-v0.43.1+vmware.1
Mueva el archivo binario a /usr/local/bin
y cámbiele el nombre a ytt
:
sudo mv ./ytt-darwin-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
Ejecute ytt --version
para comprobar que la versión correcta de ytt
esté instalada y sea ejecutable.
ytt --version
Descomprima el ytt
binario y haga que sea ejecutable.
gunzip ytt-linux-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-linux-amd64-v0.43.1+vmware.1
Mueva el archivo binario a /usr/local/bin
y cámbiele el nombre a ytt
:
sudo mv ./ytt-linux-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
Ejecute ytt --version
para comprobar que la versión correcta de ytt
esté instalada y sea ejecutable.
ytt --version
Descomprima el archivo binario ytt
.
gunzip ytt-windows-amd64-v0.43.1+vmware.1.gz
Cambie el nombre de ytt-windows-amd64-v0.43.1+vmware.1
a ytt.exe
Program Files\ytt
y copie el archivo ytt.exe
en ella.ytt
, seleccione Propiedades (Properties) > Seguridad (Security) y asegúrese de que su cuenta de usuario tenga el permiso Control completo (Full Control).env
.Path
en Variables del sistema (System variables) y haga clic en Editar (Edit).ytt
.ytt version
para comprobar que la versión correcta de ytt
esté instalada correctamente.kapp
kapp
es la CLI de implementación de aplicaciones para Kubernetes. Permite instalar, actualizar y eliminar varios recursos de Kubernetes como una sola aplicación.
Descomprima el kapp
binario y haga que sea ejecutable.
gunzip kapp-darwin-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-darwin-amd64-v0.53.2+vmware.1
Mueva el archivo binario a /usr/local/bin
y cámbiele el nombre a kapp
:
sudo mv ./kapp-darwin-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
Ejecute kapp --version
para comprobar que la versión correcta de kapp
esté instalada y sea ejecutable.
kapp --version
Descomprima el kapp
binario y haga que sea ejecutable.
gunzip kapp-linux-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-linux-amd64-v0.53.2+vmware.1
Mueva el archivo binario a /usr/local/bin
y cámbiele el nombre a kapp
:
sudo mv ./kapp-linux-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
Ejecute kapp --version
para comprobar que la versión correcta de kapp
esté instalada y sea ejecutable.
kapp --version
Descomprima el archivo binario kapp
.
gunzip kapp-windows-amd64-v0.53.2+vmware.1.gz
Cambie el nombre de kapp-windows-amd64-v0.53.2+vmware.1
a kapp.exe
Program Files\kapp
y copie el archivo kapp.exe
en ella.kapp
, seleccione Propiedades (Properties) > Seguridad (Security) y asegúrese de que su cuenta de usuario tenga el permiso Control completo (Full Control).env
.Path
en Variables del sistema (System variables) y haga clic en Editar (Edit).kapp
.kapp version
para comprobar que la versión correcta de kapp
esté instalada correctamente.kbld
kbld
es una herramienta de creación y resolución de imágenes.
Descomprima el kbld
binario y haga que sea ejecutable.
gunzip kbld-darwin-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-darwin-amd64-v0.35.1+vmware.1
Mueva el archivo binario a /usr/local/bin
y cámbiele el nombre a kbld
:
sudo mv ./kbld-darwin-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
Ejecute kbld --version
para comprobar que la versión correcta de kbld
esté instalada y sea ejecutable.
Descomprima el kbld
binario y haga que sea ejecutable.
gunzip kbld-linux-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-linux-amd64-v0.35.1+vmware.1
Mueva el archivo binario a /usr/local/bin
y cámbiele el nombre a kbld
:
sudo mv ./kbld-linux-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
Ejecute kbld --version
para comprobar que la versión correcta de kbld
esté instalada y sea ejecutable.
kbld --version
Descomprima el archivo binario kbld
.
gunzip kbld-windows-amd64-v0.35.1+vmware.1.gz
Cambie el nombre de kbld-windows-amd64-v0.35.1+vmware.1
a kbld.exe
Program Files\kbld
y copie el archivo kbld.exe
en ella.kbld
, seleccione Propiedades (Properties) > Seguridad (Security) y asegúrese de que su cuenta de usuario tenga el permiso Control completo (Full Control).env
.Path
en Variables del sistema (System variables) y haga clic en Editar (Edit).kbld
.kbld version
para comprobar que la versión correcta de kbld
esté instalada correctamente.imgpkg
imgpkg
es una herramienta que permite a Kubernetes almacenar configuraciones y las imágenes de contenedor asociadas como imágenes de OCI, y transferir estas imágenes. imgpkg
es necesario para implementar Tanzu Kubernetes Grid en entornos restringidos por Internet y al crear sus propias imágenes de máquina. También es necesario al configurar el paquete de Harbor.
Descomprima el imgpkg
binario y haga que sea ejecutable.
gunzip imgpkg-darwin-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-darwin-amd64-v0.31.1+vmware.1
Mueva el archivo binario a /usr/local/bin
y cámbiele el nombre a imgpkg
:
sudo mv ./imgpkg-darwin-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
Ejecute imgpkg --version
para comprobar que la versión correcta de imgpkg
esté instalada y sea ejecutable.
imgpkg --version
Descomprima el imgpkg
binario y haga que sea ejecutable.
gunzip imgpkg-linux-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-linux-amd64-v0.31.1+vmware.1
Mueva el archivo binario a /usr/local/bin
y cámbiele el nombre a imgpkg
:
sudo mv ./imgpkg-linux-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
Ejecute imgpkg --version
para comprobar que la versión correcta de imgpkg
esté instalada y sea ejecutable.
imgpkg --version
Descomprima el archivo binario imgpkg
.
gunzip imgpkg-windows-amd64-v0.31.1+vmware.1.gz
Cambie el nombre de imgpkg-windows-amd64-v0.31.1+vmware.1
a imgpkg.exe
Program Files\imgpkg
y copie el archivo imgpkg.exe
en ella.imgpkg
, seleccione Propiedades (Properties) > Seguridad (Security) y asegúrese de que su cuenta de usuario tenga el permiso Control completo (Full Control).env
.Path
en Variables del sistema (System variables) y haga clic en Editar (Edit).imgpkg
.imgpkg version
para comprobar que la versión correcta de imgpkg
esté instalada correctamente.Para implementar clústeres de administración independientes en el proveedor de nube, siga las instrucciones de Implementar clústeres de administración independientes.