Questo argomento spiega come installare l'interfaccia della riga di comando (CLI) di Tanzu in una macchina di bootstrap. La macchina di bootstrap è il laptop, l'host o il server da cui vengono distribuiti i cluster di gestione e del carico di lavoro e che include i file di configurazione di Tanzu e Kubernetes per le distribuzioni. La macchina di bootstrap è in genere locale, ma può anche essere una macchina fisica o una macchina virtuale a cui si accede in remoto. Per ulteriori informazioni sulla CLI di Tanzu, inclusi riferimenti ai comandi, vedere la documentazione della CLI di VMware Tanzu v1.0.x.
Se si utilizza il supervisore vSphere with Tanzu in vSphere 8 come cluster di gestione, dopo aver installato la CLI di Tanzu, è possibile connetterla al supervisore.
NotaLe istruzioni contenute in questo argomento sono specifiche per l'installazione della CLI di Tanzu per l'utilizzo con un supervisore vSphere with Tanzu in vSphere 8. Se si installa la CLI di Tanzu per distribuire cluster di gestione autonomi in vSphere senza supervisore oppure in AWS o Azure, vedere l'argomento corrispondente in Distribuzione e gestione di cluster di gestione autonomi Tanzu Kubernetes Grid 2.4, Installazione della CLI di Tanzu e della CLI di Kubernetes per l'utilizzo con i cluster di gestione autonomi.
La CLI di Tanzu comunica con il supervisore per creare e gestire cluster del carico di lavoro in vSphere with Tanzu.
ImportanteIl supervisore vSphere with Tanzu in vSphere 8.0.1c o versioni successive esegue TKG v2.2 Le versioni precedenti di vSphere 8 eseguono TKG v2.0, che non è stato rilasciato indipendentemente dal supervisore. Poiché la versione precedente di TKG è incorporata nel supervisore, alcune delle funzionalità che sono disponibili se si utilizza un cluster di gestione autonomo TKG 2.4 non sono disponibili se si utilizza un supervisore vSphere with Tanzu per creare cluster del carico di lavoro. Le versioni future di TKG verranno incorporate nel supervisore nelle prossime versioni di aggiornamento di vSphere. Di conseguenza, la versione di TKG incorporata nell'ultima versione di vSphere with Tanzu in un determinato momento potrebbe essere meno recente dell'ultima versione autonoma di TKG. Tuttavia, le versioni della CLI di Tanzu compatibili con tutte le versioni di TKG v2.x sono completamente supportate per l'utilizzo con il supervisore in tutte le versioni di vSphere 8. Ad esempio, CLI di Tanzu v0.90.1 è completamente retrocompatibile con i plug-in di TKG 2.2 forniti dal supervisore.
AttenzioneLe versioni della CLI di Tanzu compatibili con TKG 2.x e con il supervisore vSphere with Tanzu in vSphere 8 non sono compatibili con il cluster supervisore in vSphere 7. Per utilizzare la CLI di Tanzu con un cluster supervisore vSphere with Tanzu in vSphere 7, utilizzare la versione della CLI di Tanzu da TKG v1.6. Per utilizzare le versioni della CLI di Tanzu compatibili con TKG 2.x con Supervisore, eseguire l'aggiornamento a vSphere 8. È possibile distribuire un cluster di gestione autonomo TKG 2.x in vSphere 7 se non è presente un cluster supervisore vSphere with Tanzu. Per informazioni sulla compatibilità tra la CLI di Tanzu e i prodotti VMware, vedere la documentazione della CLI di Tanzu.
La macchina di bootstrap in cui si installa e si esegue la CLI di Tanzu deve soddisfare determinati requisiti per l'uso con Tanzu Kubernetes Grid. Esistono ulteriori requisiti a seconda che si intenda utilizzare la CLI di Tanzu con un supervisore vSphere with Tanzu come cluster di gestione o distribuire cluster di gestione autonomi oppure entrambe le cose.
Per eseguire la CLI di Tanzu con Tanzu Kubernetes Grid v2.4, è necessaria una macchina di bootstrap in cui installare ed eseguire la CLI di Tanzu che disponga di:
Per utilizzare un cluster supervisore come cluster di gestione, è inoltre necessario:
Un account vSphere 8 con:
Uno degli elementi seguenti:
kubectl vsphere
installato nella macchina di bootstrap, come descritto in Download e installazione degli strumenti della CLI di Kubernetes per vSphere.Per installare la CLI di Tanzu da utilizzare con Tanzu Kubernetes Grid v2.4, installare una versione compatibile della CLI principale di Tanzu e i plug-in della CLI di Tanzu per Tanzu Kubernetes Grid v2.4. I comandi forniti da questi plug-in abilitano le operazioni di cluster e pacchetti. Per un elenco delle versioni della CLI compatibili, vedere Product Interoperability Matrix.
Per installare la CLI principale di Tanzu, eseguire i passaggi seguenti; per visualizzare i passaggi, fare clic sulla scheda Installazione con un gestore di pacchetti (Install using a package manager) o Installazione dalla versione di un file binario (Install from a binary release).
Dopo aver installato la CLI principale di Tanzu, passare a Installazione dei plug-in della CLI di Tanzu per TKG v2.4.
NotaSe si desidera mantenere un'installazione esistente della CLI di Tanzu, spostare il file binario della CLI da
/usr/local/bin/tanzu
in una posizione diversa prima di eseguire i passaggi seguenti.
Scegliere una versione compatibile della CLI di Tanzu. Per un elenco delle versioni della CLI compatibili con questa versione di Tanzu Kubernetes Grid, vedere Product Interoperability Matrix.
Seguire le istruzioni per il gestore di pacchetti riportate di seguito.
APT (Debian o Ubuntu):
Se la versione della CLI di Tanzu che si desidera installare è quella più recente disponibile, ad esempio v1.0.0
, eseguire:
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
Se si desidera installare una versione precedente della CLI di Tanzu, ad esempio v0.90.1
, eseguire:
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):
Se la versione della CLI di Tanzu che si desidera installare è quella più recente disponibile, ad esempio v1.0.0
, eseguire:
choco install tanzu-cli
Se si desidera installare una versione precedente della CLI di Tanzu, ad esempio v0.90.1
, eseguire:
choco install tanzu-cli --version 0.90.1
Homebrew (MacOS):
Se la versione della CLI di Tanzu che si desidera installare è quella più recente disponibile, ad esempio v1.0.0
, eseguire:
brew update
brew install vmware-tanzu/tanzu/tanzu-cli
Se si desidera installare una versione precedente della CLI di Tanzu, ad esempio v0.90.1
, eseguire:
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):
Se la versione della CLI di Tanzu che si desidera installare è quella più recente disponibile, ad esempio v1.0.0
, eseguire:
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.
Se si desidera installare una versione precedente della CLI di Tanzu, ad esempio v0.90.1
, eseguire:
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.
Verificare che sia installata la versione corretta della CLI. Ad esempio:
tanzu version
version: v1.0.0
...
Per scaricare una versione binaria della CLI di Tanzu da Customer Connect e quindi installarla:
Scaricare e decomprimere la CLI di Tanzu:
Decomprimere il file della CLI di Tanzu per il sistema operativo. Per decomprimere il file, utilizzare lo strumento di estrazione desiderato. Ad esempio, in Linux o macOS, è possibile utilizzare il comando tar
.
macOS:
tar -xvf tanzu-cli-darwin-amd64.tar.gz
Linux:
tar -xvf tanzu-cli-linux-amd64.tar.gz
Windows:
Utilizzare lo strumento di estrazione di Windows per decomprimere tanzu-cli-windows-amd64.zip
.
Rendere la CLI disponibile per il sistema:
macOS:
Installare il file binario in /usr/local/bin
:
install tanzu-cli-darwin_amd64 /usr/local/bin/tanzu
Linux:
Installare il file binario in /usr/local/bin
:
sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
Windows:
Program Files\tanzu
.tanzu-cli-windows_amd64.exe
nella nuova cartella Program Files\tanzu
.tanzu-cli-windows_amd64.exe
con tanzu.exe
.tanzu
, selezionare Proprietà > Sicurezza e assicurarsi che l'account utente disponga dell'autorizzazione Controllo completo.env
.Path
sotto Variabili di sistema e fare clic su Modifica.tanzu
. Il valore del percorso non deve includere l'estensione .exe
. Ad esempio, C:\Program Files\tanzu
.Verificare che sia installata la versione corretta della CLI. Ad esempio:
tanzu version
version: v1.0.0
...
Per scaricare e installare la CLI di Tanzu da una versione binaria in GitHub seguire le istruzioni nella sezione Dalle versioni binarie nel progetto GitHub di Installazione della CLI di Tanzu.
Per installare i plug-in autonomi della CLI di Tanzu per Tanzu Kubernetes Grid v2.4:
Elencare i plug-in autonomi della CLI di Tanzu per Tanzu Kubernetes Grid v2.4:
tanzu plugin group get vmware-tkg/default:v2.4.0
L'output è simile al seguente:
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
Per elencare tutte le versioni disponibili per il gruppo di plug-in vmware-tkg/default
, eseguire:
tanzu plugin group search -n vmware-tkg/default --show-details
Installare i plug-in autonomi per Tanzu Kubernetes Grid v2.4:
tanzu plugin install --group vmware-tkg/default:v2.4.0
Verificare che i plug-in siano stati installati correttamente:
tanzu plugin list
Ogni nome e versione del plug-in restituiti da tanzu plugin group get vmware-tkg/default:v2.4.0
deve essere incluso nell'output di tanzu plugin list
.
NotaDopo aver installato la CLI di Tanzu e i plug-in autonomi di Tanzu Kubernetes Grid ma prima di averla utilizzata per connettersi a un cluster di gestione, tutti i gruppi di comandi della CLI specifici del contesto, come
tanzu cluster
etanzu kubernetes-release
, non sono disponibili e non sono inclusi nell'output--help
della CLI di Tanzu. La CLI di Tanzu installa automaticamente i plug-in con ambito contestuale quando ci si connette a un cluster di gestione. Per ulteriori informazioni sui plug-in della CLI di Tanzu e su come installarli, vedere Installazione dei plug-in della CLI di Tanzu.
Scaricare e decomprimere la CLI di Kubernetes, kubectl
, nella macchina di bootstrap, quindi renderla disponibile nel sistema in uso:
Passare a VMware Customer Connect e accedere con le credenziali di VMware Customer Connect.
Passare alla pagina di download di Tanzu Kubernetes Grid.
Nella riga VMware Tanzu Kubernetes Grid fare clic su Vai ai download (Go to Downloads).
Nel menu a discesa Seleziona versione (Select Version), selezionare 2.4.0.
In Download prodotti (Product Downloads), scorrere fino alla sezione denominata Kubectl 1.27.5 for VMware Tanzu Kubernetes Grid 2.4.0.
(Facoltativo) Verificare che i file scaricati siano uguali a quelli originali. VMware fornisce un checksum SHA-1, un checksum SHA-256 e un checksum MD5 per ogni download. Per ottenere questi checksum, fare clic su Altre informazioni (Read More) sotto la voce che si desidera scaricare. Per ulteriori informazioni, vedere Utilizzo di hash crittografici.
Per decomprimere il file binario kubectl
del sistema operativo in uso, utilizzare lo strumento di estrazione desiderato. Ad esempio, il 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
.
Rendere la CLI disponibile per il sistema:
Rendere eseguibile il file scaricato:
chmod ugo+x kubectl-mac-v1.27.5+vmware.1
Installare il file binario in /usr/local/bin
:
sudo install kubectl-mac-v1.27.5+vmware.1 /usr/local/bin/kubectl
Eseguire kubectl version
per verificare che la versione corretta di kubectl
sia installata ed eseguibile.
kubectl version
Rendere eseguibile il file scaricato:
chmod ugo+x kubectl-linux-v1.27.5+vmware.1
Installare il file binario in /usr/local/bin
:
sudo install kubectl-linux-v1.27.5+vmware.1 /usr/local/bin/kubectl
Eseguire kubectl version
per verificare che la versione corretta di kubectl
sia installata ed eseguibile.
kubectl version
Program Files\kubectl
.kubectl-windows-v1.27.5+vmware.1.exe
nella nuova cartella Program Files\kubectl
.kubectl-windows-v1.27.5+vmware.1.exe
con kubectl.exe
.kubectl
, selezionare Proprietà > Sicurezza e assicurarsi che l'account utente disponga dell'autorizzazione Controllo completo.env
.Path
sotto Variabili di sistema e fare clic su Modifica.kubectl
.Eseguire kubectl version
per verificare che sia installata la versione corretta della CLI.
kubectl version
Prima di poter utilizzare la CLI di Tanzu e kubectl
per distribuire cluster del carico di lavoro e pacchetti di servizi in Tanzu Kubernetes Grid, connettere la CLI di Tanzu al supervisore come descritto di seguito.
Per connettere la CLI di Tanzu al supervisore, eseguire le operazioni seguenti:
Recuperare l'indirizzo IP del supervisore da vCenter
https://192.168.123.3
.Nessun IDP: se non si utilizza un provider di identità esterno:
(Facoltativo) Configurare il plug-in kubectl vsphere
con un certificato attendibile, come descritto in Configurazione dell'accesso sicuro per i cluster vSphere with Tanzu.
Eseguire kubectl vsphere login
per accedere a vSphere. Per ulteriori informazioni su questo passaggio, vedere Connessione a un supervisore come utente di vCenter Single Sign-On con Kubectl.
kubectl vsphere login --vsphere-username VSPHERE-USERNAME --server=SUPERVISOR-IP
In cui VSPHERE-USERNAME
è il nome utente dell'account vCenter Single Sign-On (SSO), ad esempio [email protected]
, e SUPERVISOR-IP
è l'indirizzo IP del supervisore recuperato in precedenza.
Se il plug-in kubectl vsphere
non è stato configurato con un certificato attendibile, è possibile accedere in modo non sicuro aggiungendo --insecure-skip-tls-verify=true
al comando precedente.
Attenzioneutilizzare l'accesso non sicuro solo in un ambiente di sviluppo.
Immettere la password utilizzata per accedere a vCenter.
Una volta effettuato l'accesso, il comando kubectl vsphere login
:
kubeconfig
per aggiungere un token che esegue l'autenticazione con l'API di KubernetesImpostare il contesto di kubectl
sul supervisore.
kubectl config use-context SUPERVISOR-IP
In cui SUPERVISOR-IP
è il contesto del supervisore. Vedere Recupero e utilizzo del contesto del supervisore in Servizi e carichi di lavoro di vSphere with Tanzu.
Raccogliere informazioni per eseguire il comando tanzu context create
, che si connette al supervisore:
kubeconfig
locale, che per impostazione predefinita è ~/.kube/config
e viene impostato dalla variabile di ambiente KUBECONFIG
.Eseguire il comando tanzu context create
passando i valori precedenti, ad esempio:
Nessun IDP:
tanzu context create my-supervisor --kubeconfig ~/.kube/config --kubecontext 192.168.123.3
In questo modo il contesto del supervisore viene registrato con la CLI di Tanzu e vengono scaricati i plug-in specifici del supervisore.
[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
Nell'esempio precedente, https://10.73.27.32
è l'indirizzo IP del piano di controllo del supervisore. Per ulteriori informazioni su questo passaggio, vedere Connessione a un supervisore tramite la CLI di Tanzu e un provider di identità esterno.
Verificare che il supervisore sia stato aggiunto eseguendo tanzu context list
, ad esempio:
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
dovrebbe ora elencare il supervisore con il nome specificato:
tanzu context use
? Select a server [Use arrows to move, type to filter]
> my-supervisor ()
+ new server
Eseguire tanzu plugin list
per visualizzare l'elenco dei plug-in specifici del supervisore, nonché i plug-in autonomi della CLI.
tanzu plugin list
Standalone Plugins
NAME DESCRIPTION TARGET VERSION STATUS
isolated-cluster Prepopulating images/bundle for internet-restricted environments global v0.31.0 installed
pinniped-auth Pinniped authentication operations (usually not directly invoked) global v0.31.0 installed
management-cluster Kubernetes management cluster operations kubernetes v0.31.0 installed
package Tanzu package management kubernetes v0.31.0 installed
secret Tanzu secret management kubernetes v0.31.0 installed
telemetry Configure cluster-wide settings for vmware tanzu telemetry kubernetes v0.31.0 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, la versione dei plug-in per il contesto del supervisore è v0.29.0.