En este tema se explica cómo instalar 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. 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 v1.0.x.
Para implementar Tanzu Kubernetes Grid en vSphere sin un supervisor, en AWS o en Azure, use la CLI de Tanzu para crear un clúster de administración independiente en cada proveedor de nube en su entorno. 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, 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.4 con la CLI de Tanzu, Instalar la CLI de Tanzu y la CLI de Kubernetes para su uso con un supervisor de vSphere with Tanzu.
La máquina de arranque en la que instala y ejecuta la CLI de Tanzu para su uso con Tanzu Kubernetes Grid 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.4, 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 un administrador de paquetes. 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 ejecuta Ubuntu 22.04, asegúrese de que el filtrado de rutas inversas esté desactivado. Para desactivar el filtrado inverso de rutas de acceso, agregue el siguiente reemplazo:
# New file /etc/sysctl.d/90-override.conf
ipv4.conf.all.rp_filter = 0
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 modprobe 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.
Para instalar la CLI de Tanzu para usarla con Tanzu Kubernetes Grid v2.4, instale una versión compatible de la CLI de Tanzu principal y los complementos de la CLI de Tanzu para Tanzu Kubernetes Grid v2.4. Los comandos proporcionados por estos complementos habilitan las operaciones de clúster y paquete. Para obtener una lista de las versiones compatibles de la CLI, consulte la matriz de interoperabilidad de productos.
Para instalar la CLI de Tanzu principal, siga los pasos que se indican a continuación; para ver los pasos, haga clic en la pestaña Instalar mediante un administrador de paquetes o Instalar desde una versión binaria.
Después de instalar la CLI de Tanzu principal, continúe con Instalar los complementos de la CLI de Tanzu para TKG v2.4.
NotaSi desea conservar una instalación existente de la CLI de Tanzu, mueva el archivo binario de la CLI de
/usr/local/bin/tanzu
a una ubicación diferente antes de seguir los pasos que se indican a continuación.
Elija una versión compatible de la CLI de Tanzu. Para obtener una lista de las versiones de la CLI compatibles con esta versión de Tanzu Kubernetes Grid, consulte la matriz de interoperabilidad de productos.
Siga las instrucciones para el administrador de paquetes a continuación.
APT (Debian o Ubuntu):
Si la versión de que desea instalar es la versión más reciente disponible de la CLI de Tanzu, por ejemplo, v1.0.0
, ejecute:
sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install -y tanzu-cli
Si desea instalar una versión anterior de la CLI de Tanzu, por ejemplo, v0.90.1
, ejecute:
sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install tanzu-cli=0.90.1
Chocolatey (Windows):
Si la versión de que desea instalar es la versión más reciente disponible de la CLI de Tanzu, por ejemplo, v1.0.0
, ejecute:
choco install tanzu-cli
Si desea instalar una versión anterior de la CLI de Tanzu, por ejemplo, v0.90.1
, ejecute:
choco install tanzu-cli --version 0.90.1
Homebrew (MacOS):
Si la versión de que desea instalar es la versión más reciente disponible de la CLI de Tanzu, por ejemplo, v1.0.0
, ejecute:
brew update
brew install vmware-tanzu/tanzu/tanzu-cli
Si desea instalar una versión anterior de la CLI de Tanzu, por ejemplo, v0.90.1
, ejecute:
brew update
brew tap-new local/tap
brew extract --version=0.90.1 vmware-tanzu/tanzu/tanzu-cli local/tap
brew install [email protected]
YUM o DNF (RHEL):
Si la versión de que desea instalar es la versión más reciente disponible de la CLI de Tanzu, por ejemplo, v1.0.0
, ejecute:
cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF
sudo yum install -y tanzu-cli # If you are using DNF, run sudo dnf install -y tanzu-cli.
Si desea instalar una versión anterior de la CLI de Tanzu, por ejemplo, v0.90.1
, ejecute:
cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF
sudo yum install tanzu-cli-0.90.1 # If you are using DNF, run sudo dnf install tanzu-cli-0.90.1.
Compruebe que la versión correcta de la CLI esté instalada correctamente. Por ejemplo:
tanzu version
version: v1.0.0
...
Para descargar una versión binaria de la CLI de Tanzu desde Customer Connect y, a continuación, instalarla:
Descargue e descomprima la imagen binaria de la CLI de Tanzu:
Descomprima el archivo CLI de Tanzu para el sistema operativo. Para desempaquetar el archivo, utilice la herramienta de extracción que desee. Por ejemplo, en Linux o macOS, puede usar el comando tar
.
macOS:
tar -xvf tanzu-cli-darwin-amd64.tar.gz
Linux:
tar -xvf tanzu-cli-linux-amd64.tar.gz
Windows:
Utilice la herramienta de extractor de Windows para descomprimir tanzu-cli-windows-amd64.zip
.
Haga que la CLI esté disponible para el sistema:
macOS:
Instale el archivo binario en /usr/local/bin
:
install tanzu-cli-darwin_amd64 /usr/local/bin/tanzu
Linux:
Instale el archivo binario en /usr/local/bin
:
sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
Windows:
Program Files\tanzu
.tanzu-cli-windows_amd64.exe
en la nueva carpeta Program Files\tanzu
.tanzu-cli-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
. El valor de la ruta no debe incluir la extensión .exe
. Por ejemplo, C:\Program Files\tanzu
.Compruebe que la versión correcta de la CLI esté instalada correctamente. Por ejemplo:
tanzu version
version: v1.0.0
...
Para descargar e instalar la CLI de Tanzu desde una versión binaria en GitHub, siga las instrucciones de la sección Desde versiones binarias en el proyecto de GitHub de Instalar la CLI de Tanzu.
Para instalar los complementos de CLI de Tanzu independientes para Tanzu Kubernetes Grid v2.4:
Enumere los complementos de la CLI de Tanzu independientes para Tanzu Kubernetes Grid v2.4:
tanzu plugin group get vmware-tkg/default:v2.4.0
Los resultados son similares al siguiente mensaje:
Plugins in Group: vmware-tkg/default:v2.4.0
NAME TARGET VERSION
isolated-cluster global v0.31.0
management-cluster kubernetes v0.31.0
package kubernetes v0.31.0
pinniped-auth global v0.31.0
secret kubernetes v0.31.0
telemetry kubernetes v0.31.0
Para ver una lista de todas las versiones disponibles para el grupo de complementos vmware-tkg/default
, ejecute:
tanzu plugin group search -n vmware-tkg/default --show-details
Instale los complementos independientes para Tanzu Kubernetes Grid v2.4:
tanzu plugin install --group vmware-tkg/default:v2.4.0
Compruebe que los complementos se instalaron correctamente:
tanzu plugin list
Cada nombre y versión de complemento devueltos por tanzu plugin group get vmware-tkg/default:v2.4.0
debe incluirse en el resultado de tanzu plugin list
.
NotaDespués de haber instalado la CLI de Tanzu y los complementos independientes para Tanzu Kubernetes Grid, pero antes de usarlo para conectarse a 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 están incluidos en los resultados de--help
de la CLI de Tanzu. La CLI de Tanzu instala automáticamente complementos de ámbito de contexto cuando se conecta a un clúster de administración. Para obtener más información sobre los complementos de la CLI de Tanzu y cómo instalarlos, consulte Instalar complementos de la CLI de Tanzu.
Descargue y descomprima 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.4.0.
En Descargas de productos (Product Downloads), desplácese hasta la sección denominada Kubectl 1.27.5 para VMware Tanzu Kubernetes Grid 2.4.0.
(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.
Para descomprimir la imagen binaria kubectl
para su sistema operativo, utilice la herramienta de extracción de su elección. Por ejemplo, el comando gunzip
.
gunzip kubectl-mac-v1.27.5+vmware.1.gz
gunzip kubectl-linux-v1.27.5+vmware.1.gz
kubectl-windows-v1.27.5+vmware.2.exe.gz
.
Haga que la CLI esté disponible para el sistema:
Haga que el archivo descargado sea ejecutable:
chmod ugo+x kubectl-mac-v1.27.5+vmware.1
Instale el archivo binario en /usr/local/bin
:
sudo install kubectl-mac-v1.27.5+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.27.5+vmware.1
Instale el archivo binario en /usr/local/bin
:
sudo install kubectl-linux-v1.27.5+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.27.5+vmware.1.exe
en la nueva carpeta Program Files\kubectl
.kubectl-windows-v1.27.5+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.
kubectl version
Para implementar clústeres de administración independientes en el proveedor de nube, siga las instrucciones de Implementar clústeres de administración independientes.