Instalar la CLI de Tanzu y la CLI de Kubernetes para su uso con clústeres de administración independientes

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.

Nota

Las 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.3 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.

Requisitos previos

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.3, necesita una máquina de arranque en la que instalar y ejecutar la CLI de Tanzu que tiene:

  • Un sistema operativo Linux, Windows o macOS que se ejecuta en una máquina física o virtual con el siguiente hardware:
    • Al menos 8 GB de RAM. VMware recomienda 16 GB de RAM.
    • Un disco con 50 GB de almacenamiento disponible.
    • 2 o 4 CPU de 2 núcleos.
  • Un acceso remoto o en navegador desde una máquina con un navegador, si pretende utilizar la interfaz del instalador de Tanzu Kubernetes Grid para implementar clústeres de administración independientes. Puede utilizar la CLI de Tanzu sin navegador, pero para las primeras implementaciones, se recomienda utilizar la interfaz del instalador.
  • La hora del sistema se sincroniza con un servidor de protocolo de tiempo de redes (Network Time Protocol, NTP).

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

    macOS
    Linux
    • Docker instalado y en ejecución en la máquina de arranque. Use 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.
    • Agregue su cuenta de usuario no raíz al grupo de usuarios 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.

    Windows
    • Docker Desktop instalado y en ejecución en la máquina de arranque.
    • Asigne al menos 6 GB de memoria en Docker Desktop para alojar el contenedor 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.


Instalar la CLI de Tanzu

Para instalar la CLI de Tanzu para usarla con Tanzu Kubernetes Grid v2.3, instale una versión compatible de la CLI de Tanzu principal y los complementos de la CLI de Tanzu para Tanzu Kubernetes Grid v2.3. 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.

Instalar la CLI de Tanzu principal

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

Nota

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

Instalar mediante un administrador de paquetes
Para instalar la CLI de Tanzu mediante un administrador de paquetes:

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

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

  3. Compruebe que la versión correcta de la CLI esté instalada correctamente. Por ejemplo:

    tanzu version
version: v1.0.0
...
Instalar desde una versión binaria
Puede descargar el archivo binario de la CLI de Tanzu desde VMware Customer Connect o GitHub. Para obtener una lista de todas las versiones compatibles de la CLI, consulte la matriz de interoperabilidad de productos.

Para descargar una versión binaria de la CLI de Tanzu desde Customer Connect y, a continuación, instalarla:

  1. Descargue e descomprima la imagen binaria de la CLI de Tanzu:

    1. Vaya a la página de la CLI de VMware Tanzu en VMware Customer Connect y, en Descargas de productos (Product Downloads) para la CLI de Tanzu v1.0.0, busque y descargue el archivo binario de la CLI de Tanzu para su sistema operativo.

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

  2. 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:

      1. Cree una nueva carpeta Program Files\tanzu.
      2. Copia el archivo ltanzu-cli-windows_amd64.exe en la nueva carpeta Program Files\tanzu.
      3. Cambie el nombre de tanzu-cli-windows_amd64.exe a tanzu.exe.
      4. Haga clic con el botón secundario en la carpeta tanzu, seleccione Propiedades (Properties) > Seguridad (Security) y asegúrese de que su cuenta de usuario tenga el permiso Control completo (Full Control).
      5. Utilice Windows Search para buscar env.
      6. Seleccione Editar las variables de entorno del sistema (Edit the system environment variables) y haga clic en el botón Variables de entorno (Environment Variables).
      7. Seleccione la fila Path en Variables del sistema (System variables) y haga clic en Editar (Edit).
      8. Haga clic en Nueva (New) para agregar una nueva fila e introduzca la ruta de acceso a la CLI tanzu. El valor de la ruta no debe incluir la extensión .exe. Por ejemplo, C:\Program Files\tanzu.

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

Instalar los complementos de CLI de Tanzu para TKG v2.3

Para instalar los complementos de CLI de Tanzu independientes para Tanzu Kubernetes Grid v2.3:

  1. Enumere los complementos de la CLI de Tanzu independientes para Tanzu Kubernetes Grid v2.3:

    tanzu plugin group get vmware-tkg/default:v2.3.1

    Los resultados son similares al siguiente mensaje:

    Plugins in Group:  vmware-tkg/tkg:v2.3.1
NAME                TARGET      VERSION
isolated-cluster    global      v0.30.2
management-cluster  kubernetes  v0.30.2
package             kubernetes  v0.30.2
pinniped-auth       global      v0.30.2
secret              kubernetes  v0.30.2
telemetry           kubernetes  v0.30.2

    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

  2. Instale los complementos independientes para Tanzu Kubernetes Grid v2.3:

    tanzu plugin install --group vmware-tkg/default:v2.3.1

  3. 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.3.1 debe incluirse en el resultado de tanzu plugin list.

    Nota

    Despué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 y tanzu 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.

Instalar la CLI de Kubernetes

Descargue y descomprima la CLI de Kubernetes, kubectl, en el equipo de arranque y, a continuación, póntela a disposición del sistema:

  1. Vaya a VMware Customer Connect e inicie sesión con las credenciales de VMware Customer Connect.

  2. Vaya a Descargas de productos de Tanzu Kubernetes Grid v2.3.1.

  3. Desplácese hasta la sección denominada Kubectl 1.26.8 para VMware Tanzu Kubernetes Grid 2.3.1.

    macOS
    Busque kubectl cli v1.26.8 para Mac (kubectl cli v1.26.8 for Mac) y haga clic en Descargar ahora (Download Now).
    Linux
    Busque kubectl cli v1.26.8 para Linux (kubectl cli v1.26.8 for Linux) y haga clic en Descargar ahora (Download Now).
    Windows
    Busque kubectl cli v1.26.8 para Windows (kubectl cli v1.26.8 for Windows) y haga clic en Descargar ahora (Download Now).

  4. (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.

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

    macOS 
    gunzip kubectl-mac-v1.26.8+vmware.2.gz
    Linux 
    gunzip kubectl-linux-v1.26.8+vmware.2.gz
    Windows
    Utilice la herramienta de extractor de Windows para descomprimir kubectl-windows-v1.26.8+vmware.2.exe.gz.

  6. Haga que la CLI esté disponible para el sistema:

    macOS

    1. Haga que el archivo descargado sea ejecutable:

      chmod ugo+x kubectl-mac-v1.26.8+vmware.2

    2. Instale el archivo binario en /usr/local/bin:

      sudo install kubectl-mac-v1.26.8+vmware.2 /usr/local/bin/kubectl

    3. Ejecute kubectl version para comprobar que la versión correcta de kubectl esté instalada y sea ejecutable.

      kubectl version
    Linux

    1. Haga que el archivo descargado sea ejecutable:

      chmod ugo+x kubectl-linux-v1.26.8+vmware.2

    2. Instale el archivo binario en /usr/local/bin:

      sudo install kubectl-linux-v1.26.8+vmware.2 /usr/local/bin/kubectl

    3. Ejecute kubectl version para comprobar que la versión correcta de kubectl esté instalada y sea ejecutable.

      kubectl version
    Windows
    1. Cree una nueva carpeta Program Files\kubectl.
    2. Busque y copie el archivo kubectl-windows-v1.26.8+vmware.2.exe en la nueva carpeta Program Files\kubectl.
    3. Cambie el nombre de kubectl-windows-v1.26.8+vmware.2.exe a kubectl.exe.
    4. Haga clic con el botón secundario en la carpeta kubectl, seleccione Propiedades (Properties) > Seguridad (Security) y asegúrese de que su cuenta de usuario tenga el permiso Control completo (Full Control).
    5. Utilice Windows Search para buscar env.
    6. Seleccione Editar las variables de entorno del sistema (Edit the system environment variables) y haga clic en el botón Variables de entorno (Environment Variables).
    7. Seleccione la fila Path en Variables del sistema (System variables) y haga clic en Editar (Edit).
    8. Haga clic en Nueva (New) para agregar una nueva fila e introduzca la ruta de acceso a la CLI kubectl.

    9. Ejecute kubectl version para comprobar que la versión correcta de la CLI esté instalada correctamente.

      kubectl version

Qué hacer a continuación

Para implementar clústeres de administración independientes en el proveedor de nube, siga las instrucciones de Implementar clústeres de administración independientes.

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