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.
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.
NotaLas 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.3, Instalar la CLI de Tanzu y la CLI de Kubernetes 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.
ImportanteEl 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. Debido a la versión anterior de TKG que está integrada en supervisor, algunas de las funciones que están disponibles si se utiliza un clúster de administración TKG 2.3 independiente no están disponibles si se utiliza un supervisor vSphere with Tanzu para crear clústeres de carga de trabajo. 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 tan reciente como la versión independiente más reciente de TKG. 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. Por ejemplo, Tanzu CLI v1.0.0 es totalmente compatible con versiones anteriores de los complementos de TKG 2.2 que proporciona Supervisor.
PrecauciónLas 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.
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:
Para utilizar un clúster supervisor como el clúster de administración, también necesita:
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.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.
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.
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.3:
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
Instale los complementos independientes para Tanzu Kubernetes Grid v2.3:
tanzu plugin install --group vmware-tkg/default:v2.3.1
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
.
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.
Vaya a Descargas de productos de Tanzu Kubernetes Grid v2.3.1.
Desplácese hasta la sección denominada Kubectl 1.26.8 para VMware Tanzu Kubernetes Grid 2.3.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.
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.26.8+vmware.2.gz
gunzip kubectl-linux-v1.26.8+vmware.2.gz
kubectl-windows-v1.26.8+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.26.8+vmware.2
Instale el archivo binario en /usr/local/bin
:
sudo install kubectl-mac-v1.26.8+vmware.2 /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.26.8+vmware.2
Instale el archivo binario en /usr/local/bin
:
sudo install kubectl-linux-v1.26.8+vmware.2 /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.26.8+vmware.2.exe
en la nueva carpeta Program Files\kubectl
.kubectl-windows-v1.26.8+vmware.2.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
Antes de poder utilizar la CLI de Tanzu y kubectl
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.
Para conectar la CLI de Tanzu al supervisor, haga lo siguiente:
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 [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ónUtilice 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 context create
, que se conecta al supervisor:
kubeconfig
, que se establece de forma predeterminada en ~/.kube/config
y se establece mediante la variable de entorno KUBECONFIG
.Ejecute el comando tanzu context create
pasando los valores anteriores, por ejemplo:
Sin IDP:
tanzu context create my-supervisor --kubeconfig ~/.kube/config --kubecontext 192.168.123.3
Esto registra el contexto de supervisor con la CLI de Tanzu y descarga los complementos específicos del supervisor.
[ok] successfully logged in to management cluster using the kubeconfig my-supervisor
[i] Checking for required plugins...
[i] Installing plugin 'cluster:v0.29' with target 'kubernetes'
[i] Plugin binary for 'cluster:v0.29' found in cache
[i] Installing plugin 'feature:v0.29' with target 'kubernetes'
[i] Plugin binary for 'feature:v0.29' found in cache
[i] Installing plugin 'kubernetes-release:v0.29' with target 'kubernetes'
[i] Plugin binary for 'kubernetes-release:v0.29' found in cache
[i] Installing plugin 'namespaces:v1.0.0' with target 'kubernetes'
[i] Plugin binary for 'namespaces:v1.0.0' found in cache
[i] Successfully installed all required plugins
Con un IDP:
tanzu context create --endpoint https://10.73.27.32 --name oidc-user
tanzu context use https://10.73.27.32 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 context list
, por ejemplo:
tanzu context list
NAME ISACTIVE ENDPOINT KUBECONFIGPATH KUBECONTEXT
my-supervisor true https://192.168.123.3:443 /home/vmware/.kube/config 192.168.123.3
tanzu context use
ahora debería enumerar al supervisor por el nombre que proporcionó:
tanzu context use
? Select a server [Use arrows to move, type to filter]
> my-supervisor ()
+ new server
Ejecute tanzu plugin list
para ver la lista de complementos específicos de supervisor, así como los complementos independientes de la CLI.
tanzu plugin list
Standalone Plugins
NAME DESCRIPTION TARGET VERSION STATUS
isolated-cluster Prepopulating images/bundle for internet-restricted environments global v0.30.2 installed
pinniped-auth Pinniped authentication operations (usually not directly invoked) global v0.30.2 installed
management-cluster Kubernetes management cluster operations kubernetes v0.30.2 installed
package Tanzu package management kubernetes v0.30.2 installed
secret Tanzu secret management kubernetes v0.30.2 installed
telemetry Configure cluster-wide settings for vmware tanzu telemetry kubernetes v0.30.2 installed
Plugins from Context: my-supervisor
NAME DESCRIPTION TARGET VERSION STATUS
cluster Kubernetes cluster operations kubernetes v0.29.0 installed
feature Operate on features and featuregates kubernetes v0.29.0 installed
kubernetes-release Kubernetes release operations kubernetes v0.29.0 installed
namespaces Discover vSphere Supervisor namespaces you have access to kubernetes v1.0.0 installed
NotaCon vSphere 8.0.1c, los complementos para el contexto de supervisor tienen la versión v0.29.0.