Installazione della CLI di Tanzu e della CLI di Kubernetes per l'utilizzo con i cluster di gestione autonomi

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.

Per distribuire 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 dell'ambiente. 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.

Nota

Le 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.3 con la CLI di Tanzu, Installazione della CLI di Tanzu e della CLI di Kubernetes per l'utilizzo con un supervisore vSphere with Tanzu.

Prerequisiti

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.3, è necessaria una macchina di bootstrap in cui installare ed eseguire la CLI di Tanzu che disponga di:

  • Un sistema operativo Linux, Windows o macOS in esecuzione su una macchina fisica o virtuale con l'hardware seguente:
    • Almeno 8 GB di RAM. VMware consiglia 16 GB di RAM.
    • Un disco con 50 GB di storage disponibile.
    • 2 o 4 CPU a 2 core.
  • Un browser o un accesso remoto da una macchina con un browser, se si intende utilizzare l'interfaccia del programma di installazione di Tanzu Kubernetes Grid per distribuire cluster di gestione autonomi. È possibile utilizzare la CLI di Tanzu senza browser, ma per le prime distribuzioni è consigliabile utilizzare l'interfaccia del programma di installazione.
  • L'ora del sistema viene sincronizzata con un server NTP (Network Time Protocol).
  • 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:

    macOS
    Linux
    • Docker installato e in esecuzione nella macchina di bootstrap. Utilizzare apt anziché snap per installare Docker da un gestore di pacchetti. Per istruzioni sull'installazione dell'app client Docker in un ambiente con limitazioni Internet, vedere Preparazione di un ambiente con limitazioni Internet.
    • Aggiungere l'account utente non root al gruppo di utenti 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 esegue Ubuntu 22.04, assicurarsi che il filtro del percorso inverso sia disattivato. Per disattivare il filtro del percorso inverso, aggiungere la sostituzione seguente:

      # New file /etc/sysctl.d/90-override.conf
      ipv4.conf.all.rp_filter = 0
      
    • 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 modprobe 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.

    Windows
    • Docker Desktop installato e in esecuzione nella macchina di bootstrap.
    • Allocare almeno 6 GB di memoria in Docker Desktop per il container 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.


Installazione della CLI di Tanzu

Per installare la CLI di Tanzu da utilizzare con Tanzu Kubernetes Grid v2.3, installare una versione compatibile della CLI principale di Tanzu e i plug-in della CLI di Tanzu per Tanzu Kubernetes Grid v2.3. 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.

Installazione della CLI principale di Tanzu

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

Nota

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

Installazione con un gestore di pacchetti
Per installare la CLI di Tanzu utilizzando un gestore di pacchetti:
  1. 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.

  2. 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.
        
  3. Verificare che sia installata la versione corretta della CLI. Ad esempio:

    tanzu version
    version: v1.0.0
    ...
    
Installazione di da una versione binaria
È possibile scaricare il file binario della CLI di Tanzu da VMware Customer Connect o GitHub. Per un elenco di tutte le versioni della CLI compatibili, vedere Product Interoperability Matrix.

Per scaricare una versione binaria della CLI di Tanzu da Customer Connect e quindi installarla:

  1. Scaricare e decomprimere la CLI di Tanzu:

    1. Passare alla pagina della CLI di VMware Tanzu in VMware Customer Connect e in Download prodotti (Product Downloads) per Tanzu CLI v1.0.0, individuare e scaricare il file binario della CLI di Tanzu per il sistema operativo (SO).
    2. 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.

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

      1. Creare una nuova cartella Program Files\tanzu.
      2. Copiare il file tanzu-cli-windows_amd64.exe nella nuova cartella Program Files\tanzu.
      3. Rinominare tanzu-cli-windows_amd64.exe con tanzu.exe.
      4. Fare clic con il pulsante destro del mouse sulla cartella tanzu, selezionare Proprietà > Sicurezza e assicurarsi che l'account utente disponga dell'autorizzazione Controllo completo.
      5. Utilizzare Windows Search per cercare env.
      6. Selezionare Modifica le variabili di ambiente relative al sistema e fare clic sul pulsante Variabili di ambiente.
      7. Selezionare la riga Path sotto Variabili di sistema e fare clic su Modifica.
      8. Fare clic su Nuovo per aggiungere una nuova riga e immettere il percorso della CLI tanzu. Il valore del percorso non deve includere l'estensione .exe. Ad esempio, C:\Program Files\tanzu.
  3. 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.

Installazione dei plug-in della CLI di Tanzu per TKG v2.3

Per installare i plug-in autonomi della CLI di Tanzu per Tanzu Kubernetes Grid v2.3:

  1. Elencare i plug-in autonomi della CLI di Tanzu per Tanzu Kubernetes Grid v2.3:

    tanzu plugin group get vmware-tkg/default:v2.3.1
    

    L'output è simile al seguente:

    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
    

    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
    
  2. Installare i plug-in autonomi per Tanzu Kubernetes Grid v2.3:

    tanzu plugin install --group vmware-tkg/default:v2.3.1
    
  3. 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.3.1 deve essere incluso nell'output di tanzu plugin list.

    Nota

    Dopo 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 e tanzu 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.

Installazione della CLI di Kubernetes

Scaricare e decomprimere la CLI di Kubernetes, kubectl, nella macchina di bootstrap, quindi renderla disponibile nel sistema in uso:

  1. Passare a VMware Customer Connect e accedere con le credenziali di VMware Customer Connect.

  2. Passare a Download dei prodotti Tanzu Kubernetes Grid v2.3.1.

  3. Scorrere fino alla sezione denominata Kubectl 1.26.8 for VMware Tanzu Kubernetes Grid 2.3.1.

    macOS
    Individuare kubectl cli v1.26.8 for Mac e fare clic su Scarica ora (Download Now).
    Linux
    Individuare kubectl cli v1.26.8 for Linux e fare clic su Scarica ora (Download Now).
    Windows
    Individuare kubectl cli v1.26.8 for Windows e fare clic su Scarica ora (Download Now).
  4. (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.

  5. Per decomprimere il file binario kubectl del sistema operativo in uso, utilizzare lo strumento di estrazione desiderato. Ad esempio, il comando gunzip.

    macOS
    gunzip kubectl-mac-v1.26.8+vmware.2.gz
    
    Linux
    gunzip kubectl-linux-v1.26.8+vmware.2.gz
    
    Windows
    Utilizzare lo strumento di estrazione di Windows per decomprimere kubectl-windows-v1.26.8+vmware.2.exe.gz.
  6. Rendere la CLI disponibile per il sistema:

    macOS
    1. Rendere eseguibile il file scaricato:

      chmod ugo+x kubectl-mac-v1.26.8+vmware.2
      
    2. Installare il file binario in /usr/local/bin:

      sudo install kubectl-mac-v1.26.8+vmware.2 /usr/local/bin/kubectl
      
    3. Eseguire kubectl version per verificare che la versione corretta di kubectl sia installata ed eseguibile.

      kubectl version
      
    Linux
    1. Rendere eseguibile il file scaricato:

      chmod ugo+x kubectl-linux-v1.26.8+vmware.2
      
    2. Installare il file binario in /usr/local/bin:

      sudo install kubectl-linux-v1.26.8+vmware.2 /usr/local/bin/kubectl
      
    3. Eseguire kubectl version per verificare che la versione corretta di kubectl sia installata ed eseguibile.

      kubectl version
      
    Windows
    1. Creare una nuova cartella Program Files\kubectl.
    2. Individuare e copiare il file kubectl-windows-v1.26.8+vmware.2.exe nella nuova cartella Program Files\kubectl.
    3. Rinominare kubectl-windows-v1.26.8+vmware.2.exe con kubectl.exe.
    4. Fare clic con il pulsante destro del mouse sulla cartella kubectl, selezionare Proprietà > Sicurezza e assicurarsi che l'account utente disponga dell'autorizzazione Controllo completo.
    5. Utilizzare Windows Search per cercare env.
    6. Selezionare Modifica le variabili di ambiente relative al sistema e fare clic sul pulsante Variabili di ambiente.
    7. Selezionare la riga Path sotto Variabili di sistema e fare clic su Modifica.
    8. Fare clic su Nuovo per aggiungere una nuova riga e immettere il percorso della CLI kubectl.
    9. Eseguire kubectl version per verificare che sia installata la versione corretta della CLI.

      kubectl version
      

Passaggi successivi

Per distribuire cluster di gestione autonomi nel provider di cloud, seguire le istruzioni di Distribuzione di cluster di gestione autonomi.

check-circle-line exclamation-circle-line close-line
Scroll to top icon