Distribuzione di cluster di gestione autonomi

Questa sezione include informazioni su come distribuire un cluster di gestione autonomo di Tanzu Kubernetes Grid. La distribuzione di un cluster di gestione completa il processo di installazione di Tanzu Kubernetes Grid per renderlo operativo.

Dopo aver eseguito i passaggi descritti in Installazione della CLI di Tanzu e della CLI di Kubernetes per l'utilizzo con cluster di gestione autonomi, è possibile distribuire cluster di gestione in vSphere 6.7, vSphere 7, vSphere 8, AWS o Azure.

Importante
In vSphere with Tanzu in vSphere 8, è possibile utilizzare la CLI di Tanzu per connettersi al supervisore integrato e distribuire i cluster del carico di lavoro di TKG 2.x. Non è quindi necessario distribuire un cluster di gestione. Per informazioni, vedere Il supervisore di vSphere with Tanzu è un cluster di gestione. La distribuzione di un cluster di gestione autonomo in vSphere 8 quando vSphere with Tanzu non è abilitato è supportata, ma l'opzione preferita consiste nell'abilitare vSphere with Tanzu e utilizzare il supervisore se possibile.

Il cluster di gestione è un cluster Kubernetes che esegue le operazioni di Cluster API in un provider di cloud specifico per creare e gestire i cluster del carico di lavoro in tale provider. Nel cluster di gestione vengono inoltre configurati i servizi condivisi e interni al cluster utilizzati dai cluster del carico di lavoro.

Nota
VMware consiglia di non distribuire mai carichi di lavoro nel cluster di gestione autonomo stesso perché:

I cluster di gestione autonomi e i cluster del carico di lavoro hanno caratteristiche distinte.

I cluster di gestione autonomi non vengono sottoposti a backup come i cluster del carico di lavoro. Per garantire la resilienza, è consigliabile gestire la configurazione del cluster di gestione autonomo come codice.

Processo di distribuzione del cluster

Il diagramma seguente illustra i passaggi generali per la distribuzione dei cluster di gestione e dei cluster del carico di lavoro per diversi provider IaaS, ad esempio vSphere 6.7, 7 e 8, AWS e Azure, nonché le interfacce utilizzate per eseguirli.

Distribuire il cluster di gestione e i cluster del carico di lavoro, installare la CLI di Tanzu, selezionare l'interfaccia utente o il file di configurazione e selezionare IaaS

Interfaccia utente del programma di installazione e CLI

È possibile distribuire un cluster di gestione in due modi:

Eseguire il programma di installazione di Tanzu Kubernetes Grid, ovvero l'interfaccia di una procedura guidata che consente di eseguire il processo di distribuzione di un cluster di gestione. Questo è il metodo consigliato.
Creare e modificare un file di configurazione YAML e utilizzarli per distribuire un cluster di gestione con la CLI di Tanzu.
- Questo metodo di distribuzione è necessario per le configurazioni del cluster di gestione come:
  - Rete IPv6
  - Rete dual stack
  - Criteri di storage personalizzati, impostati da VSPHERE_STORAGE_POLICY_ID
  - IPAM del nodo per il cluster di gestione
- È possibile creare un nuovo file di configurazione YAML oppure eseguire l'interfaccia del programma di installazione, fare clic su Rivedi configurazione (Review Configuration) > Esporta configurazione (Export Configuration) e modificare il file di configurazione generato dall'interfaccia del programma di installazione.

Piattaforme

È possibile distribuire e gestire cluster di gestione autonomi di Tanzu Kubernetes Grid in:

vSphere 6.7u3
vSphere 7, se il cluster supervisore non è abilitato.
vSphere 8, se il supervisore non è abilitato.
Amazon Web Services (AWS)
Microsoft Azure

È possibile distribuire il cluster di gestione come piano di controllo a nodo singolo, per lo sviluppo o come piano di controllo a più nodi ad alta disponibilità, per gli ambienti di produzione.

Per informazioni sulla configurazione richiesta per la distribuzione del cluster di gestione nell'infrastruttura desiderata, vedere Requisiti del cluster di gestione autonomo.
Dopo aver configurato l'infrastruttura, vedere Distribuzione dei cluster di gestione con l'interfaccia del programma di installazione o Distribuzione di cluster di gestione da un file di configurazione.
Dopo aver distribuito un cluster di gestione nella piattaforma desiderata, per controllare la distribuzione e registrare il cluster di gestione distribuito in Tanzu Mission Control, vedere Controllo e registrazione di un cluster di gestione autonomo appena distribuito.
Dopo aver distribuito uno o più cluster di gestione in una o più piattaforme, utilizzare la CLI di Tanzu per la Gestione dei cluster di gestione.
Se necessario, è possibile eseguire il Backup e ripristino dell'infrastruttura di cluster di gestione e del carico di lavoro.

Cluster di gestione e relativi file di configurazione

Distribuire il cluster di gestione eseguendo il comando tanzu mc create nella macchina di bootstrap. Per distribuire un cluster di gestione, è necessario specificare l'opzione --ui o --file con tanzu mc create.

Interfaccia del programma di installazione: tanzu mc create --ui crea il cluster di gestione con l'interfaccia del programma di installazione e salva le impostazioni dall'input del programma di installazione in un file di configurazione del cluster ~/.config/tanzu/tkg/clusterconfigs/UNIQUE-ID.yaml, in cui UNIQUE-ID è un nome di file generato. Il programma di installazione genera inoltre una specifica di oggetto basato sulla classe di tipo Kubernetes per l'oggetto Cluster del cluster di gestione, che viene salvato in un file con lo stesso nome del cluster di gestione. Questa specifica dell'oggetto basato sulla classe viene fornita solo a scopo informativo. La distribuzione di cluster di gestione dalla specifica di un oggetto basato sulla classe non è ancora supportata. Per ulteriori informazioni sui tipi di cluster in TKG 2.x, vedere Cluster del carico di lavoro in Informazioni su Tanzu Kubernetes Grid.
CLI: tanzu mc create --file crea il cluster di gestione utilizzando un file di configurazione del cluster. Prima di eseguire tanzu mc create, impostare parametri di configurazione, come INFRASTRUCTURE_PROVIDER, nel file di configurazione del cluster e quindi passarlo all'opzione --file. La procedura consigliata consiste nell'utilizzare un file di configurazione dedicato per ogni cluster di gestione distribuito.

È inoltre possibile impostare parametri di configurazione come variabili di ambiente. Se si impostano parametri in conflitto, le variabili di ambiente sostituiscono i parametri di configurazione impostati nel file passato all'opzione --file:

Variabili di ambiente locali: persistono oltre la sessione di un terminale. Queste variabili sostituiscono anche le variabili di ambiente nel file di configurazione della CLI di Tanzu, ~/.config/tanzu/config.yaml.
Variabili di ambiente in ~/.config/tanzu/config.yaml, impostate eseguendo tanzu config set: persistono finché non ne viene annullata l'impostazione eseguendo tanzu config unset.

Il comando tanzu mc create utilizza queste origini e input nel seguente ordine di precedenza crescente:

~/.config/tanzu/tkg/providers/config_default.yaml: Questo file contiene i valori predefiniti del sistema e non deve essere modificato.
Con l'opzione --file: il file di configurazione del cluster, che per impostazione predefinita è ~/.config/tanzu/tkg/cluster-config.yaml. Questo file configura chiamate specifiche di tanzu mc create. Utilizzare file di configurazione diversi per salvare più configurazioni.
Variabili di ambiente impostate eseguendo tanzu config set: File ~/.config/tanzu/config.yaml. Queste variabili vengono applicate a tutti i comandi tanzu. Le variabili di ambiente locali sostituiscono le variabili di ~/.config/tanzu/config.yaml.
Variabili di ambiente locali: le impostazioni dei parametri nell'ambiente locale sostituiscono le impostazioni dei file di configurazione. Utilizzarle per effettuare scelte di configurazione rapide senza dover eseguire ricerche e modifiche in un file di configurazione.
Con l'opzione --ui: input dell'interfaccia del programma di installazione. Quando si esegue tanzu mc create --ui, il programma di installazione imposta tutti i valori di configurazione del cluster di gestione dall'input dell'utente.

Che cosa succede quando si crea un cluster di gestione

L'esecuzione di tanzu mc create crea un cluster di gestione temporaneo utilizzando un cluster Kubernetes nel Docker (kind) nella macchina di bootstrap. Dopo aver creato il cluster di gestione temporaneo in locale, Tanzu Kubernetes Grid lo utilizza per eseguire il provisioning del cluster di gestione finale nella piattaforma desiderata.

Nel processo, tanzu mc create crea o modifica i file di configurazione e stato della CLI nella directory home dell'utente nella macchina di bootstrap locale:

Posizione	Contenuto	Modifica
`~/.config/tanzu/tkg/bom/`	File Bill of Materials (BoM) in cui sono elencate versioni specifiche di tutti i pacchetti che Tanzu Kubernetes Grid richiede quando crea un cluster con un sistema operativo e una versione di Kubernetes specifici. Tanzu Kubernetes Grid viene aggiunto a questa directory quando vengono pubblicate nuove versioni di Tanzu Kubernetes.	Aggiungerlo se non è già presente
`~/.config/tanzu/tkg/providers/`	File dei modelli di configurazione per Cluster API, i provider di cloud e altre dipendenze, organizzati con overlay `ytt` per la modifica non distruttiva.	Aggiungerlo se non è già presente
`~/.config/tanzu/tkg/providers-TIMESTAMP-HASH/`	Backup delle directory di `/providers` da installazioni precedenti.	Aggiungerla se non si tratta della prima installazione
`~/.config/tanzu/config.yaml`	Nomi, contesti e posizioni dei file di certificati per i cluster di gestione noti alla CLI di Tanzu e qual è quello corrente. In questo file sono inoltre elencate le origini di individuazione per i plug-in della CLI di Tanzu, le variabili di ambiente impostate da `tanzu config set` e le funzionalità attivate o disattivate per impostazione predefinita nella CLI di Tanzu.	Aggiungere nuove informazioni sul cluster di gestione e impostarlo come `current`.
`~/.config/tanzu/tkg/cluster-config.yaml`	File di configurazione del cluster predefinito utilizzato dai comandi `tanzu cluster create` e `tanzu mc create` se non ne viene specificato uno con `–file`. La procedura consigliata consiste nell'utilizzare un file di configurazione univoco per ogni cluster.	Aggiungere un file vuoto se non già presente.
`~/.config/tanzu/tkg/clusterconfigs/IDENTIFIER.yaml`	File di configurazione del cluster flat in cui `tanzu mc create –ui` scrive i valori dell'input dell'interfaccia del programma di installazione. `IDENTIFIER` è un identificatore univoco generato dal programma di installazione.	Creare il file
`~/.config/tanzu/tkg/clusterconfigs/MGMT-CLUSTER-NAME.yaml`	File di configurazione del cluster basato sulla classe che `tanzu mc create –ui` genera in base al file di configurazione flat.	Creare il file
`~/.config/tanzu/tkg/config.yaml`	Elenco delle configurazioni e delle posizioni per Tanzu Kubernetes Grid core e tutti i relativi provider.	Aggiungerla se non è già presente
`~/.config/tanzu/tkg/providers/config.yaml`	Simile a `~/.config/tanzu/tkg/config.yaml`, ma elenca solo i provider e le configurazioni nella directory `~/.config/tanzu/tkg/providers`, non i file di configurazione utilizzati da Tanzu Kubernetes Grid core.	Aggiungerlo se non è già presente
`~/.config/tanzu/tkg/providers/config_default.yaml`	Configurazioni predefinite a livello di sistema per i provider. È consigliabile non modificare questo file, ma modificare le configurazioni del provider tramite file di overlay `ytt`.	Aggiungerla se non è già presente
`~/.kube-tkg/config`	File `kubeconfig` del cluster di gestione contenente nomi e certificati per i cluster di gestione noti alla CLI di `tanzu`. Posizione sostituita dalla variabile di ambiente `KUBECONFIG`.	Aggiungere nuove informazioni sul cluster di gestione e impostare il cluster come `current-context`.
`~/.kube/config`	Configurazione e stato per la CLI di `kubectl`, inclusi tutti i cluster di gestione e del carico di lavoro, nonché informazioni sul contesto corrente.	Aggiungere il nome, il contesto e le informazioni del certificato del nuovo cluster di gestione. Non modificare il contesto di `kubectl` corrente nel nuovo cluster.