È possibile eseguire il provisioning dei cluster di Tanzu Kubernetes richiamando l'API dichiarativa Servizio Tanzu Kubernetes Grid utilizzando kubectl e una specifica del cluster definita utilizzando YAML. Dopo aver eseguito il provisioning di un cluster, è possibile utilizzarlo e distribuirvi i carichi di lavoro utilizzando kubectl.
Il workflow fornisce una procedura end-to-end per il processo di provisioning del cluster. Ciascuno dei passaggi include collegamenti per ulteriori informazioni sull'attività specifica.
Prerequisiti
Completare le seguenti operazioni per ottenere i prerequisiti richiesti:
Procedura
- Scaricare e installare Strumenti CLI Kubernetes di vSphere. Vedere Download e installazione di Strumenti CLI Kubernetes di vSphere.
- Utilizzando Plug-in vSphere per kubectl, eseguire l'autenticazione con il Cluster supervisore. Vedere Connessione al Cluster supervisore come utente vCenter Single Sign-On.
kubectl vsphere login --server=IP-ADDRESS --vsphere-username USERNAME
- Utilizzando kubectl, cambiare contesto nel Spazio dei nomi vSphere in cui si intende eseguire il provisioning del cluster di Tanzu Kubernetes.
kubectl config get-contexts
kubectl config use-context SUPERVISOR-NAMESPACE
Ad esempio:
kubectl config use-context tkgs-cluster-ns
- Elencare i binding delle classi di macchine virtuali disponibili. Vedere Classi di macchine virtuali per i cluster di Tanzu Kubernetes.
Utilizzare il comando seguente per elencare tutti i binding delle classi di macchine virtuali disponibili nel
Spazio dei nomi vSphere in cui si distribuisce il cluster.
kubectl get virtualmachineclassbindings
Nota: Il comando
kubectl get virtualmachineclasses elenca tutte le classi di macchine virtuali presenti nel
Cluster supervisore. Poiché è necessario associare classi di macchine virtuali al
Spazio dei nomi vSphere, è possibile utilizzare solo le classi di macchine virtuali associate allo spazio dei nomi di destinazione.
- Ottenere la classe di storage predefinita disponibile descrivendo lo spazio dei nomi.
kubectl describe namespace SUPERVISOR-NAMESPACE
- Elencare le Release di Tanzu Kubernetes disponibili.
kubectl get tanzukubernetesreleases
Nota: Il comando
kubectl get virtualmachineimages restituisce informazioni generice sulle macchine virtuali.
- Creare il file YAML per il provisioning di un cluster di Tanzu Kubernetes.
- Iniziare con uno dei file YAML di esempio. Vedere Esempi di provisioning dei cluster Tanzu Kubernetes mediante l'API v1alpha1 del Servizio Tanzu Kubernetes Grid.
Ad esempio, il seguente file YAML esegue il provisioning di un cluster minimo utilizzando tutti i valori predefiniti disponibili:
apiVersion: run.tanzu.vmware.com/v1alpha1 #TKGS API endpoint
kind: TanzuKubernetesCluster #required parameter
metadata:
name: tkgs-cluster-1 #cluster name, user defined
namespace: tgks-cluster-ns #vsphere namespace
spec:
distribution:
version: v1.19 #Resolves to latest TKR 1.19 version
topology:
controlPlane:
count: 1 #number of control plane nodes
class: best-effort-medium #vmclass for control plane nodes
storageClass: vwt-storage-policy #storageclass for control plane
workers:
count: 3 #number of worker nodes
class: best-effort-medium #vmclass for worker nodes
storageClass: vwt-storage-policy #storageclass for worker nodes
- Utilizzare le informazioni raccolte dall'output dei comandi precedenti per popolare il file YAML del cluster, inclusi lo spazio dei nomi, la classe di storage e la classe di macchine virtuali.
- Personalizzare il cluster in base alle esigenze facendo riferimento all'elenco completo dei parametri di configurazione del cluster. Vedere Parametri di configurazione per i cluster di Tanzu Kubernetes che utilizzano l'API v1alpha1 di Servizio Tanzu Kubernetes Grid.
- Salvare il file come
tkgs-cluster-1.yaml o simile.
- Eseguire il provisioning del cluster eseguendo il comando kubectl seguente.
kubectl apply -f CLUSTER-NAME.yaml
Ad esempio:
kubectl apply -f tkgs-cluster-1.yaml
Risultato previsto:
tanzukubernetescluster.run.tanzu.vmware.com/tkgs-cluster-1 created
- Monitorare la distribuzione dei nodi del cluster mediante kubectl. Vedere Monitorare lo stato dei cluster Tanzu Kubernetes mediante kubectl.
kubectl get tanzukubernetesclusters
Risultato dell'esempio:
NAME CONTROL PLANE WORKER DISTRIBUTION AGE PHASE
tkgs-cluster-2 1 3 v1.19.7+vmware.1-tkg.1.c40d30d 7m59s running
- Monitorare la distribuzione dei nodi del cluster utilizzando vSphere Client. Vedere Monitorare lo stato dei cluster Tanzu Kubernetes mediante vSphere Client.
Ad esempio, nell'inventario di vSphere è necessario visualizzare i nodi delle macchine virtuali distribuiti nello spazio dei nomi.
- Eseguire comandi aggiuntivi per verificare il provisioning del cluster. Vedere la pagina sull'uso dei comenti operativi dei cluster di Tanzu Kubernetes.
Ad esempio:
kubectl get tanzukubernetescluster,cluster-api,virtualmachinesetresourcepolicy,virtualmachineservice,virtualmachine
- Utilizzando Plug-in vSphere per kubectl, accedere al cluster. Vedere Connessione a un cluster Tanzu Kubernetes come utente vCenter Single Sign-On.
kubectl vsphere login --server=IP-ADDRESS --vsphere-username USERNAME \
--tanzu-kubernetes-cluster-name CLUSTER-NAME --tanzu-kubernetes-cluster-namespace NAMESPACE-NAME
- Verificare il provisioning del cluster utilizzando i comandi kubectl seguenti.
kubectl cluster-info
kubectl get nodes
kubectl get namespaces
kubectl api-resources
- Distribuire un carico di lavoro di esempio e verificare la creazione del cluster. Vedere Distribuzione di carichi di lavoro nei cluster Tanzu Kubernetes.
- Rendere operativo il cluster distribuendo le estensioni TKG. Vedere Distribuzione delle estensioni TKG nei cluster Tanzu Kubernetes.
