Installazione della CLI di Tanzu e di altri strumenti per l'utilizzo con un supervisore vSphere with Tanzu

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 utilizza il supervisore vSphere with Tanzu in vSphere 8 come cluster di gestione, dopo aver installato la CLI di Tanzu, è possibile connetterla al supervisore.

Nota

Le 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.2, Installazione della CLI di Tanzu e altri strumenti per l'utilizzo con 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.

Tanzu Kubernetes Grid v2.0, v2.2 e supervisore vSphere with Tanzu in vSphere 8

Importante

Il 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. I cluster di gestione autonomi che eseguono TKG 2.x sono disponibili a partire da TKG 2.1. Le versioni future di TKG verranno incorporate nel supervisore nelle prossime versioni di aggiornamento di vSphere. Di conseguenza, la versione di TKG incorporata nella versione più recente di vSphere with Tanzu in un determinato momento potrebbe non essere uguale alla versione autonoma di TKG che si sta utilizzando. 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.

Tanzu Kubernetes Grid v2.2 e vSphere with Tanzu in vSphere 7

Attenzione

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

Per ulteriori informazioni sulla CLI di Tanzu, inclusi riferimenti ai comandi, vedere la documentazione della CLI di VMware Tanzu.

Prerequisiti

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.2, è 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.

Per utilizzare un cluster supervisore come cluster di gestione, è inoltre necessario:

Download e decompressione della CLI di Tanzu

Scaricare i file della versione compatibile della CLI di Tanzu dalla pagina di download di Tanzu Kubernetes Grid.

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

  2. Passare alla pagina di download di Tanzu Kubernetes Grid.

  3. Nella riga VMware Tanzu Kubernetes Grid fare clic su Vai ai download (Go to Downloads).

  4. Nel menu a discesa Seleziona versione (Select Version) selezionare 2.2.0.

  5. In Download prodotti (Product Downloads), scorrere fino alla sezione denominata CLI di VMware Tanzu 2.2.0.

    macOS
    Individuare CLI di VMware Tanzu per Mac e fare clic su Scarica ora (Download Now).
    Linux
    Individuare CLI di VMware Tanzu per Linux e fare clic su Scarica ora (Download Now).
    Windows
    Individuare CLI di VMware Tanzu per Windows e fare clic su Scarica ora (Download Now).

  6. (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.

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

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

    macOS 
    tar -xvf tanzu-cli-bundle-darwin-amd64.tar.gz
    Linux 
    tar -xvf tanzu-cli-bundle-linux-amd64.tar.gz
    Windows
    Utilizzare lo strumento di estrazione di Windows per decomprimere 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.

Inizializzazione della CLI di Tanzu

Dopo aver scaricato e decompresso la CLI di Tanzu nella macchina di bootstrap, è necessario renderla disponibile per il sistema.

  1. Passare alla sottocartella cli nella cartella tanzu che è stata decompressa nella sezione precedente.

    cd cli

  2. Rendere la CLI disponibile per il sistema:

    macOS
    Installare il file binario in /usr/local/bin: 
    sudo install core/v0.29.0/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
    Linux
    Installare il file binario in /usr/local/bin: 
    sudo install core/v0.29.0/tanzu-core-linux_amd64 /usr/local/bin/tanzu
    Windows
    1. Creare una nuova cartella Program Files\tanzu.
    2. Nella cartella cli decompressa, individuare e copiare il file core\v0.29.0\tanzu-core-windows_amd64.exe nella nuova cartella Program Files\tanzu.
    3. Rinominare tanzu-core-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.

  3. Nella riga di comando in un nuovo terminale, inizializzare la CLI di Tanzu:

    tanzu init

  4. 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.2 utilizza la CLI di Tanzu v0.29.0 che si trova in Tanzu Framework v0.29.0:

    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.

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

    1. Disinstallare i plug-in esistenti:

      tanzu plugin clean

    2. Installare tutti i plug-in per questa versione:

      tanzu plugin sync

    3. Controllare lo stato e la versione dell'installazione del plug-in:

      tanzu plugin list
Nota

Dopo 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 e tanzu kubernetes-release, non sono disponibili e non sono inclusi nell'output --help 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 alla pagina di download di Tanzu Kubernetes Grid.

  3. Nella riga VMware Tanzu Kubernetes Grid fare clic su Vai ai download (Go to Downloads).

  4. Nel menu a discesa Seleziona versione (Select Version) selezionare 2.2.0.

  5. In Download prodotti (Product Downloads), scorrere fino alla sezione denominata Kubectl 1.25.7 for VMware Tanzu Kubernetes Grid 2.2.0.

    macOS
    Individuare kubectl cli v1.25.7 for Mac e fare clic su Scarica ora (Download Now).
    Linux
    Individuare kubectl cli v1.25.7 for Linux e fare clic su Scarica ora (Download Now).
    Windows
    Individuare kubectl cli v1.25.7 for Windows e fare clic su Scarica ora (Download Now).

  6. (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.

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

    macOS 
    gunzip kubectl-mac-v1.25.7+vmware.2.gz
    Linux 
    gunzip kubectl-linux-v1.25.7+vmware.2.gz
    Windows
    Utilizzare lo strumento di estrazione di Windows per decomprimere kubectl-windows-v1.25.7+vmware.2.exe.gz.

  8. Rendere la CLI disponibile per il sistema:

    macOS

    1. Rendere eseguibile il file scaricato:

      chmod ugo+x kubectl-mac-v1.25.7+vmware.2

    2. Installare il file binario in /usr/local/bin:

      sudo install kubectl-mac-v1.25.7+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.25.7+vmware.2

    2. Installare il file binario in /usr/local/bin:

      sudo install kubectl-linux-v1.25.7+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.25.7+vmware.2.exe nella nuova cartella Program Files\kubectl.
    3. Rinominare kubectl-windows-v1.25.7+vmware.1.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.

Guida della CLI di Tanzu

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.

Installazione degli strumenti Carvel

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

Individuazione degli strumenti Carvel

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

  2. Aprire la cartella cli.

    cd cli

Installazione di 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.

macOS

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

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

  3. Eseguire ytt --version per verificare che la versione corretta di ytt sia installata ed eseguibile.

    ytt --version
Linux

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

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

  3. Eseguire ytt --version per verificare che la versione corretta di ytt sia installata ed eseguibile.

    ytt --version
Windows

  1. Decomprimere il file binario ytt.

    gunzip ytt-windows-amd64-v0.43.1+vmware.1.gz

  2. Rinominare ytt-windows-amd64-v0.43.1+vmware.1 con ytt.exe

  3. Creare una nuova cartella Program Files\ytt e copiare il file ytt.exe in tale cartella.
  4. Fare clic con il pulsante destro del mouse sulla cartella ytt, 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 dello strumento ytt.
  9. Nella riga di comando in un nuovo terminale, eseguire ytt version per verificare che sia installata la versione corretta di ytt.


Installazione di kapp

kapp è la CLI di distribuzione delle applicazioni per Kubernetes. Consente di installare, aggiornare ed eliminare più risorse Kubernetes come un'unica applicazione.

macOS

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

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

  3. Eseguire kapp --version per verificare che la versione corretta di kapp sia installata ed eseguibile.

    kapp --version
Linux

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

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

  3. Eseguire kapp --version per verificare che la versione corretta di kapp sia installata ed eseguibile.

    kapp --version
Windows

  1. Decomprimere il file binario kapp.

    gunzip kapp-windows-amd64-v0.53.2+vmware.1.gz

  2. Rinominare kapp-windows-amd64-v0.53.2+vmware.1 con kapp.exe

  3. Creare una nuova cartella Program Files\kapp e copiare il file kapp.exe in tale cartella.
  4. Fare clic con il pulsante destro del mouse sulla cartella kapp, 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 dello strumento kapp.
  9. Nella riga di comando in un nuovo terminale, eseguire kapp version per verificare che sia installata la versione corretta di kapp.


Installazione di kbld

kbld è uno strumento per la creazione e la risoluzione di immagini.

macOS

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

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

  3. Eseguire kbld --version per verificare che la versione corretta di kbld sia installata ed eseguibile.

Linux

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

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

  3. Eseguire kbld --version per verificare che la versione corretta di kbld sia installata ed eseguibile.

    kbld --version
Windows

  1. Decomprimere il file binario kbld.

    gunzip kbld-windows-amd64-v0.35.1+vmware.1.gz

  2. Rinominare kbld-windows-amd64-v0.35.1+vmware.1 con kbld.exe

  3. Creare una nuova cartella Program Files\kbld e copiare il file kbld.exe in tale cartella.
  4. Fare clic con il pulsante destro del mouse sulla cartella kbld, 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 dello strumento kbld.
  9. Nella riga di comando in un nuovo terminale, eseguire kbld version per verificare che sia installata la versione corretta di kbld.


Installazione di 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.

macOS

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

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

  3. Eseguire imgpkg --version per verificare che la versione corretta di imgpkg sia installata ed eseguibile.

    imgpkg --version
Linux

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

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

  3. Eseguire imgpkg --version per verificare che la versione corretta di imgpkg sia installata ed eseguibile.

    imgpkg --version
Windows

  1. Decomprimere il file binario imgpkg.

    gunzip imgpkg-windows-amd64-v0.31.1+vmware.1.gz

  2. Rinominare imgpkg-windows-amd64-v0.31.1+vmware.1 con imgpkg.exe

  3. Creare una nuova cartella Program Files\imgpkg e copiare il file imgpkg.exe in tale cartella.
  4. Fare clic con il pulsante destro del mouse sulla cartella imgpkg, 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 dello strumento imgpkg.
  9. Nella riga di comando in un nuovo terminale, eseguire imgpkg version per verificare che sia installata la versione corretta di imgpkg.


Passaggi successivi

Prima di poter utilizzare la CLI di Tanzu, kubectl e gli strumenti Carvel 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.

connessione della CLI di Tanzu al supervisore

Per registrare il supervisore nella CLI di Tanzu e quindi accedere al supervisore, eseguire le operazioni seguenti. Il supervisore deve essere registrato nella CLI di Tanzu una sola volta. Dopo aver registrato il supervisore, è possibile passare al passaggio tanzu login.

  1. Recuperare l'indirizzo IP del supervisore da vCenter

    1. Nella vista Host e cluster (Hosts and Clusters), selezionare il data center che ospita il supervisore.
    2. In Spazi dei nomi (Namespaces), selezionare lo spazio dei nomi che contiene o è adiacente alle tre istanze di SupervisorControlPlaneVM.
    3. Nel riquadro principale, in Riepilogo (Summary) > Stato (Status) > Collegamento a strumenti CLI (Link to CLI Tools), fare clic su Copia collegamento (Copy Link) e registrare l'URL, ad esempio https://192.168.123.3.

  2. Nessun IDP: se non si utilizza un provider di identità esterno:

    1. (Facoltativo) Installare e configurare il plug-in kubectl vsphere con un certificato attendibile, come descritto in Configurazione dell'accesso sicuro per i cluster vSphere with Tanzu.

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

      Attenzione

      utilizzare l'accesso non sicuro solo in un ambiente di sviluppo.

    3. Immettere la password utilizzata per accedere a vCenter.

      Una volta effettuato l'accesso, il comando kubectl vsphere login:

      • Crea o modifica il file kubeconfig per aggiungere un token che esegue l'autenticazione con l'API di Kubernetes
      • Elenca tutti i contesti di Kubernetes a cui si ha accesso. Questo elenco deve includere l'indirizzo IP del supervisore.

    4. Impostare 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.

  3. Raccogliere informazioni per eseguire il comando tanzu login, che si connette al supervisore:

    • Specificare un nome per la CLI di tanzu da utilizzare per il supervisore.
    • Percorso del file kubeconfig locale, che per impostazione predefinita è ~/.kube/config e viene impostato dalla variabile di ambiente KUBECONFIG.

  4. Eseguire il comando tanzu login passando i valori precedenti, ad esempio:

    Nessun IDP:

    tanzu login --name my-supervisor --kubeconfig ~/.kube/config --context 192.168.123.3

    Dopo aver effettuato l'accesso, la CLI scarica i plug-in specifici del supervisore.

    ???  successfully logged in to management cluster using the kubeconfig my-supervisor
Checking for required plugins...
Installing plugin 'cluster:v0.25' with target 'kubernetes'
Installing plugin 'feature:v0.25' with target 'kubernetes'
Installing plugin 'kubernetes-release:v0.25' with target 'kubernetes'
Installing plugin 'namespaces:v1.0.0' with target 'kubernetes'
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

    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.

  5. Verificare che il supervisore sia stato aggiunto eseguendo tanzu config server list, ad esempio:

    tanzu config server list

    NAME           TYPE               ENDPOINT                   PATH                       CONTEXT
my-supervisor  managementcluster  https://192.168.123.3:443  /home/vmware/.kube/config  192.168.123.3

    tanzu login dovrebbe ora elencare il supervisore con il nome specificato:

    tanzu login

    ? Select a server  [Use arrows to move, type to filter]
> my-supervisor  ()
 + new server

  6. Eseguire tanzu plugin list per visualizzare l'elenco dei plug-in specifici del supervisore, nonché i plug-in principali della CLI.

    tanzu plugin list

    Standalone Plugins
  NAME                DESCRIPTION                                                        TARGET      DISCOVERY  VERSION   STATUS
  isolated-cluster    isolated-cluster operations                                                    default    v0.29.0   installed
  login               Login to the platform                                                          default    v0.29.0   installed
  pinniped-auth       Pinniped authentication operations (usually not directly invoked)              default    v0.29.0   installed
  management-cluster  Kubernetes management-cluster operations                           kubernetes  default    v0.29.0   installed
  package             Tanzu package management                                           kubernetes  default    v0.29.0   installed
  secret              Tanzu secret management                                            kubernetes  default    v0.29.0   installed
  telemetry           Configure cluster-wide telemetry settings                          kubernetes  default    v0.29.0   installed

Plugins from Context:  my-supervisor
  NAME                DESCRIPTION                                                TARGET      VERSION  STATUS
  cluster             Kubernetes cluster operations                              kubernetes  v0.25.0  installed
  feature             Operate on features and featuregates                       kubernetes  v0.25.0  installed
  kubernetes-release  Kubernetes release operations                              kubernetes  v0.25.0  installed
  namespaces          Discover vSphere Supervisor namespaces you have access to  kubernetes  v1.0.0   installed
    Nota

    Nell'esempio precedente, la versione dei plug-in autonomi, ad esempio login e pinniped-auth, che sono stati installati durante l'installazione della CLI di Tanzu, è v0.29.0. La versione dei plug-in del contesto del supervisore, che sono stati installati al momento della connessione della CLI di Tanzu al supervisore, ad esempio cluster o kubernetes-release, è v0.25.0. Ciò è dovuto al fatto che il supervisore in vSphere with Tanzu esegue TKG 2.0 e non TKG 2.2. Tuttavia, i plug-in v0.25.0 sono completamente compatibili con la versione v0.29.0 della CLI di Tanzu e con i plug-in autonomi e sono supportati da tali plug-in e CLI.

  7. (Facoltativo) Passare a Creazione di cluster del carico di lavoro.
check-circle-line exclamation-circle-line close-line
Scroll to top icon