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.
La CLI de Tanzu se comunica con el supervisor para crear y administrar clústeres de carga de trabajo en 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.
Para ejecutar la CLI de Tanzu con Tanzu Kubernetes Grid 2, necesita:
Una máquina de arranque para ejecutar la CLI de Tanzu que tiene:
Una cuenta de vSphere 8 con:
Una de las siguientes:
kubectl vsphere instalado en la máquina de arranque, como se describe en Descargar e instalar las herramientas de la CLI de Kubernetes para vSphere.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 https://my.vmware.com e inicie sesión con las credenciales de My VMware.
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 1.6.
En Descargas de productos (Product Downloads), desplácese hasta la sección con la etiqueta VMware Tanzu CLI 1.6 CLI.
(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, el comando gunzip.
tanzu-cli-bundle-darwin-amd64.tar.gz.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:
Para obtener macOS:
Instale el archivo binario en /usr/local/bin:
sudo install core/v0.25.0/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
Ejecute tanzu version para comprobar que la versión correcta de tanzu esté instalada y sea ejecutable.
Para Linux:
Instale el archivo binario en /usr/local/bin:
sudo install core/v0.25.0/tanzu-core-linux_amd64 /usr/local/bin/tanzu
Ejecute tanzu version para comprobar que la versión correcta de tanzu esté instalada y sea ejecutable.
Para Windows:
Program Files\tanzu.cli desempaquetada, busque y copie el archivo core\v0.25.0\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 utiliza Tanzu CLI v1.6, que se encuentra en Tanzu Framework v0.25.0:
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).
Después de instalar el tanzu ejecutable principal, debe instalar los complementos de la CLI que habilitan las operaciones de paquete y clúster de carga de trabajo.
(Opcional) Elimine los complementos existentes de cualquier instalación de la CLI anterior.
tanzu plugin clean
Desplácese hasta la carpeta tanzu que contiene la carpeta cli.
Ejecute el siguiente comando desde el directorio tanzu para instalar todos los complementos de esta versión.
tanzu plugin sync
Compruebe el estado de instalación del complemento.
tanzu plugin list
Si se realiza correctamente, debería ver una lista de todos los complementos instalados. Por ejemplo:
NAME DESCRIPTION SCOPE DISCOVERY VERSION STATUS
login Login to the platform Standalone default v0.25.0 installed
management-cluster Kubernetes management-cluster operations Standalone default v0.25.0 installed
package Tanzu package management Standalone default v0.25.0 installed
pinniped-auth Pinniped authentication operations (usually not directly invoked) Standalone default v0.25.0 installed
secret Tanzu secret management Standalone default v0.25.0 installed
telemetry Configure cluster-wide settings for VMware Tanzu telemetry Standalone default v0.25.0 installed
Nota: Después de instalar la CLI de v1.6, pero antes de utilizarla para iniciar sesión en un supervisor, todos los grupos de comandos de la CLI específicos del contexto (clúster de tanzu cluster, tanzu 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 https://my.vmware.com e inicie sesión con las credenciales de My VMware.
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 1.6.
En Descargas de productos (Product Downloads), desplácese hasta la sección denominada Kubectl 1.23.8 para VMware Tanzu Kubernetes Grid 1.6.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.
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.
kubectl-mac-v1.23.8+vmware.1.gz.kubectl-linux-v1.23.8+vmware.1.gz.kubectl-windows-v1.23.8+vmware.1.exe.gz.Haga que la CLI esté disponible para el sistema:
Para obtener macOS:
Instale el archivo binario en /usr/local/bin:
chmod ugo+x kubectl-mac-v1.23.8+vmware.1
sudo install kubectl-mac-v1.23.8+vmware.1 /usr/local/bin/kubectl
Ejecute kubectl version para comprobar que la versión correcta de kubectl esté instalada y sea ejecutable.
Para Linux:
Instale el archivo binario en /usr/local/bin:
chmod ugo+x kubectl-linux-v1.23.8+vmware.1
sudo install kubectl-linux-v1.23.8+vmware.1 /usr/local/bin/kubectl
Ejecute kubectl version para comprobar que la versión correcta de kubectl esté instalada y sea ejecutable.
Para Windows:
Program Files\kubectl.kubectl-windows-v1.23.8+vmware.1.exe en la nueva carpeta Program Files\kubectl.kubectl-windows-v1.23.8+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 Tanzu CLI Command Reference.
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 utiliza las siguientes herramientas del proyecto de código abierto Carvel:
ytt : 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.kapp : la CLI de implementación de aplicaciones para Kubernetes. Permite instalar, actualizar y eliminar varios recursos de Kubernetes como una sola aplicación.kbld : una herramienta de creación y resolución de imágenes.imgpkg : 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.Tanzu Kubernetes Grid proporciona archivos binarios firmados para ytt, kapp, kbld, imgpkg y vendir 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
yttTanzu 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 y Linux:
Descomprima el ytt binario y haga que sea ejecutable.
Linux:
gunzip ytt-linux-amd64-v0.41.1+vmware.1.gz
chmod ugo+x ytt-linux-amd64-v0.41.1+vmware.1
Mac OS:
gunzip ytt-darwin-amd64-v0.41.1+vmware.1.gz
chmod ugo+x ytt-darwin-amd64-v0.41.1+vmware.1
Mueva el archivo binario a /usr/local/bin y cámbiele el nombre a ytt:
Linux:
mv ./ytt-linux-amd64-v0.41.1+vmware.1 /usr/local/bin/ytt
Mac OS:
mv ./ytt-darwin-amd64-v0.41.1+vmware.1 /usr/local/bin/ytt
Ejecute ytt --version para comprobar que la versión correcta de ytt esté instalada y sea ejecutable.
Windows:
Descomprima el archivo binario ytt.
gunzip ytt-windows-amd64-v0.41.1+vmware.1.gz
Cambie el nombre de ytt-windows-amd64-v0.41.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.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.
kappPara instalar kapp:
MacOS y Linux:
Descomprima el kapp binario y haga que sea ejecutable.
Linux:
gunzip kapp-linux-amd64-v0.49.0+vmware.2.gz
chmod ugo+x kapp-linux-amd64-v0.49.0+vmware.2
Mac OS:
gunzip kapp-darwin-amd64-v0.49.0+vmware.2.gz
chmod ugo+x kapp-darwin-amd64-v0.49.0+vmware.2
Mueva el archivo binario a /usr/local/bin y cámbiele el nombre a kapp:
Linux:
mv ./kapp-linux-amd64-v0.49.0+vmware.2 /usr/local/bin/kapp
Mac OS:
mv ./kapp-darwin-amd64-v0.49.0+vmware.2 /usr/local/bin/kapp
Ejecute kapp --version para comprobar que la versión correcta de kapp esté instalada y sea ejecutable.
Windows:
Descomprima el archivo binario kapp.
gunzip kapp-windows-amd64-v0.49.0+vmware.2.gz
Cambie el nombre de kapp-windows-amd64-v0.49.0+vmware.2 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.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.
kbldPara instalar kbld:
MacOS y Linux:
Descomprima el kbld binario y haga que sea ejecutable.
Linux:
gunzip kbld-linux-amd64-v0.34.0+vmware.1.gz
chmod ugo+x kbld-linux-amd64-v0.34.0+vmware.1
Mac OS:
gunzip kbld-darwin-amd64-v0.34.0+vmware.1.gz
chmod ugo+x kbld-darwin-amd64-v0.34.0+vmware.1
Mueva el archivo binario a /usr/local/bin y cámbiele el nombre a kbld:
Linux:
mv ./kbld-linux-amd64-v0.34.0+vmware.1 /usr/local/bin/kbld
Mac OS:
mv ./kbld-darwin-amd64-v0.34.0+vmware.1 /usr/local/bin/kbld
Ejecute kbld --version para comprobar que la versión correcta de kbld esté instalada y sea ejecutable.
Windows:
Descomprima el archivo binario kbld.
gunzip kbld-windows-amd64-v0.34.0+vmware.1.gz
Cambie el nombre de kbld-windows-amd64-v0.34.0+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.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.
imgpkgimgpkg 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 y Linux:
Descomprima el imgpkg binario y haga que sea ejecutable.
Linux:
gunzip imgpkg-linux-amd64-v0.29.0+vmware.1.gz
chmod ugo+x imgpkg-linux-amd64-v0.29.0+vmware.1
Mac OS:
gunzip imgpkg-darwin-amd64-v0.29.0+vmware.1.gz
chmod ugo+x imgpkg-darwin-amd64-v0.29.0+vmware.1
Mueva el archivo binario a /usr/local/bin y cámbiele el nombre a imgpkg:
Linux:
mv ./imgpkg-linux-amd64-v0.29.0+vmware.1 /usr/local/bin/imgpkg
Mac OS:
mv ./imgpkg-darwin-amd64-v0.29.0+vmware.1 /usr/local/bin/imgpkg
Ejecute imgpkg --version para comprobar que la versión correcta de imgpkg esté instalada y sea ejecutable.
Windows:
Descomprima el archivo binario imgpkg.
gunzip imgpkg-windows-amd64-v0.29.0+vmware.1.gz
Cambie el nombre de imgpkg-windows-amd64-v0.29.0+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.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.
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.
Obtenga la dirección IP del supervisor de vCenter:
https://192.168.123.3.Sin IDP: Si no utiliza un proveedor de identidad externo:
(Opcional) 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.
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 administrator@vsphere.local, 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.
Introduzca la contraseña que utiliza para iniciar sesión en vCenter.
Cuando inicie sesión correctamente, el comando kubectl vsphere login:
kubeconfig local para agregar un token que se autentique con la API de KubernetesEstablezca 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.
Recopile información para ejecutar el comando tanzu login, que se conecta al supervisor:
tanzu lo use para el Supervisor.kubeconfig, que se establece de forma predeterminada en ~/.kube/config y se establece mediante la variable de entorno KUBECONFIG.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
successfully logged in to management cluster using the kubeconfig my-supervisor
Checking for required plugins...
Installing plugin 'cluster:v0.25'
Installing plugin 'feature:v0.25'
Installing plugin 'kubernetes-release:v0.25'
Installing plugin 'namespaces:v1.0.0'
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.
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 tanzu-cli-6072e424-d8a8-4406-8ec1-e24d3ef390e8@6072e424-d8a8-4406-8ec1-e24d3ef390e8
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
Con las herramientas CLI de Tanzu, kubectl y Carvel instaladas, puede utilizar la máquina de arranque para implementar clústeres de carga de trabajo y paquetes de servicios en Tanzu Kubernetes Grid. Para implementar clústeres de carga de trabajo, consulte Crear clústeres de carga de trabajo.
Las herramientas Carvel también son útiles para la personalización y la solución de problemas.
