Questo argomento spiega come installare e inizializzare l'interfaccia della riga di comando di Tanzu (CLI) 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.
Se si intende utilizzare Tanzu Kubernetes Grid in vSphere senza supervisore o in AWS o Azure, utilizzare la CLI di Tanzu per creare un cluster di gestione autonomo in ogni provider di cloud utilizzato. La CLI di Tanzu comunica con il cluster di gestione per creare e gestire i cluster del carico di lavoro nell'infrastruttura cloud di destinazione.
NotaLe istruzioni contenute in questo argomento sono specifiche per l'installazione della CLI di Tanzu per la distribuzione di cluster di gestione autonomi in vSphere senza supervisore oppure in AWS o Azure. Se si installa la CLI di Tanzu da utilizzare con un supervisore vSphere with Tanzu in vSphere 8, vedere l'argomento corrispondente in Creazione e gestione di cluster del carico di lavoro TKG 2.1 con la CLI di Tanzu, Installazione della CLI di Tanzu e altri strumenti per l'utilizzo con un supervisore vSphere with Tanzu.
Per ulteriori informazioni sulla CLI di Tanzu, inclusi riferimenti ai comandi, vedere la documentazione della CLI di VMware Tanzu.
La macchina di bootstrap in cui si installa e si esegue la CLI di Tanzu deve soddisfare determinati requisiti. 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.1, è necessaria una macchina di bootstrap in cui installare ed eseguire la CLI di Tanzu che disponga di:
Se la macchina di bootstrap esegue Windows, VMware consiglia di installare Windows Subsystem for Linux (WSL) con Ubuntu 20.04.4 LTS, che consente di eseguire comandi Linux in Windows. Per ulteriori informazioni su WSL, vedere Installazione di WSL nella documentazione di Microsoft.
In VMware Cloud on AWS e Azure VMware Solution, la macchina di bootstrap deve essere una macchina virtuale cloud, non una macchina fisica locale. Per le istruzioni di configurazione, vedere Preparazione della distribuzione dei cluster di gestione in un ambiente VMware Cloud.
Per distribuire cluster di gestione autonomi, esistono requisiti aggiuntivi in base al sistema operativo in esecuzione nella macchina di bootstrap:
kind
. Vedere Impostazioni per Docker Desktop nella documentazione di kind
.apt
anziché snap
per installare Docker da una CLI. Per istruzioni sull'installazione dell'app client Docker in un ambiente con limitazioni Internet, vedere Preparazione di un ambiente con limitazioni Internet.docker
. Creare il gruppo se non esiste già. In questo modo, la CLI di Tanzu può accedere al socket di Docker, di proprietà dell'utente root
. Per ulteriori informazioni, vedere Gestione di Docker come utente non root nella documentazione di Docker.Se la macchina di bootstrap ha un kernel Linux creato dopo la patch di sicurezza di Linux di maggio 2021, è necessario abilitare kind
, utilizzato dalla CLI di Tanzu per creare il cluster di bootstrap locale, per scrivere in un file di controllo che nelle versioni recenti di Linux è stato reso di sola lettura per impostazione predefinita.
La modalità di modifica delle autorizzazioni di questo file dipende dalla distribuzione di Linux in uso. Ad esempio, con una distribuzione Fedora di Linux 5.11 e 5.12, eseguire:
sudo sysctl net/netfilter/nf_conntrack_max=131072
Con una distribuzione Debian, aggiungere nf_conntrack_max=131072
al file sysctl.conf
ed eseguire:
sudo modprob nf_conntrack
Se si sta eseguendo la risoluzione dei problemi come descritto in Utilizzo di un cluster di bootstrap esistente per distribuire ed eliminare cluster di gestione, è necessario utilizzare kind
v0.11 o versione successiva per creare il cluster di bootstrap preesistente e persistente.
kind
. Vedere Impostazioni per Docker Desktop nella documentazione di kind
.Se la macchina di bootstrap esegue il sottosistema Windows per Linux e dispone di un kernel Linux creato dopo la patch di sicurezza di maggio 2021 per Linux, ad esempio Linux 5.11 e 5.12 con Fedora, eseguire quanto segue:
sudo sysctl net/netfilter/nf_conntrack_max=131072
Ciò consente a kind
, utilizzato dalla CLI di tanzu
per creare il cluster di bootstrap locale, di scrivere in un file di controllo che le versioni recenti di Linux hanno reso di sola lettura per impostazione predefinita.
Se si sta eseguendo la risoluzione dei problemi come descritto in Utilizzo di un cluster di bootstrap esistente per distribuire ed eliminare cluster di gestione, è necessario utilizzare kind
v0.11 o versione successiva per creare il cluster di bootstrap preesistente e persistente.
Scaricare i file della versione compatibile della CLI di Tanzu dalla pagina di download di Tanzu Kubernetes Grid.
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.1.1.
In Download prodotti (Product Downloads), scorrere fino alla sezione denominata CLI di VMware Tanzu 2.1.1.
(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.
Nel sistema in uso, creare una nuova directory denominata tanzu
. Se in questa cartella sono stati in precedenza decompressi artefatti per le versioni precedenti, eliminare i contenuti esistenti nella cartella.
Nella cartella tanzu
, decomprimere il file del bundle della CLI di Tanzu per il sistema operativo in uso. Per decomprimere il file del bundle, utilizzare lo strumento di estrazione desiderato. Ad esempio, in Linux o macOS, è possibile utilizzare il comando tar
.
tar -xvf tanzu-cli-bundle-darwin-amd64.tar.gz
tar -xvf tanzu-cli-bundle-linux-amd64.tar.gz
tanzu-cli-bundle-windows-amd64.zip
.
Dopo aver decompresso il file del bundle, nella cartella tanzu
sarà presente una cartella cli
con più sottocartelle e file.
Dopo aver scaricato e decompresso la CLI di Tanzu nella macchina di bootstrap, è necessario renderla disponibile per il sistema.
Passare alla sottocartella cli
nella cartella tanzu
che è stata decompressa nella sezione precedente.
Rendere la CLI disponibile per il sistema:
/usr/local/bin
:
sudo install core/v0.28.1/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
/usr/local/bin
:
sudo install core/v0.28.1/tanzu-core-linux_amd64 /usr/local/bin/tanzu
Program Files\tanzu
.cli
decompressa, individuare e copiare il file core\v0.28.1\tanzu-core-windows_amd64.exe
nella nuova cartella Program Files\tanzu
.tanzu-core-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
.Nella riga di comando in un nuovo terminale, inizializzare la CLI di Tanzu:
tanzu init
Verificare che sia installata la versione corretta della CLI. La versione della CLI è uguale a quella corrente di Tanzu Framework, che è incluso nella CLI di Tanzu. Tanzu Kubernetes Grid 2.1.1 utilizza CLI di Tanzu v0.28.1 che si trova in Tanzu Framework v0.28.1:
tanzu version
Se si esegue macOS, è possibile che venga visualizzato il messaggio di errore seguente:
"tanzu" cannot be opened because the developer cannot be verified.
In questo caso, è necessario creare un'eccezione di sicurezza per l'eseguibile tanzu
. Individuare l'app tanzu
nel Finder, fare clic tenendo premuto il tasto Ctrl sull'app e selezionare Apri.
Se nella macchina sono già installati plug-in della CLI di Tanzu di un'installazione precedente della CLI, aggiornare i plug-in alla versione corrente della CLI:
Disinstallare i plug-in esistenti:
tanzu plugin clean
Installare tutti i plug-in per questa versione:
tanzu plugin sync
Controllare lo stato e la versione dell'installazione del plug-in:
tanzu plugin list
NotaDopo aver installato la CLI di Tanzu ma prima di averla utilizzata per accedere 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.
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.1.1.
In Download prodotti (Product Downloads), scorrere fino alla sezione denominata Kubectl 1.24.10 for VMware Tanzu Kubernetes Grid 2.1.1.
(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.
Passare alla directory tanzu
creata nella sezione Download e decompressione della CLI di Tanzu precedente e decomprimere il file binario kubectl
per il sistema operativo in uso. Per decomprimere il file del bundle, utilizzare lo strumento di estrazione desiderato. Ad esempio, il comando gunzip
.
gunzip kubectl-mac-v1.24.10+vmware.1.gz
gunzip kubectl-linux-v1.24.10+vmware.1.gz
kubectl-windows-v1.24.10+vmware.1.exe.gz
.
Rendere la CLI disponibile per il sistema:
Rendere eseguibile il file scaricato:
chmod ugo+x kubectl-mac-v1.24.10+vmware.1
Installare il file binario in /usr/local/bin
:
sudo install kubectl-mac-v1.24.10+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.24.10+vmware.1
Installare il file binario in /usr/local/bin
:
sudo install kubectl-linux-v1.24.10+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.24.10+vmware.1.exe
nella nuova cartella Program Files\kubectl
.kubectl-windows-v1.24.10+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.
Eseguire tanzu --help
per visualizzare l'elenco dei comandi forniti dalla CLI di Tanzu.
È possibile visualizzare il testo della guida per qualsiasi gruppo di comandi con l'opzione --help
per visualizzare informazioni su tale comando o gruppo di comandi specifico. Ad esempio, tanzu login --help
, tanzu management-cluster --help
o tanzu management-cluster create --help
.
Per ulteriori informazioni sulla CLI di Tanzu, vedere le Informazioni di riferimento dei comandi della CLI di Tanzu.
Il progetto open source Carvel fornisce un set di strumenti componibili affidabili e per un singolo scopo che consentono di creare, configurare e distribuire le applicazioni in Kubernetes.
Tanzu Kubernetes Grid include file binari firmati per ytt
, kapp
, kbld
e imgpkg
in bundle con la CLI di Tanzu. Il bundle include anche vendir
, uno strumento di strutture di directory Kubernetes, che attualmente non è richiesto dagli utenti finali, ma viene fornito per comodità.
Nella macchina dell'ambiente di bootstrap, passare alla posizione in cui è stato decompresso il file tar del bundle della CLI di Tanzu per il sistema operativo in uso.
Ad esempio, la cartella tanzu
creata nella procedura precedente.
Aprire la cartella cli
.
cd cli
ytt
ytt
è uno strumento della riga di comando per la creazione di modelli e patch dei file YAML. È inoltre possibile utilizzare ytt
per raccogliere frammenti e insiemi di YAML in blocchi modulari per semplificarne il riutilizzo. Tanzu Kubernetes Grid utilizza ytt
per supportare la personalizzazione basata su overlay per i cluster e i piani dei cluster. Per utilizzare gli overlay di personalizzazione, potrebbe essere necessario ytt
.
Decomprimere il file binario ytt
e renderlo eseguibile.
gunzip ytt-darwin-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-darwin-amd64-v0.43.1+vmware.1
Spostare il file binario in /usr/local/bin
e rinominarlo con ytt
:
sudo mv ./ytt-darwin-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
Eseguire ytt --version
per verificare che la versione corretta di ytt
sia installata ed eseguibile.
ytt --version
Decomprimere il file binario ytt
e renderlo eseguibile.
gunzip ytt-linux-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-linux-amd64-v0.43.1+vmware.1
Spostare il file binario in /usr/local/bin
e rinominarlo con ytt
:
sudo mv ./ytt-linux-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
Eseguire ytt --version
per verificare che la versione corretta di ytt
sia installata ed eseguibile.
ytt --version
Decomprimere il file binario ytt
.
gunzip ytt-windows-amd64-v0.43.1+vmware.1.gz
Rinominare ytt-windows-amd64-v0.43.1+vmware.1
con ytt.exe
Program Files\ytt
e copiare il file ytt.exe
in tale cartella.ytt
, 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.ytt
.ytt version
per verificare che sia installata la versione corretta di ytt
.kapp
kapp
è la CLI di distribuzione delle applicazioni per Kubernetes. Consente di installare, aggiornare ed eliminare più risorse Kubernetes come un'unica applicazione.
Decomprimere il file binario kapp
e renderlo eseguibile.
gunzip kapp-darwin-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-darwin-amd64-v0.53.2+vmware.1
Spostare il file binario in /usr/local/bin
e rinominarlo con kapp
:
sudo mv ./kapp-darwin-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
Eseguire kapp --version
per verificare che la versione corretta di kapp
sia installata ed eseguibile.
kapp --version
Decomprimere il file binario kapp
e renderlo eseguibile.
gunzip kapp-linux-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-linux-amd64-v0.53.2+vmware.1
Spostare il file binario in /usr/local/bin
e rinominarlo con kapp
:
sudo mv ./kapp-linux-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
Eseguire kapp --version
per verificare che la versione corretta di kapp
sia installata ed eseguibile.
kapp --version
Decomprimere il file binario kapp
.
gunzip kapp-windows-amd64-v0.53.2+vmware.1.gz
Rinominare kapp-windows-amd64-v0.53.2+vmware.1
con kapp.exe
Program Files\kapp
e copiare il file kapp.exe
in tale cartella.kapp
, 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.kapp
.kapp version
per verificare che sia installata la versione corretta di kapp
.kbld
kbld
è uno strumento per la creazione e la risoluzione di immagini.
Decomprimere il file binario kbld
e renderlo eseguibile.
gunzip kbld-darwin-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-darwin-amd64-v0.35.1+vmware.1
Spostare il file binario in /usr/local/bin
e rinominarlo con kbld
:
sudo mv ./kbld-darwin-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
Eseguire kbld --version
per verificare che la versione corretta di kbld
sia installata ed eseguibile.
Decomprimere il file binario kbld
e renderlo eseguibile.
gunzip kbld-linux-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-linux-amd64-v0.35.1+vmware.1
Spostare il file binario in /usr/local/bin
e rinominarlo con kbld
:
sudo mv ./kbld-linux-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
Eseguire kbld --version
per verificare che la versione corretta di kbld
sia installata ed eseguibile.
kbld --version
Decomprimere il file binario kbld
.
gunzip kbld-windows-amd64-v0.35.1+vmware.1.gz
Rinominare kbld-windows-amd64-v0.35.1+vmware.1
con kbld.exe
Program Files\kbld
e copiare il file kbld.exe
in tale cartella.kbld
, 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.kbld
.kbld version
per verificare che sia installata la versione corretta di kbld
.imgpkg
imgpkg
è uno strumento che consente a Kubernetes di archiviare le configurazioni e le immagini del container associate come immagini OCI, nonché di trasferire tali immagini. imgpkg
è necessario per distribuire Tanzu Kubernetes Grid in ambienti con limitazioni Internet e quando si creano immagini della macchina personalizzate. È necessario anche quando si configura il pacchetto Harbor.
Decomprimere il file binario imgpkg
e renderlo eseguibile.
gunzip imgpkg-darwin-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-darwin-amd64-v0.31.1+vmware.1
Spostare il file binario in /usr/local/bin
e rinominarlo con imgpkg
:
sudo mv ./imgpkg-darwin-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
Eseguire imgpkg --version
per verificare che la versione corretta di imgpkg
sia installata ed eseguibile.
imgpkg --version
Decomprimere il file binario imgpkg
e renderlo eseguibile.
gunzip imgpkg-linux-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-linux-amd64-v0.31.1+vmware.1
Spostare il file binario in /usr/local/bin
e rinominarlo con imgpkg
:
sudo mv ./imgpkg-linux-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
Eseguire imgpkg --version
per verificare che la versione corretta di imgpkg
sia installata ed eseguibile.
imgpkg --version
Decomprimere il file binario imgpkg
.
gunzip imgpkg-windows-amd64-v0.31.1+vmware.1.gz
Rinominare imgpkg-windows-amd64-v0.31.1+vmware.1
con imgpkg.exe
Program Files\imgpkg
e copiare il file imgpkg.exe
in tale cartella.imgpkg
, 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.imgpkg
.imgpkg version
per verificare che sia installata la versione corretta di imgpkg
.Per distribuire cluster di gestione autonomi nel provider di cloud, seguire le istruzioni di Distribuzione di cluster di gestione autonomi.