Instalar la CLI de Tanzu y otras herramientas para usarlas con un supervisor de vSphere with Tanzu

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 utiliza el supervisor de vSphere with Tanzu en vSphere 8 como clúster de administración, después de instalar la CLI de Tanzu, puede conectarla al supervisor.

Nota

Las instrucciones de este tema son específicas para instalar la CLI de Tanzu para usarla con un supervisor de vSphere with Tanzu en vSphere 8. Si va a instalar la CLI de Tanzu para implementar clústeres de administración independientes en vSphere sin supervisor, o en AWS o Azure, consulte el tema correspondiente en Implementar y administrar clústeres de administración independientes de Tanzu Kubernetes Grid 2.1, Instalar la CLI de Tanzu y otras herramientas para su uso con clústeres de administración independientes.

La CLI de Tanzu se comunica con el supervisor para crear y administrar clústeres de carga de trabajo en vSphere with Tanzu.

Tanzu Kubernetes Grid v2.x y supervisor de vSphere with Tanzu en vSphere 8

Importante

El supervisor de vSphere with Tanzu en vSphere 8.0.1c y versiones posteriores ejecuta TKG v2.2. Las versiones anteriores de vSphere 8 ejecutan TKG v2.0, que no se publicó independientemente del supervisor. Los clústeres de administración independientes que ejecutan TKG 2.x están disponibles a partir de TKG 2.1. Las versiones posteriores de TKG se integrarán en Supervisor en futuras versiones de actualización de vSphere. En consecuencia, es posible que la versión de TKG integrada en la versión de vSphere with Tanzu más reciente en un momento determinado no sea la misma que la versión independiente de TKG que utiliza. Sin embargo, las versiones de la CLI de Tanzu que son compatibles con todas las versiones de TKG v2.x son totalmente compatibles con Supervisor en todas las versiones de vSphere 8.

Tanzu Kubernetes Grid v2.1 y vSphere with Tanzu en vSphere 7

Precaución

Las versiones de CLI de Tanzu que son compatibles con TKG 2.x y con el supervisor vSphere with Tanzu en vSphere 8 no son compatibles con el clúster supervisor en vSphere 7. Para utilizar la CLI de Tanzu con un clúster supervisor vSphere with Tanzu en vSphere 7, utilice la versión CLI de Tanzu de TKG v1.6. Para utilizar las versiones de la CLI de Tanzu que son compatibles con TKG 2.x con Supervisor, actualice a vSphere 8. Puede implementar un clúster de administración de TKG 2.x independiente en vSphere 7 si no hay un clúster supervisor vSphere with Tanzu. Para obtener información sobre la compatibilidad entre los productos de CLI de Tanzu y VMware, consulte la documentación de CLI de 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.

Requisitos previos

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:

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

Para utilizar un clúster supervisor como el clúster de administración, también necesita:

Descargue e instale la CLI de Tanzu

Descargue los archivos de la versión compatible de la CLI de Tanzu desde la página de descargas de Tanzu Kubernetes Grid.

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

  2. Visite la página de descargas de Tanzu Kubernetes Grid.

  3. En la fila VMware Tanzu Kubernetes Grid, haga clic en Ir a descargas (Go to Downloads).

  4. En el menú desplegable Seleccionar versión (Select Version), seleccione 2.1.1.

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

    macOS
    Busque VMware CLI de Tanzu para Mac (VMware CLI de Tanzu for Mac) y haga clic en Descargar ahora (Download Now).
    Linux
    Busque VMware CLI de Tanzu para Linux (VMware CLI de Tanzu for Linux) y haga clic en Descargar ahora (Download Now).
    Windows
    Busque VMware CLI de Tanzu para Windows (VMware CLI de Tanzu for Windows) y haga clic en Descargar ahora (Download Now).
  6. (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.

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

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

    macOS
    tar -xvf tanzu-cli-bundle-darwin-amd64.tar.gz
    
    Linux
    tar -xvf tanzu-cli-bundle-linux-amd64.tar.gz
    
    Windows
    Utilice la herramienta de extractor de Windows para descomprimir 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.

Inicializar la CLI de Tanzu

Después de descargar y desempaquetar la CLI de Tanzu en el equipo de arranque, debe ponerlo a disposición del sistema.

  1. Desplácese hasta la subcarpeta cli en la carpeta tanzu que desempaquetó en la sección anterior.

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

    macOS
    Instale el archivo binario en /usr/local/bin:
    sudo install core/v0.28.1/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
    
    Linux
    Instale el archivo binario en /usr/local/bin:
    sudo install core/v0.28.1/tanzu-core-linux_amd64 /usr/local/bin/tanzu
    
    Windows
    1. Cree una nueva carpeta Program Files\tanzu.
    2. En la carpeta cli desempaquetada, busque y copie el archivo core\v0.28.1\tanzu-core-windows_amd64.exe en la nueva carpeta Program Files\tanzu.
    3. Cambie el nombre de tanzu-core-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.
  3. En la línea de comandos de un terminal nuevo, inicialice la CLI de Tanzu:

    tanzu init
    
  4. 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).

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

    1. Desinstale los complementos existentes:

      tanzu plugin clean
      
    2. Instale todos los complementos para esta versión:

      tanzu plugin sync
      
    3. Compruebe el estado de instalación y la versión del complemento:

      tanzu plugin list
      
Nota

Despué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 y tanzu kubernetes-release, no están disponibles y no se incluyen en los resultados de --help de la CLI de Tanzu.

Instalar la CLI de Kubernetes

Descargue y desempaquete 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. Visite la página de descargas de Tanzu Kubernetes Grid.

  3. En la fila VMware Tanzu Kubernetes Grid, haga clic en Ir a descargas (Go to Downloads).

  4. En el menú desplegable Seleccionar versión (Select Version), seleccione 2.1.1.

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

    macOS
    Busque kubectl cli v1.24.10 para Mac (kubectl cli v1.24.10 for Mac) y haga clic en Descargar ahora (Download Now).
    Linux
    Busque kubectl cli v1.24.10 para Linux (kubectl cli v1.24.10 for Linux) y haga clic en Descargar ahora (Download Now).
    Windows
    Busque kubectl cli v1.24.10 para Windows (kubectl cli v1.24.10 for Windows) y haga clic en Descargar ahora (Download Now).
  6. (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.

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

    macOS
    gunzip kubectl-mac-v1.24.10+vmware.1.gz
    
    Linux
    gunzip kubectl-linux-v1.24.10+vmware.1.gz
    
    Windows
    Utilice la herramienta de extractor de Windows para descomprimir kubectl-windows-v1.24.10+vmware.1.exe.gz.
  8. Haga que la CLI esté disponible para el sistema:

    macOS
    1. Haga que el archivo descargado sea ejecutable:

      chmod ugo+x kubectl-mac-v1.24.10+vmware.1
      
    2. Instale el archivo binario en /usr/local/bin:

      sudo install kubectl-mac-v1.24.10+vmware.1 /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.24.10+vmware.1
      
    2. Instale el archivo binario en /usr/local/bin:

      sudo install kubectl-linux-v1.24.10+vmware.1 /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.24.10+vmware.1.exe en la nueva carpeta Program Files\kubectl.
    3. Cambie el nombre de kubectl-windows-v1.24.10+vmware.1.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.

Ayuda de CLI de Tanzu

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.

Instalar Carvel Tools

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.

Buscar herramientas Carvel

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

  2. Abra la carpeta cli.

    cd cli
    

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

macOS
  1. 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
    
  2. 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
    
  3. Ejecute ytt --version para comprobar que la versión correcta de ytt esté instalada y sea ejecutable.

    ytt --version
    
Linux
  1. 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
    
  2. 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
    
  3. Ejecute ytt --version para comprobar que la versión correcta de ytt esté instalada y sea ejecutable.

    ytt --version
    
Windows
  1. Descomprima el archivo binario ytt.

    gunzip ytt-windows-amd64-v0.43.1+vmware.1.gz
    
  2. Cambie el nombre de ytt-windows-amd64-v0.43.1+vmware.1 a ytt.exe

  3. Cree una nueva carpeta Program Files\ytt y copie el archivo ytt.exe en ella.
  4. Haga clic con el botón secundario en la carpeta ytt, 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 herramienta ytt.
  9. En la línea de comandos de un terminal nuevo, ejecute ytt version para comprobar que la versión correcta de ytt esté instalada correctamente.


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

macOS
  1. 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
    
  2. 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
    
  3. Ejecute kapp --version para comprobar que la versión correcta de kapp esté instalada y sea ejecutable.

    kapp --version
    
Linux
  1. 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
    
  2. 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
    
  3. Ejecute kapp --version para comprobar que la versión correcta de kapp esté instalada y sea ejecutable.

    kapp --version
    
Windows
  1. Descomprima el archivo binario kapp.

    gunzip kapp-windows-amd64-v0.53.2+vmware.1.gz
    
  2. Cambie el nombre de kapp-windows-amd64-v0.53.2+vmware.1 a kapp.exe

  3. Cree una nueva carpeta Program Files\kapp y copie el archivo kapp.exe en ella.
  4. Haga clic con el botón secundario en la carpeta kapp, 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 herramienta kapp.
  9. En la línea de comandos de un terminal nuevo, ejecute kapp version para comprobar que la versión correcta de kapp esté instalada correctamente.


Instale kbld

kbld es una herramienta de creación y resolución de imágenes.

macOS
  1. 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
    
  2. 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
    
  3. Ejecute kbld --version para comprobar que la versión correcta de kbld esté instalada y sea ejecutable.

Linux
  1. 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
    
  2. 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
    
  3. Ejecute kbld --version para comprobar que la versión correcta de kbld esté instalada y sea ejecutable.

    kbld --version
    
Windows
  1. Descomprima el archivo binario kbld.

    gunzip kbld-windows-amd64-v0.35.1+vmware.1.gz
    
  2. Cambie el nombre de kbld-windows-amd64-v0.35.1+vmware.1 a kbld.exe

  3. Cree una nueva carpeta Program Files\kbld y copie el archivo kbld.exe en ella.
  4. Haga clic con el botón secundario en la carpeta kbld, 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 herramienta kbld.
  9. En la línea de comandos de un terminal nuevo, ejecute kbld version para comprobar que la versión correcta de kbld esté instalada correctamente.


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

macOS
  1. 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
    
  2. 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
    
  3. Ejecute imgpkg --version para comprobar que la versión correcta de imgpkg esté instalada y sea ejecutable.

    imgpkg --version
    
Linux
  1. 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
    
  2. 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
    
  3. Ejecute imgpkg --version para comprobar que la versión correcta de imgpkg esté instalada y sea ejecutable.

    imgpkg --version
    
Windows
  1. Descomprima el archivo binario imgpkg.

    gunzip imgpkg-windows-amd64-v0.31.1+vmware.1.gz
    
  2. Cambie el nombre de imgpkg-windows-amd64-v0.31.1+vmware.1 a imgpkg.exe

  3. Cree una nueva carpeta Program Files\imgpkg y copie el archivo imgpkg.exe en ella.
  4. Haga clic con el botón secundario en la carpeta imgpkg, 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 herramienta imgpkg.
  9. En la línea de comandos de un terminal nuevo, ejecute imgpkg version para comprobar que la versión correcta de imgpkg esté instalada correctamente.


Qué hacer a continuación

Antes de poder utilizar la CLI de Tanzu, kubectl, y las herramientas Carvel para implementar clústeres de carga de trabajo y paquetes de servicios en Tanzu Kubernetes Grid, Conectar la CLI de Tanzu al supervisor como se describe a continuación.

Conectar la CLI de Tanzu al supervisor

Para registrar el supervisor en la CLI de Tanzu e iniciar sesión en Supervisor, haga lo siguiente. Debe registrar el supervisor en la CLI de Tanzu solo una vez. Después de registrar el supervisor, puede ir al paso tanzu login.

  1. Obtenga la dirección IP del supervisor de vCenter:

    1. En la vista Hosts y clústeres (Hosts and Clusters), seleccione el centro de datos que aloja al supervisor.
    2. En Espacios de nombres (Namespaces), seleccione el espacio de nombres que contiene o adyacente a las tres instancias de SupervisorControlPlaneVM.
    3. En el panel principal, en Resumen (Summary) > Estado (Status) > Enlace a herramientas de la CLI (Link to CLI Tools), haga clic en Copiar enlace (Copy link) y registre la URL, por ejemplo, https://192.168.123.3.
  2. Sin IDP: Si no utiliza un proveedor de identidad externo:

    1. (Opcional) Instale y configure el complemento kubectl vsphere con un certificado de confianza como se describe en Configurar el inicio de sesión seguro para los clústeres de vSphere with Tanzu.

    2. Ejecute kubectl vsphere login para iniciar sesión en vSphere. Para obtener más información sobre este paso, consulte Conectar a Supervisor como usuario de vCenter Single Sign-On con Kubectl.

      kubectl vsphere login --vsphere-username VSPHERE-USERNAME --server=SUPERVISOR-IP
      

      Donde VSPHERE-USERNAME es el nombre de usuario de la cuenta de vCenter Single Sign-On (SSO), por ejemplo [email protected], y SUPERVISOR-IP es la dirección IP de supervisor obtenida anteriormente.

      Si no configuró el complemento kubectl vsphere con un certificado de confianza, puede iniciar sesión de forma no segura anexando --insecure-skip-tls-verify=true al comando anterior.

      Precaución

      Utilice solo inicios de sesión no seguros en un entorno de desarrollo.

    3. Introduzca la contraseña que utiliza para iniciar sesión en vCenter.

      Cuando inicie sesión correctamente, el comando kubectl vsphere login:

      • Crea o modifica el archivo kubeconfig local para agregar un token que se autentique con la API de Kubernetes
      • Enumera todos los contextos de Kubernetes a los que tiene acceso. Esta lista debe incluir la dirección IP de supervisor.
    4. Establezca el contexto de kubectl al supervisor.

      kubectl config use-context SUPERVISOR-IP
      

      Donde SUPERVISOR-IP es el contexto del supervisor, consulte Obtener y utilizar el contexto de supervisor en Servicios y cargas de trabajo de vSphere with Tanzu.

  3. Recopile información para ejecutar el comando tanzu login, que se conecta al supervisor:

    • Decida un nombre para que la CLI de tanzu lo use para el Supervisor.
    • La ruta de acceso al archivo local kubeconfig, que se establece de forma predeterminada en ~/.kube/config y se establece mediante la variable de entorno KUBECONFIG.
  4. Ejecute el comando tanzu login pasando los valores anteriores, por ejemplo:

    Sin IDP:

    tanzu login --name my-supervisor --kubeconfig ~/.kube/config --context 192.168.123.3
    

    Después de iniciar sesión, la CLI descarga los complementos específicos de Supervisor.

    ???  successfully logged in to management cluster using the kubeconfig my-supervisor
    Checking for required plugins...
    Installing plugin 'cluster:v0.25' with target 'kubernetes'
    Installing plugin 'feature:v0.25' with target 'kubernetes'
    Installing plugin 'kubernetes-release:v0.25' with target 'kubernetes'
    Installing plugin 'namespaces:v1.0.0' with target 'kubernetes'
    Successfully installed all required plugins
    

    Con un IDP:

    tanzu login --endpoint https://10.73.27.32 --name oidc-user
    
    Detected a vSphere Supervisor being used
    Log in by visiting this link:
    ...
    https://10.27.62.33/wcp/pinniped/oauth2/authorize?..
    ...
    Optionally, paste your authorization code: G2TcS145Q4e6A1YKf743n3BJlfQAQ_UdjXy38TtEEIo.ju4QV3PTsUvOigVUtQllZ7AJFU0YnjuLHTRVoNxvdZc
    ...
    ??? successfully logged in to management cluster using the kubeconfig oidc-user
    Checking for required plugins...
    All required plugins are already installed and up-to-date
    

    En el ejemplo anterior, https://10.73.27.32 es la dirección IP del plano de control del Supervisor. Para obtener más información sobre este paso, consulte Conectar al Supervisor mediante la CLI de Tanzu y un IDP externo.

  5. Compruebe que el supervisor se agregó ejecutando tanzu config server list, por ejemplo:

    tanzu config server list
    
    NAME           TYPE               ENDPOINT                   PATH                       CONTEXT
    my-supervisor  managementcluster  https://192.168.123.3:443  /home/vmware/.kube/config  192.168.123.3
    

    tanzu login ahora debería enumerar al supervisor por el nombre que proporcionó:

    tanzu login
    
    ? Select a server  [Use arrows to move, type to filter]
    > my-supervisor  ()
     + new server
    
  6. Ejecute tanzu plugin list para ver la lista de complementos específicos de supervisor, así como los complementos principales de la CLI.

    tanzu plugin list
    
    Standalone Plugins
      NAME                DESCRIPTION                                                        TARGET      DISCOVERY  VERSION   STATUS
      isolated-cluster    isolated-cluster operations                                                    default    v0.28.1   installed
      login               Login to the platform                                                          default    v0.28.1   installed
      pinniped-auth       Pinniped authentication operations (usually not directly invoked)              default    v0.28.1   installed
      management-cluster  Kubernetes management-cluster operations                           kubernetes  default    v0.28.1   installed
      package             Tanzu package management                                           kubernetes  default    v0.28.1   installed
      secret              Tanzu secret management                                            kubernetes  default    v0.28.1   installed
      telemetry           Configure cluster-wide telemetry settings                          kubernetes  default    v0.28.1   installed
    
    Plugins from Context:  my-supervisor
      NAME                DESCRIPTION                                                TARGET      VERSION  STATUS
      cluster             Kubernetes cluster operations                              kubernetes  v0.25.0  installed
      feature             Operate on features and featuregates                       kubernetes  v0.25.0  installed
      kubernetes-release  Kubernetes release operations                              kubernetes  v0.25.0  installed
      namespaces          Discover vSphere Supervisor namespaces you have access to  kubernetes  v1.0.0   installed
    
    Nota

    En el ejemplo anterior, los complementos independientes, por ejemplo, login y pinniped-auth, que se instalaron al instalar CLI de Tanzu, tienen la versión v0.28.1. Los complementos del contexto del supervisor que se instalaron al conectar la CLI de Tanzu al supervisor (por ejemplo, cluster o kubernetes-release), se encuentran en la v0.25.0. Esto se debe a que el supervisor de vSphere with Tanzu ejecuta TKG 2.0 en lugar de TKG 2.1. Sin embargo, los complementos de la v0.25.0 son totalmente compatibles con la v0.28.1 de CLI de Tanzu y los complementos independientes.

  7. (Opcional) Continúe con Crear clústeres de carga de trabajo.
check-circle-line exclamation-circle-line close-line
Scroll to top icon