File di configurazione del cluster di amministrazione 1.30 e versioni successive

Questo documento descrive i campi del file di configurazione del cluster di amministrazione per Google Distributed Cloud versione 1.30 e successive.

Generazione di un modello per il file di configurazione

Se hai utilizzato gkeadm per creare la workstation di amministrazione, gkeadm ha generato un modello per il file di configurazione del cluster di amministrazione. Inoltre, gkeadm ha compilato alcuni campi per te.

Se non hai utilizzato gkeadm per creare la tua workstation di amministrazione, puoi utilizzare gkectl per generare un modello per il file di configurazione del cluster di amministrazione.

Per generare un template per il file di configurazione del cluster di amministrazione:

gkectl create-config admin --config=OUTPUT_FILENAME --gke-on-prem-version=VERSION

Sostituisci quanto segue:

  • OUTPUT_FILENAME: un percorso di tua scelta per il template generato. Se ometti questo flag, gkectl assegna al file il nome admin-cluster.yaml e lo inserisce nella directory corrente.

  • VERSION: il numero di versione di Google Distributed Cloud. Ad esempio: gkectl create-config admin --gke-on-prem-version=1.36.200-gke.118. Questa versione deve essere uguale o precedente alla versione di gkectl. Se ometti questo flag, il template di configurazione generato viene compilato con valori basati sulla patch 1.36 più recente.

Modello

Campi obbligatori e valori predefiniti

Se un campo è contrassegnato come Obbligatorio, il file di configurazione completato deve contenere un valore per il campo.

Se per un campo viene fornito un valore Predefinito, il cluster utilizzerà quel valore se non inserisci nulla nel campo. Puoi eseguire l'override di un valore predefinito inserendo un valore.

Se un campo non è contrassegnato come obbligatorio, è facoltativo. Puoi compilarlo se è pertinente per te, ma non è obbligatorio.

Compilazione del file di configurazione

Nel file di configurazione, inserisci i valori dei campi come descritto nelle sezioni seguenti.

enableAdvancedCluster

1.33 e successive

Tutti i nuovi cluster vengono creati come cluster avanzati. Se includi questo campo nel file di configurazione durante la creazione di un nuovo cluster, deve essere impostato su true. Se imposti questo campo su false, la creazione del cluster verrà bloccata.

1.32

Facoltativo
Modificabile (da false a true è consentito)
Booleano
Precompilato: true
Valore predefinito: true

Imposta enableAdvancedCluster su false se non vuoi attivare il cluster avanzato durante la creazione di un nuovo cluster. Quando questo flag è impostato su true (cluster avanzato abilitato), il software Google Distributed Cloud esegue il deployment di controller che consentono un'architettura più estensibile. L'attivazione del cluster avanzato ti consente di accedere a nuove funzionalità, come i domini di topologia. Questo campo è obbligatorio se è configurato infraConfigFilePath.

Assicurati di esaminare le differenze durante l'esecuzione di cluster avanzati prima di attivare il cluster avanzato.

Per aggiornare un cluster esistente a un cluster avanzato, consulta Aggiorna un cluster a un cluster avanzato. Dopo l'aggiornamento al cluster avanzato, la disattivazione non è consentita.

1,31

Disponibile solo per i nuovi cluster
Anteprima
Facoltativo
Immutabile
Booleano
Precompilato: false
Valore predefinito: false

Imposta enableAdvancedClusters su true per abilitare il cluster avanzato durante la creazione di un nuovo cluster. Quando questo flag è abilitato, il software Google Distributed Cloud sottostante esegue il deployment di controller che consentono un'architettura più estensibile. L'attivazione del cluster avanzato ti consente di accedere a nuove funzionalità, come i domini di topologia. Questo campo è obbligatorio se è configurato infraConfigFilePath.

1.30 e versioni precedenti

Non disponibile.

name

Facoltativo
Stringa
Valore predefinito: un nome casuale che inizia con il prefisso "gke-admin-"

Un nome scelto da te per il cluster.

Esempio:

name: "my-admin-cluster"

bundlePath

Obbligatorio
Modificabile
Stringa

Il percorso del file del bundle Google Distributed Cloud. Puoi specificare un bundle completo o un bundle normale. Per un confronto dettagliato, consulta Informazioni sui bundle di Google Distributed Cloud.

Quando crei una workstation di amministrazione, questa viene preinstallata con un bundle completo:

/var/lib/gke/bundles/gke-onprem-vsphere-VERSION-full.tgz

Esempio di pacchetto completo:

bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.30.0-gke.1-full.tgz"

Se preferisci utilizzare un bundle normale (che richiede il download delle immagini in fase di runtime), specifica il relativo percorso dopo averlo scaricato:

Esempio di bundle normale:

bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.30.0-gke.1.tgz"

preparedSecrets.enabled

Se infraConfigFilePath è configurato, rimuovi questo campo.

Anteprima
Facoltativo
Immutabile
Booleano
Precompilato: false
Valore predefinito: false

Imposta questo valore su true se vuoi utilizzare le credenziali preparate nel cluster di amministrazione. In caso contrario, impostalo su false o ometti il campo.

Esempio:

preparedSecrets:
  enabled: true

vCenter

Questa sezione contiene informazioni sull'ambiente vSphere e sulla connessione al server vCenter.

Se infraConfigFilePath è configurato, rimuovi l'intera sezione. In caso contrario, questa sezione è obbligatoria e immutabile.

vCenter.address

Obbligatorio
Immutabile
Stringa

L'indirizzo IP o il nome host del server vCenter.

Per saperne di più, consulta Individuazione dell'indirizzo del server vCenter.

Esempi:

vCenter:
  address: "203.0.113.100"

vCenter:
  address: "my-vcenter-server.my-domain.example"

vCenter.datacenter

Obbligatorio
Immutabile
Stringa

Il percorso relativo di un data center vSphere.

Il valore specificato è relativo alla cartella principale denominata /.

Se il data center si trova nella cartella principale, il valore è il nome del data center.

Esempio:

vCenter:
  datacenter: "my-data-center"

In caso contrario, il valore è un percorso relativo che include una o più cartelle insieme al nome del data center.

Esempio:

vCenter:
  datacenter: "data-centers/data-center-1"

vCenter.cluster

Obbligatorio
Immutabile
Stringa

Il percorso relativo di un cluster vSphere che rappresenta gli host ESXi in cui verranno eseguite le VM del cluster di amministrazione. Questo cluster vSphere rappresenta un sottoinsieme degli host ESXi fisici nel tuo data center vCenter.

Il valore specificato è relativo a /.../DATA_CENTER/vm/.

Se il cluster vSphere si trova nella cartella /.../DATA_CENTER/vm/, il valore è il nome del cluster vSphere.

Esempio:

vCenter:
  cluster: "my-vsphere-cluster"

In caso contrario, il valore è un percorso relativo che include una o più cartelle insieme al nome del cluster vSphere.

Esempio:

vCenter:
  cluster: "clusters/vsphere-cluster-1"

vCenter.resourcePool

Obbligatorio
Immutabile
Stringa

Un pool di risorse vCenter per le VM del cluster di amministrazione.

Se vuoi utilizzare il pool di risorse predefinito, imposta questo valore su VSPHERE_CLUSTER/Resources.

Esempio:

vCenter:
  resourcePool: "my-vsphere-cluster/Resources"

Se vuoi utilizzare un pool di risorse che hai già creato, imposta questo valore sul percorso relativo del pool di risorse.

Il valore specificato è relativo a /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/

Se il pool di risorse è un elemento secondario diretto di /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/ il valore è il nome del pool di risorse.

Esempio:

vCenter:
  resourcePool: "my-resource-pool"

In caso contrario, il valore è un percorso relativo che ha due o più pool di risorse.

Esempio:

vCenter:
  resourcePool: "resource-pool-1/resource-pool-2"

vCenter.datastore

Obbligatorio se vCenter.storagePolicyName non è specificato
Immutabile
Stringa

Il nome di un datastore vSphere per il cluster di amministrazione.

Il valore specificato deve essere un nome, non un percorso. Non includere cartelle nel valore.

Esempio:

vCenter:
  datastore: "my-datastore"

Devi specificare un valore per vCenter.datastore o vCenter.storagePolicyName, ma non per entrambi. Se specifichi un valore per questo campo, non specificare un valore per vCenter.storagePolicyName. Il campo vCenter.datastore è immutabile, tranne quando lo imposti su una stringa vuota durante la migrazione di un datastore alla gestione basata su policy di archiviazione (SPBM).

vCenter.storagePolicyName

Obbligatorio se vCenter.datastore non è specificato
Immutabile
Stringa

Il nome di una policy di archiviazione delle VM per i nodi del cluster.

Il cluster di amministrazione deve essere ad alta affidabilità (HA) per funzionare con la policy di archiviazione.

Per saperne di più, consulta Configura una policy di archiviazione.

Devi specificare un valore per vCenter.datastore o vCenter.storagePolicyName, ma non per entrambi. Se specifichi un valore per questo campo, non specificare un valore per vCenter.datastore.

vCenter.caCertPath

Obbligatorio
Modificabile
Stringa

Il percorso del certificato CA per il server vCenter.

Per saperne di più, consulta Recupero del certificato CA vCenter.

Per informazioni sull'aggiornamento di questo campo per un cluster esistente, consulta Aggiorna i riferimenti ai certificati vCenter.

Esempio:

vCenter:
  caCertPath: "/usr/local/google/home/me/certs/vcenter-ca-cert.pem"

vCenter.credentials.fileRef.path

Obbligatorio
Stringa

Il percorso di un file di configurazione delle credenziali che contiene il nome utente e la password del tuo account utente vCenter. L'account utente deve disporre del ruolo Amministratore o di privilegi equivalenti. Consulta i requisiti di vSphere.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali vCenter, consulta Aggiornamento delle credenziali del cluster.

Esempio:

vCenter:
  credentials:
    fileRef:
      path: "my-config-folder/admin-creds.yaml"

vCenter.credentials.fileRef.entry

Obbligatorio
Stringa

Il nome del blocco di credenziali, nel file di configurazione delle credenziali, che contiene il nome utente e la password del tuo account utente vCenter.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali vCenter, consulta Aggiornamento delle credenziali del cluster.

Esempio:

vCenter:
  credentials:
    fileRef:
      entry: "vcenter-creds"

vCenter.folder

Facoltativo
Immutabile
Stringa
Valore predefinito: la cartella a livello di data center

Il percorso relativo di una cartella vSphere che hai già creato. Questa cartella conterrà le VM del cluster di amministrazione.

Se non specifichi un valore, le VM del cluster di amministrazione verranno inserite in /.../DATA_CENTER/vm/.

Se specifichi un valore, questo è relativo a /.../DATA_CENTER/vm/.

Il valore può essere il nome di una cartella.

Esempio:

vCenter:
  folder: "my-folder"

In alternativa, il valore può essere un percorso relativo che include più di una cartella.

Esempio:

vCenter:
  folder: "folders/folder-1"

vCenter.dataDisk

Non specificare un valore per questo campo. Elimina il campo o lascialo commentato.

network

Obbligatorio
Immutabile

Questa sezione contiene informazioni sulla rete del cluster di amministrazione.

network.hostConfig

Questa sezione contiene informazioni sui server NTP, sui server DNS e sui domini di ricerca DNS utilizzati dalle VM corrispondenti ai nodi del cluster.

Se infraConfigFilePath è configurato, rimuovi l'intera sezione. In caso contrario, questa sezione è obbligatoria e immutabile.

network.hostConfig.dnsServers

Obbligatorio se la sezione network.hostConfig è compilata.
Immutabile
Array di stringhe.
Il numero massimo di elementi nell'array è tre.

Gli indirizzi dei server DNS delle VM.

Esempio:

network:
  hostConfig:
    dnsServers:
    - "172.16.255.1"
    - "172.16.255.2"

network.hostConfig.ntpServers

Obbligatorio se la sezione network.hostConfig è compilata.
Immutabile
Array di stringhe

Gli indirizzi dei server di riferimento ora che le VM devono utilizzare.

Esempio:

network:
  hostConfig:
    ntpServers:
    - "216.239.35.0"

network.hostConfig.searchDomainsForDNS

Facoltativo
Immutabile
Array di stringhe

I domini di ricerca DNS utilizzabili dalle VM. Questi domini vengono utilizzati come parte di un elenco di ricerca di domini.

Esempio:

network:
  hostConfig:
    searchDomainsForDNS:
    - "my.local.com"

network.ipMode.type

Immutabile
Stringa
Precompilato: "static"
Valore predefinito: "dhcp"

Se vuoi che i nodi del cluster ricevano il loro indirizzo IP da un server DHCP, imposta questo valore su "dhcp". Se vuoi che i nodi del cluster abbiano indirizzi IP statici scelti da un elenco che fornisci, imposta questo valore su "static".

Nella maggior parte dei casi devi specificare static perché devi sempre fornire gli indirizzi IP per i nodi del control plane del cluster di amministrazione. DHCP viene utilizzato solo per fornire indirizzi IP nei seguenti casi:

  • Se enableControlplaneV2 non è abilitato nei cluster utente, puoi utilizzare DHCP per i nodi del control plane del cluster utente, che si trovano nel cluster di amministrazione.

  • Nella versione 1.16 e precedenti, i nodi aggiuntivi per i cluster di amministrazione non ad alta disponibilità possono ottenere i propri indirizzi IP da DHCP. Nella versione 1.28 e successive, i cluster di amministrazione devono essere ad alta affidabilità e non hanno nodi aggiuntivi.

Esempio:

network:
  ipMode:
    type: "static"

network.ipMode.ipBlockFilePath

Il percorso assoluto o relativo del file del blocco IP per il tuo cluster.

Se è configurato infraConfigFilePath, questo campo è obbligatorio.

Questo campo è obbligatorio anche nei seguenti casi:

  • Cluster di amministrazione non ad alta affidabilità versione 1.16 e precedenti: elenca gli indirizzi IP per il nodo del control plane e i nodi aggiuntivi in un file di blocco IP.

  • Cluster di amministrazione HA 1.16 e versioni precedenti: elenca gli indirizzi IP dei nodi aggiuntivi in un file di blocco IP.

  • Cluster utente kubeception 1.29 e versioni precedenti: elenca gli indirizzi IP per i nodi del control plane del cluster utente nel file del blocco IP del cluster di amministrazione.

Immutabile
Stringa

Esempio:

network:
  ipMode:
    ipBlockFilePath: "/my-config-folder/admin-cluster-ipblock.yaml"

network.serviceCIDR

Obbligatorio
Immutabile
Stringa
Intervallo più piccolo possibile: /24
Intervallo più grande possibile: /12
Precompilato: "10.96.232.0/24"

Un intervallo di indirizzi IP, in formato CIDR, da utilizzare per i servizi nel tuo cluster.

Esempio:

network:
  serviceCIDR: "10.96.232.0/24"

network.podCIDR

Obbligatorio
Immutabile
Stringa
Intervallo più piccolo possibile: /18
Intervallo più grande possibile: /8
Precompilato: "192.168.0.0/16"

Un intervallo di indirizzi IP, in formato CIDR, da utilizzare per i pod nel cluster.

Esempio:

network:
  podCIDR: "192.168.0.0/16"

L'intervallo di servizi non deve sovrapporsi all'intervallo di pod.

Gli intervalli di servizi e pod non devono sovrapporsi a indirizzi esterni al cluster che vuoi raggiungere dall'interno del cluster.

Ad esempio, supponiamo che l'intervallo di servizi sia 10.96.232.0/24 e l'intervallo di pod sia 192.168.0.0/16. Qualsiasi traffico inviato da un pod a un indirizzo in uno di questi intervalli verrà trattato come traffico interno al cluster e non raggiungerà alcuna destinazione al di fuori del cluster.

In particolare, gli intervalli di servizi e pod non devono sovrapporsi a:

  • Indirizzi IP dei nodi in qualsiasi cluster

  • Indirizzi IP utilizzati dalle macchine del bilanciatore del carico

  • VIP utilizzati dai nodi del control plane e dai bilanciatori del carico

  • Indirizzo IP dei server vCenter, dei server DNS e dei server NTP

Ti consigliamo di utilizzare intervalli di servizi e pod nello spazio di indirizzi RFC 1918.

Questo è uno dei motivi per cui si consiglia di utilizzare indirizzi RFC 1918. Supponiamo che l'intervallo di pod o servizi contenga indirizzi IP esterni. Qualsiasi traffico inviato da un pod a uno di questi indirizzi esterni verrà trattato come traffico interno al cluster e non raggiungerà la destinazione esterna.

network.vCenter.networkName

Il nome della rete vSphere per i nodi del cluster.

Se è configurato infraConfigFilePath, rimuovi questo campo. In caso contrario, questo campo è obbligatorio e immutabile.

Esempio:

network:
  vCenter:
    networkName: "my-network"

Se il nome contiene un carattere speciale, devi utilizzare una sequenza di escape.

Caratteri speciali Sequenza di escape
Barra (/) %2f
Barra rovesciata (\) %5c
Simbolo della percentuale (%) %25

Se il nome della rete non è univoco nel tuo data center, puoi specificare un percorso completo.

Esempio:

network:
  vCenter:
    networkName: "/data-centers/data-center-1/network/my-network"

network.controlPlaneIPBlock

Informazioni di rete per i nodi del control plane del cluster di amministrazione.

Se infraConfigFilePath è configurato, rimuovi l'intera sezione. In caso contrario, questa sezione è obbligatoria e immutabile.

network.controlPlaneIPBlock.netmask

Obbligatorio
Immutabile
Stringa

La netmask della rete che contiene i nodi del control plane.

Esempio:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

network.controlPlaneIPBlock.gateway

Obbligatorio
Immutabile
Stringa

L'indirizzo IP del gateway predefinito per i nodi del control plane.

Esempio:

network:
  controlPlaneIPBlock:
    gateway: "172.16.22.1"

network.controlPlaneIPBlock.ips

Obbligatorio
Immutabile
Array di tre oggetti, ognuno dei quali ha un indirizzo IP e un nome host facoltativo.

Questi sono gli indirizzi IP che verranno assegnati ai nodi del control plane. I nomi host sono obbligatori per i cluster di amministrazione ad alta affidabilità.

Esempio:

network:
  controlPlaneIPBlock:
    ips:
    - ip: "172.16.22.6"
      hostname: "admin-cp-vm-1"
    - ip: "172.16.22.7"
      hostname: "admin-cp-vm-2"
    - ip: "172.16.22.8"
      hostname: "admin-cp-vm-3"

infraConfigFilePath

1,31

Se specifichi un percorso in questo campo, vengono attivati i domini di topologia.

Anteprima
Facoltativo
Stringa
Modificabile

Specifica il percorso completo del file di configurazione dell'infrastruttura vSphere.

Esempio:

infraConfigFilePath: "/my-config-folder/vsphere-infrastructure.yaml"

Oltre ad aggiungere il percorso, copia il file di configurazione dell'infrastruttura vSphere nella directory applicabile.

Se aggiungi un percorso a infraConfigFilePath, devi apportare le seguenti modifiche ai file di configurazione del cluster di amministrazione e del cluster utente.

Modifiche al file di configurazione del cluster di amministrazione

  • Rimuovi quanto segue dal file di configurazione del cluster di amministrazione. Puoi configurare queste informazioni nel file di configurazione dell'infrastruttura vSphere per dominio di topologia.

    • vCenter: rimuovi l'intera sezione vCenter.
    • network.hostConfig: rimuovi l'intera sezione network.hostConfig.
    • network.vCenter.networkName: rimuovi questo campo.

  • Apporta le seguenti modifiche al file di configurazione del cluster di amministrazione:

    • network.controlPlaneIPBlock: rimuovi l'intera sezione. Invece, specifica gli indirizzi IP per i nodi del control plane del cluster di amministrazione in un file di blocco IP.

    • preparedSecrets: rimuovi questo campo. Le credenziali preparate non sono supportate quando sono abilitati i domini di topologia. Rimuovi questo campo.

  • I seguenti campi sono obbligatori:

    • enableAdvancedCluster: impostato su true.

    • network.ipMode.ipBlockFilePath: impostato sul percorso completo o relativo del file del blocco IP del cluster di amministrazione.

    • loadBalancer.kind: impostato su "ManualLB". "ManualLB" è l'unica opzione di bilanciamento del carico multi-subnet (livello 3) disponibile offerta da Google Distributed Cloud.

Modifiche al file di configurazione del cluster utente

  • Rimuovi quanto segue dal file di configurazione del cluster utente. Puoi configurare queste informazioni nel file di configurazione dell'infrastruttura vSphere per dominio di topologia.

    • vCenter: rimuovi l'intera sezione vCenter.
    • network.hostConfig: rimuovi l'intera sezione network.hostConfig.
    • network.vCenter.networkName: rimuovi questo campo.
    • masterNode.vsphere: rimuovi l'intera sezione.
    • nodePools[i].vsphere.datastore e nodePools[i].vsphere.storagePolicyName: rimuovi questi campi.

  • Apporta le seguenti modifiche al file di configurazione del cluster utente:

    • network.controlPlaneIPBlock: rimuovi l'intera sezione. Invece, specifica gli indirizzi IP per i nodi del control plane del cluster di amministrazione in un file di blocco IP.

    • preparedSecrets: rimuovi questo campo. Le credenziali preparate non sono supportate quando sono abilitati i domini di topologia.

    • nodePools[i].vsphere.hostgroups: rimuovi questo campo. Nelle versioni 1.32.200 e 1.33 e successive, utilizza topologyDomains[i].compute.hostGroups per configurare l'affinità host VM per ogni dominio di topologia nel file di configurazione dell'infrastruttura vSphere.

    • multipleNetworkInterfaces: imposta questo campo su false. Più interfacce di rete per i pod non sono supportate quando sono abilitati i domini di topologia.

    • storage.vSphereCSIDisabled: imposta questo campo su true per disattivare il deployment dei componenti CSI vSphere

  • I seguenti campi sono obbligatori:

    • enableAdvancedCluster: impostato su true nel file di configurazione del cluster utente.

    • network.ipMode.ipBlockFilePath: impostato sul percorso completo o relativo del file del blocco IP del cluster utente.

    • loadBalancer.kind: impostato su "ManualLB". "ManualLB" è l'unica opzione di bilanciamento del carico multi-subnet (livello 3) disponibile offerta da Google Distributed Cloud.

1.30 e versioni precedenti

Non disponibile.

loadBalancer

Questa sezione contiene informazioni sul bilanciatore del carico per il cluster di amministrazione.

loadBalancer.vips.controlPlaneVIP

Obbligatorio
Immutabile
Stringa

L'indirizzo IP che hai scelto di configurare sul bilanciatore del carico per il server API Kubernetes del cluster di amministrazione.

Esempio:

loadBalancer:
  vips:
    controlplaneVIP: "203.0.113.3"

loadBalancer.kind

Specifica il tipo di bilanciatore del carico da utilizzare.

1.32 e successive

Obbligatorio
Immutabile
Stringa
Precompilato: "MetalLB"

Il tipo di bilanciatore del carico che puoi utilizzare dipende dal fatto che tu abbia configurato o meno il cluster per l'utilizzo dei domini di topologia. Si presume che il cluster utilizzi i domini di topologia se il campo infraConfigFilePath è configurato.

  • Con i domini di topologia: imposta questo valore su "ManualLB". Se vuoi utilizzare i domini di topologia, devi configurare un bilanciatore del carico di terze parti (come F5 BIG-IP o Citrix).

  • Senza domini di topologia: imposta questo valore su "ManualLB" o "MetalLB". Utilizza "ManualLB" se hai un bilanciatore del carico di terze parti o "MetalLB" per la nostra soluzione in bundle.

Se enableAdvancedCluster è impostato su true (cluster avanzato abilitato), il tipo di bilanciatore del carico per i nodi del control plane è determinato da adminMaster.controlPlaneLoadBalancer.

Esempio:

loadBalancer:
  kind: "MetalLB"

1,31

Obbligatorio
Immutabile
Stringa
Precompilato: "MetalLB"

Il tipo di bilanciatore del carico che puoi utilizzare dipende dal fatto che tu abbia configurato o meno il cluster per l'utilizzo dei domini di topologia. Si presume che il cluster utilizzi i domini di topologia se il campo infraConfigFilePath è configurato.

  • Con i domini di topologia: imposta questo valore su "ManualLB". Se vuoi utilizzare i domini di topologia, devi configurare un bilanciatore del carico di terze parti (come F5 BIG-IP o Citrix).

  • Senza domini di topologia: imposta questo valore su "ManualLB" o "MetalLB". Utilizza "ManualLB" se hai un bilanciatore del carico di terze parti o "MetalLB" per la nostra soluzione in bundle.

Esempio:

loadBalancer:
  kind: "MetalLB"

1,30

Obbligatorio
Immutabile
Stringa
Precompilato: "MetalLB"

Imposta questo valore su "ManualLB" o "MetalLB". Utilizza "ManualLB" se hai un bilanciatore del carico di terze parti (come F5 BIG-IP o Citrix) o "MetalLB" per la nostra soluzione in bundle.

Tieni presente le seguenti differenze rispetto alle versioni precedenti:

  • Nella versione 1.30 e successive, il valore "F5BigIP" non è consentito per i nuovi cluster di amministrazione.

  • Nella versione 1.28 e successive, il valore "Seesaw" non è consentito per i nuovi cluster di amministrazione.

Se hai un cluster esistente che utilizza questi bilanciatori del carico, consulta Pianifica la migrazione del cluster alle funzionalità consigliate.

Esempio:

loadBalancer:
  kind: "MetalLB"

1.29 e 1.28

Obbligatorio
Immutabile
Stringa
Precompilato: "MetalLB"

Imposta questo valore su "ManualLB", "F5BigIP" o "MetalLB"

Per attivare funzionalità nuove e avanzate, ti consigliamo di utilizzare "ManualLB" se hai un bilanciatore del carico di terze parti (come F5 BIG-IP o Citrix) o "MetalLB" per la nostra soluzione in bundle.

Nella versione 1.28 e successive, il valore "Seesaw" non è consentito per i nuovi cluster di amministrazione. Se hai un cluster esistente che utilizza il bilanciatore del carico Seesaw, consulta Esegui la migrazione dal bilanciatore del carico Seesaw a MetalLB.

Esempio:

loadBalancer:
  kind: "MetalLB"

1.16 e versioni precedenti

Obbligatorio
Immutabile
Stringa
Precompilato: "MetalLB"

Stringa. Imposta questo valore su "ManualLB", "F5BigIP", "Seesaw" o "MetalLB"

Se imposti adminMaster.replicas su 3, non puoi utilizzare il bilanciatore del carico Seesaw.

Esempio:

loadBalancer:
  kind: "MetalLB"

Quando crei i cluster utente utilizzando la console Google Cloud , gcloud CLI o Terraform, il tipo di bilanciatore del carico per il cluster di amministrazione e i relativi cluster utente deve essere lo stesso. L'unica eccezione è se il cluster di amministrazione utilizza Seesaw, nel qual caso i cluster utente possono utilizzare MetalLB. Se vuoi che i cluster di amministrazione e utente utilizzino tipi diversi di bilanciatori del carico, devi creare i cluster utente utilizzando lo strumento a riga di comando gkectl.

loadBalancer.manualLB

Se imposti loadbalancer.kind su "ManualLB", compila questa sezione. In caso contrario, rimuovi questa sezione.
Immutabile

loadBalancer.manualLB.ingressHTTPNodePort

Rimuovi questo campo dal file di configurazione. Non viene utilizzato in un cluster di amministrazione.

loadBalancer.manualLB.ingressHTTPSNodePort

Rimuovi questo campo dal file di configurazione. Non viene utilizzato in un cluster di amministrazione.

loadBalancer.manualLB.konnectivityServerNodePort

Rimuovi questo campo dal file di configurazione. Non viene utilizzato in un cluster di amministrazione.

loadBalancer.f5BigIP

1.30 e successive

Nella versione 1.30 e successive, il valore "F5BigIP" non è consentito per loadbalancer.kind per i nuovi cluster di amministrazione. Se la sezione loadBalancer.f5BigIP è presente nel file di configurazione, rimuovila o impostala come commento.

Puoi comunque utilizzare il bilanciatore del carico BIG-IP di F5 con i nuovi cluster di amministrazione, ma la configurazione è diversa. Per i dettagli sulla configurazione, consulta Attivazione della modalità di bilanciamento manuale del carico.

Se un cluster esistente ha questa sezione configurata, gli upgrade alla versione 1.32 sono bloccati. Devi eseguire la migrazione dei cluster alle funzionalità consigliate prima di eseguire l'upgrade alla versione 1.32.

1,29

Se imposti loadbalancer.kind su "F5BigIP", compila questa sezione. In caso contrario, rimuovi questa sezione.

Per attivare funzionalità nuove e avanzate, ti consigliamo di configurare il bilanciamento del carico manuale per il bilanciatore del carico F5 BIG-IP. Per attivare il bilanciamento manuale del carico, imposta loadbalancer.kind su "ManualLB" e compila la sezione loadBalancer.manualLB. Per saperne di più, consulta Attivazione della modalità di bilanciamento manuale del carico.

Se hai un bilanciatore del carico F5-BIG-IP esistente e la configurazione del cluster utilizza questa sezione, dopo aver eseguito l'upgrade alla versione 1.29 o successive, ti consigliamo di eseguire la migrazione al bilanciamento manuale del carico.

1.28 e versioni precedenti

Se imposti loadbalancer.kind su "F5BigIP", compila questa sezione. In caso contrario, rimuovi questa sezione.

Per attivare funzionalità nuove e avanzate, ti consigliamo di configurare il bilanciamento del carico manuale per il bilanciatore del carico F5 BIG-IP. Per attivare il bilanciamento manuale del carico, imposta loadbalancer.kind su "ManualLB" e compila la sezione loadBalancer.manualLB. Per saperne di più, consulta Attivazione della modalità di bilanciamento manuale del carico.

loadBalancer.f5BigIP.address

1.30 e successive

Non consentito per i nuovi cluster
Obbligatorio se loadBalancer.kind = "F5BigIp"
Immutabile
Stringa

L'indirizzo del bilanciatore del carico BIG-IP di F5. Ad esempio:

loadBalancer:
  f5BigIP:
    address: "203.0.113.2"

1.29 e versioni precedenti

Obbligatorio se loadBalancer.kind = "F5BigIp"
Immutabile
Stringa

L'indirizzo del bilanciatore del carico F5 BIG-IP. Ad esempio:

loadBalancer:
  f5BigIP:
    address: "203.0.113.2"

loadBalancer.f5BigIP.credentials.fileRef.path

1.30 e successive

Non consentito per i nuovi cluster
Obbligatorio se loadBalancer.kind = "F5BigIp"
Modificabile
Stringa

Il percorso di un file di configurazione delle credenziali che contiene il nome utente e la password di un account che Google Distributed Cloud può utilizzare per connettersi al bilanciatore del carico F5 BIG-IP.

L'account utente deve avere un ruolo utente con autorizzazioni sufficienti per configurare e gestire il bilanciatore del carico. È sufficiente il ruolo Amministratore o Amministratore risorse.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali F5 BIG-IP, consulta Aggiornamento delle credenziali del cluster.

Esempio:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        path: "my-config-folder/admin-creds.yaml"

1.29 e versioni precedenti

Obbligatorio se loadBalancer.kind = "F5BigIp"
Modificabile
Stringa

Il percorso di un file di configurazione delle credenziali che contiene il nome utente e la password di un account che Google Distributed Cloud può utilizzare per connettersi al bilanciatore del carico F5 BIG-IP.

L'account utente deve avere un ruolo utente con autorizzazioni sufficienti per configurare e gestire il bilanciatore del carico. È sufficiente il ruolo Amministratore o Amministratore risorse.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali F5 BIG-IP, consulta Aggiornamento delle credenziali del cluster.

Esempio:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        path: "my-config-folder/admin-creds.yaml"

loadBalancer.f5BigIP.credentialsfileRef.entry

1.30 e successive

Non consentito per i nuovi cluster
Obbligatorio se loadBalancer.kind = "F5BigIp"
Modificabile
Stringa

Il nome del blocco di credenziali nel file di configurazione delle credenziali che contiene il nome utente e la password del tuo account F5 BIG-IP.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali F5 BIG-IP, consulta Aggiornamento delle credenziali del cluster.

Esempio:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        entry: "f5-creds"

1.29 e versioni precedenti

Obbligatorio se loadBalancer.kind = "F5BigIp"
Modificabile
Stringa

Il nome del blocco delle credenziali nel file di configurazione delle credenziali, che contiene il nome utente e la password del tuo account F5 BIG-IP.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali F5 BIG-IP, consulta Aggiornamento delle credenziali del cluster.

Esempio:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        entry: "f5-creds"

loadBalancer.f5BigIP.partition

1.30 e successive

Non consentito per i nuovi cluster
Obbligatorio se loadBalancer.kind = "F5BigIp"
Immutabile
Stringa

Il nome di una partizione BIG-IP che hai creato per il cluster di amministrazione.

Esempio:

loadBalancer:
  f5BigIP:
    partition: "my-f5-admin-partition"

1.29 e versioni precedenti

Obbligatorio se loadBalancer.kind = "F5BigIp"
Immutabile
Stringa

Il nome di una partizione BIG-IP che hai creato per il cluster di amministrazione.

Esempio:

loadBalancer:
  f5BigIP:
    partition: "my-f5-admin-partition"

loadBalancer.f5BigIP.snatPoolName

1.30 e successive

Non consentito per i nuovi cluster
Facoltativo
Rilevante se loadBalancer.kind = "F5BigIp"
Immutabile
Stringa

Se utilizzi SNAT, il nome del pool SNAT. Se non utilizzi SNAT, rimuovi questo campo.

Esempio:

loadBalancer:
  f5BigIP:
    snatPoolName: "my-snat-pool"

1.29 e versioni precedenti

Facoltativo
Pertinente se loadBalancer.kind = "F5BigIp"
Immutabile
Stringa

Se utilizzi SNAT, il nome del pool SNAT. Se non utilizzi SNAT, rimuovi questo campo.

Esempio:

loadBalancer:
  f5BigIP:
    snatPoolName: "my-snat-pool"

loadBalancer.seesaw

Don't use this section. Il bilanciatore del carico Seesaw non è supportato per i nuovi cluster di amministrazione nella versione 1.28 e successive. Ti consigliamo invece di configurare il bilanciatore del carico MetalLB per i nuovi cluster di amministrazione. Per saperne di più sulla configurazione di MetalLB, consulta Bilanciamento del carico integrato con MetalLB.

Sebbene Seesaw sia ancora supportato per i cluster di amministrazione non ad alta affidabilità di cui è stato eseguito l'upgrade, ti consigliamo di eseguire la migrazione a MetalLB.

antiAffinityGroups.enabled

Facoltativo
Modificabile
Booleano
Precompilato: true

Imposta questo valore su true per attivare la creazione di regole DRS. In caso contrario, imposta questo valore su false.

Se questo campo è true, Google Distributed Cloud crea regole anti-affinità Distributed Resource Scheduler (DRS) di VMware per i nodi del cluster di amministrazione, in modo da distribuirle in almeno tre host ESXi fisici del data center.

Questa funzionalità richiede che l'ambiente vSphere soddisfi le seguenti condizioni:

  • VMware DRS è abilitato. VMware DRS richiede l'edizione della licenza vSphere Enterprise Plus.

  • Il tuo account utente vSphere dispone del privilegio Host.Inventory.Modify cluster.

  • Sono disponibili almeno quattro host ESXi.

Anche se la regola richiede che i nodi del cluster siano distribuiti su tre host ESXi, ti consigliamo vivamente di avere almeno quattro host ESXi disponibili. In questo modo, eviti di perdere il control plane del cluster di amministrazione. Ad esempio, supponiamo che tu abbia solo tre host ESXi e che il nodo del control plane del cluster di amministrazione si trovi su un host ESXi che non funziona. La regola DRS impedirà il posizionamento del nodo del control plane su uno dei due host ESXi rimanenti.

Ricorda che se hai una licenza vSphere Standard, non puoi attivare VMware DRS.

Se non hai attivato DRS o se non hai almeno quattro host in cui è possibile pianificare le VM vSphere, imposta antiAffinityGroups.enabled su false.

Tieni presente la seguente limitazione per i cluster avanzati:

  • Versione 1.31: se il campo enableAdvancedCluster è true, le regole di anti-affinità non sono supportate sui cluster avanzati e devi impostare antiAffinityGroups.enabled su false.

  • Versione 1.32: le regole di anti-affinità sono supportate sui cluster avanzati.

Esempio:

antiAffinityGroups:
  enabled: true

adminMaster

Immutabile

Impostazioni di configurazione per i nodi del control plane nel cluster di amministrazione.

adminMaster.controlPlaneLoadBalancer

1.32 e successive

Facoltativamente, includi questa sezione per specificare il tipo di bilanciatore del carico da utilizzare per il traffico del control plane nel cluster di amministrazione. Includi adminMaster.controlPlaneLoadBalancer.mode nel file di configurazione se vuoi impostare esplicitamente il tipo di bilanciatore del carico da utilizzare anziché fare affidamento sul valore predefinito. Inoltre, devi impostare loadBalancer.kind nel file di configurazione, anche se il campo è un'operazione no-op nella versione 1.32 e successive.

adminMaster.controlPlaneLoadBalancer.mode

Facoltativo
Immutabile
Stringa
Valore predefinito: dipende dal fatto che il cluster utilizzi o meno i domini di topologia

Il tipo di bilanciatore del carico che puoi utilizzare dipende dal fatto che tu abbia configurato o meno il cluster per l'utilizzo dei domini di topologia. Si presume che il cluster utilizzi i domini di topologia se il campo infraConfigFilePath è configurato.

  • Con i domini di topologia: specifica "manual", che è il valore predefinito. Se vuoi utilizzare i domini di topologia, devi configurare un bilanciatore del carico di terze parti (come F5 BIG-IP o Citrix).

  • Senza domini di topologia: specifica "manual" o "bundled". Utilizza "manual" se hai un bilanciatore del carico di terze parti o "bundled" per la nostra soluzione in bundle, che utilizza keepalived + haproxy in esecuzione sui tre nodi del control plane del cluster di amministrazione. Il valore predefinito è "bundled".

Esempio:

adminMaster:
  controlPlaneLoadBalancer:
    mode: "manual"

1.31 e versioni precedenti

Questa sezione non è disponibile. Utilizza invece loadBalancer.kind per specificare il tipo di bilanciatore del carico che deve essere utilizzato dal cluster di amministrazione.

adminMaster.cpus

Anteprima
Facoltativo
Immutabile
Numero intero
Precompilato: 4
Valore predefinito: 4

Il numero di vCPU per ciascun nodo del control plane nel cluster di amministrazione.

Esempio:

adminMaster:
  cpus: 4

adminMaster.memoryMB

Anteprima
Facoltativo
Immutabile
Numero intero
Precompilato: 16384
Valore predefinito: 16384

Il numero di mebibyte di memoria per ciascun nodo del control plane nel cluster di amministrazione.

Esempio:

adminMaster:
  memoryMB: 16384

adminMaster.replicas

1.28 e successive

Obbligatorio per i nuovi cluster
Immutabile
Numero intero
Valori possibili: 3

Il numero di nodi del control plane nel cluster di amministrazione. Nella versione 1.28 e successive, i nuovi cluster di amministrazione devono essere ad alta affidabilità (HA). Imposta questo campo su 3 per creare un cluster di amministrazione ad alta affidabilità con tre nodi del control plane.

Esempio:

adminMaster:
  replicas: 3

1.16 e versioni precedenti

Facoltativo
Immutabile
Numero intero
Valori possibili: 1 o 3
Precompilato: 1
Valore predefinito: 1

Il numero di nodi del control plane nel cluster di amministrazione. Imposta questo valore su 3 se vuoi creare un cluster di amministrazione ad alta affidabilità. In caso contrario, impostalo su 1.

Se imposti questo valore su 3, devi anche compilare la sezione network.controlPlaneIPBlock e la sezione network.hostConfig.

Se imposti questo valore su 3, non puoi utilizzare il bilanciatore del carico Seesaw.

Esempio:

adminMaster:
  replicas: 3

adminMaster.topologyDomains

1.32 e successive

Anteprima
Facoltativo
Array di stringhe | Consente un elemento o tre elementi diversi
Immutabile
Valore predefinito: vSphereInfraConfig.defaultTopologyDomain se specificato nel file di configurazione dell'infrastruttura vSphere

Un array di domini di topologia. Se è configurato infraConfigFilePath (che indica che il cluster utilizzerà i domini di topologia), includi questo campo facoltativo. Il numero di domini di topologia nell'array determina il modo in cui viene eseguito il deployment dei nodi del control plane del cluster di amministrazione, come segue:

  • Un elemento: tutti e tre i nodi del control plane del cluster di amministrazione verranno implementati nel dominio di topologia specificato.
  • Tre elementi: ogni nodo del control plane del cluster di amministrazione verrà sottoposto a deployment in un dominio di topologia diverso (ovvero un nodo per dominio di topologia).

1.31 e successive

Disponibile solo per i nuovi cluster
Anteprima
Array di stringhe | Consente un solo elemento
Facoltativo
Immutabile
Valore predefinito: vSphereInfraConfig.defaultTopologyDomain se specificato nel file di configurazione dell'infrastruttura vSphere

Un array di domini di topologia. Se infraConfigFilePath è configurato (il che indica che il cluster utilizzerà domini di topologia), includi questo campo (facoltativo). Il deployment dei nodi del control plane del cluster di amministrazione verrà eseguito nel dominio di topologia specificato.

1.30 e versioni precedenti

Non disponibile.

addonNode.autoResize.enabled

1.28 e successive

Non includere questa impostazione nel file di configurazione durante la creazione di un nuovo cluster. I cluster di amministrazione creati nella versione 1.28 e successive devono essere ad alta affidabilità (HA) con tre nodi del control plane. Nella versione 1.28 e successive, i cluster di amministrazione ad alta affidabilità non hanno nodi aggiuntivi.

1.16 e versioni precedenti

Facoltativo
Modificabile
Booleano
Precompilato: false
Valore predefinito: false

Imposta questo valore su true per abilitare il ridimensionamento automatico dei nodi dei componenti aggiuntivi nel cluster di amministrazione. In caso contrario, impostalo su false.

Per aggiornare il valore di questo campo, utilizza gkectl update admin.

Esempio:

addonNode:
  autoResize:
    enabled: true

proxy

Se la tua rete si trova dietro un server proxy, compila questa sezione. In caso contrario, rimuovi questa sezione o lasciala commentata. Il server proxy specificato qui viene utilizzato dai cluster utente gestiti da questo cluster di amministrazione.
Immutabile

proxy.url

Obbligatorio se la sezione proxy è compilata.
Immutabile
Stringa

L'indirizzo HTTP del tuo server proxy. Includi il numero di porta anche se è lo stesso della porta predefinita dello schema.

Esempio:

proxy:
  url: "http://my-proxy.example.local:80"

Il server proxy specificato qui viene utilizzato dai cluster Google Distributed Cloud. Inoltre, la tua workstation di amministrazione viene configurata automaticamente per utilizzare lo stesso server proxy, a meno che non imposti la variabile di ambiente HTTPS_PROXY sulla tua workstation di amministrazione.

Se specifichi proxy.url, devi specificare anche proxy.noProxy.

Una volta impostata, la configurazione del proxy per il cluster di amministrazione non può essere modificata o eliminata, a meno che il cluster non venga ricreato.

proxy.noProxy

Facoltativo
Immutabile
Stringa

Un elenco separato da virgole di indirizzi IP, intervalli di indirizzi IP, nomi host e nomi di dominio che non devono passare attraverso il server proxy. Quando Google Distributed Cloud invia una richiesta a uno di questi indirizzi, host o domini, la richiesta viene inviata direttamente.

Esempio:

proxy:
  noProxy: "10.151.222.0/24,my-host.example.local,10.151.2.1"

privateRegistry

Un registry di container privato è un registry in cui l'accesso alle immagini container è limitato agli utenti autenticati. Compila questa sezione se i cluster utente devono accedere alle immagini dei workload. Quando configuri la sezione privateRegistry, tutti i cluster utente gestiti da questo cluster di amministrazione estraggono le immagini dei workload dal registry privato che configuri qui.

Se configuri la sezione privateRegistry, quando esegui gkectl prepare prima della creazione o dell'upgrade del cluster, gkectl esegue il push delle immagini di sistema di Google Distributed Cloud nel registry privato. Durante la creazione o l'upgrade del cluster, le immagini di sistema vengono estratte dal registry privato. Se non configuri la sezione privateRegistry, le immagini di sistema vengono estratte da gcr.io/gke-on-prem-release utilizzando il service account di accesso ai componenti.

Potresti voler configurare la sezione privateRegistry in modo che i cluster eseguano il pull delle immagini di sistema dal registry privato anziché da gcr.io/gke-on-prem-release nei seguenti casi:

  • Devi ridurre al minimo le connessioni a Google Cloud per motivi di sicurezza o requisiti normativi.
  • La tua organizzazione richiede che il traffico in uscita passi attraverso un server proxy e la velocità di rete per la connessione a Google Cloud è lenta.

Se vuoi utilizzare Artifact Registry di Google come registry privato, consulta Utilizza Artifact Registry come registry privato per le immagini dei workload per i passaggi di configurazione.

privateRegistry.address

Obbligatorio per il registry privato
Immutabile
Stringa

L'indirizzo IP o il nome di dominio completo (FQDN) della macchina che esegue il registry privato.

Esempi:

privateRegistry:
  address: "203.0.113.10"

privateRegistry:
  address: "fqdn.example.com"

privateRegistry.credentials.fileRef.path

Obbligatorio per il registry privato
Modificabile
Stringa

Il percorso di un file di configurazione delle credenziali che contiene il nome utente e la password di un account che Google Distributed Cloud può utilizzare per accedere al tuo registry privato.

Esempio:

privateRegistry:
  credentials:
    fileRef:
      path: "my-config-folder/admin-creds.yaml"

privateRegistry.credentials.fileRef.entry

Obbligatorio per il registry privato
Modificabile
Stringa

Il nome del blocco delle credenziali nel file di configurazione delle credenziali, che contiene il nome utente e la password del tuo account del registry privato.

privateRegistry:
  credentials:
    fileRef:
      entry: "private-registry-creds"

privateRegistry.caCertPath

Obbligatorio per il registry privato
Modificabile
Stringa

Quando il runtime del container esegue il pull di un'immagine dal tuo registry privato, il registry deve dimostrare la propria identità presentando un certificato. Il certificato del registry è firmato da un'autorità di certificazione (CA). Il runtime del container utilizza il certificato della CA per convalidare il certificato del registry.

Imposta questo campo sul percorso del certificato della CA.

Esempio:

privateRegistry:
  caCertPath: "my-cert-folder/registry-ca.crt"

componentAccessServiceAccountKeyPath

Obbligatorio
Modificabile
Stringa

Il percorso del file della chiave JSON per il account di servizio di accesso ai componenti.

Esempio:

componentAccessServiceAccountKeyPath: "my-key-folder/access-key.json"

gkeConnect

Obbligatorio
Modificabile

Quando compili la sezione gkeConnect, il cluster di amministrazione viene registrato automaticamente in un parco risorse dopo la sua creazione. Questa sezione contiene informazioni sul progetto Google Cloud e sul service account necessari per registrare il cluster.

Durante la creazione o l'aggiornamento del cluster, sul cluster di amministrazione vengono configurate diverse policy RBAC. Queste policy RBAC sono necessarie per poter creare cluster utente nella console Google Cloud .

gkeConnect.projectID

Obbligatorio
Immutabile
Stringa

L'ID del tuo progetto host del parco risorse. Per i nuovi cluster, questo ID progetto deve essere lo stesso dell'ID impostato in stackdriver.projectID e cloudAuditLogging.projectID. Se gli ID progetto non sono gli stessi, la creazione del cluster non va a buon fine. Questo requisito non viene applicato ai cluster esistenti.

Esempio:

gkeConnect:
  projectID: "my-fleet-host-project"

gkeConnect.location

Facoltativo
Immutabile
Stringa
Valore predefinito: global

L'appartenenza al parco risorse di ogni cluster è gestita dal servizio Fleet (gkehub.googleapis.com) e dal servizio Connect (gkeconnect.googleapis.com). La località dei servizi può essere globale o regionale. Nella versione 1.28 e successive, puoi facoltativamente specificare la regione Google Cloud in cui vengono eseguiti i servizi Fleet e Connect. Se non specificato, vengono utilizzate le istanze globali dei servizi. Tieni presente quanto segue:

  • I cluster di amministrazione creati prima della versione 1.28 sono gestiti dai servizi globali Fleet e Connect.

  • Per i nuovi cluster, se includi questo campo, la regione specificata deve essere la stessa configurata in cloudAuditLogging.clusterLocation, stackdriver.clusterLocation e gkeOnPremAPI.location. Se le regioni non sono le stesse, la creazione del cluster non va a buon fine.

Esempio:

gkeConnect:
  location: "us-central1"

gkeConnect.registerServiceAccountKeyPath

Obbligatorio
Modificabile
Stringa

Il percorso del file della chiave JSON per il tuo service account connect-register.

Esempio:

gkeConnect:
  registerServiceAccountKeyPath: "my-key-folder/connect-register-key.json"

gkeOnPremAPI

Facoltativo

Nella versione 1.16 e successive, se l'API GKE On-Prem è abilitata nel tuo progettoGoogle Cloud , tutti i cluster del progetto vengono registrati automaticamente nell'API GKE On-Prem nella regione configurata in stackdriver.clusterLocation.

  • Se vuoi registrare tutti i cluster del progetto nell'API GKE On-Prem, assicurati di seguire i passaggi descritti in Prima di iniziare per attivare e utilizzare l'API GKE On-Prem nel progetto.

  • Se non vuoi registrare il cluster nell'API GKE On-Prem, includi questa sezione e imposta gkeOnPremAPI.enabled su false. Se non vuoi registrare cluster nel progetto, disabilita gkeonprem.googleapis.com (il nome del servizio per l'API GKE On-Prem) nel progetto. Per istruzioni, vedi Disabilitare i servizi.

La registrazione del cluster di amministrazione nell'API GKE On-Prem ti consente di utilizzare strumenti standard, ovvero la console Google Cloud , Google Cloud CLI o Terraform, per eseguire l'upgrade dei cluster utente gestiti dal cluster di amministrazione. La registrazione del cluster ti consente anche di eseguire i comandi gcloud per ottenere informazioni sui tuoi cluster.

Dopo aver aggiunto questa sezione e creato o aggiornato il cluster di amministrazione, se in seguito rimuovi la sezione e aggiorni il cluster, l'aggiornamento non andrà a buon fine.

gkeOnPremAPI.enabled

Obbligatorio se è inclusa la sezione gkeOnPremAPI.
Modificabile
Booleano
Valore predefinito: true

Per impostazione predefinita, il cluster viene registrato nell'API GKE On-Prem se l'API GKE On-Prem è abilitata nel tuo progetto. Imposta su false se non vuoi registrare il cluster.

Dopo aver registrato il cluster nell'API GKE On-Prem, se devi annullare la registrazione del cluster, apporta la seguente modifica e poi aggiorna il cluster:

gkeOnPremAPI:
  enabled: false

gkeOnPremAPI.location

Immutabile
Stringa
Valore predefinito:stackdriver.clusterLocation

La regione Google Cloud in cui l'API GKE On-Prem viene eseguita e archivia i metadati del cluster. Scegli una delle regioni supportate. Devi utilizzare la stessa regione configurata in cloudAuditLogging.clusterLocation, gkeConnect.location e stackdriver.clusterLocation. Se gkeOnPremAPI.enabled è false, non includere questo campo.

stackdriver

Obbligatorio
Modificabile

stackdriver.projectID

Obbligatorio per Logging e Monitoring
Immutabile
Stringa

L'ID del tuo progetto host del parco risorse. Per i nuovi cluster, questo ID progetto deve essere lo stesso dell'ID impostato in gkeConnect.projectID e cloudAuditLogging.projectID. Se gli ID progetto non sono gli stessi, la creazione del cluster non va a buon fine. Questo requisito non viene applicato ai cluster esistenti.

Se necessario, puoi configurare un router dei log in questo progetto per instradare i log ai bucket di log in un altro progetto. Per informazioni su come configurare il router dei log, consulta Destinazioni supportate.

Esempio:

stackdriver:
  projectID: "my-fleet-host-project"

stackdriver.clusterLocation

Obbligatorio per Logging e Monitoring
Immutabile
Stringa
Precompilato: "us-central1"

La regione Google Cloud in cui vuoi instradare e archiviare le metriche di Cloud Monitoring. Ti consigliamo di scegliere una regione vicina al tuo data center on-premise.

Puoi specificare la posizione di archiviazione e il routing dei log di Cloud Logging nella configurazione del router dei log. Per saperne di più sul routing dei log, consulta la panoramica su routing e archiviazione.

L'operatore Stackdriver (stackdriver-operator) associa il valore di questo campo a ogni voce di log e metrica prima che vengano indirizzate a Google Cloud. Queste etichette allegate possono essere utili per filtrare i log e le metriche rispettivamente in Esplora log ed Metrics Explorer.

Per i nuovi cluster, se includi le sezioni gkeOnPremAPI e cloudAuditLogging nel file di configurazione, la regione impostata qui deve essere la stessa impostata in cloudAuditLogging.clusterLocation, gkeConnect.location e gkeOnPremAPI.location. Se le regioni non sono le stesse, la creazione del cluster non va a buon fine.

Esempio:

stackdriver:
  clusterLocation: "us-central1"

stackdriver.serviceAccountKeyPath

Obbligatorio per Logging e Monitoring
Modificabile
Stringa

Il percorso del file della chiave JSON per il account di servizio di logging-monitoring.

Se creerai il cluster con enableAdvancedCluster impostato su true (necessario per configurare i domini di topologia), stackdriver.serviceAccountKeyPath deve essere uguale a cloudAuditLogging.serviceAccountKeyPath.

Per informazioni su come aggiornare questo campo in un cluster esistente, consulta Rotazione account di servizio account.

Esempio:

stackdriver:
  serviceAccountKeyPath: "my-key-folder/log-mon-key.json"

stackdriver.disableVsphereResourceMetrics

Facoltativo
Modificabile
Pertinente per Logging e Monitoring
Booleano
Precompilato: false
Valore predefinito: false

Imposta questo valore su true per disattivare la raccolta delle metriche da vSphere. In caso contrario, impostalo su false.

Questa sezione è obbligatoria nel cluster di amministrazione se vuoi gestire il ciclo di vita dei cluster utente nella console Google Cloud .

Esempio:

stackdriver:
  disableVsphereResourceMetrics: true

cloudAuditLogging

Se vuoi integrare gli audit log del server API Kubernetes del tuo cluster con Cloud Audit Logs, compila questa sezione. In caso contrario, rimuovi questa sezione o lasciala commentata.
Modificabile

Questa sezione è obbligatoria nel cluster di amministrazione se vuoi gestire il ciclo di vita dei cluster utente utilizzando i client API GKE On-Prem.

cloudAuditLogging.projectID

Obbligatorio per Cloud Audit Logs
Immutabile
Stringa

L'ID del tuo progetto host del parco risorse. Per i nuovi cluster, questo ID progetto deve essere lo stesso dell'ID impostato in gkeConnect.projecID e stackdriver.projectID. Se gli ID progetto non sono gli stessi, la creazione del cluster non va a buon fine. Questo requisito non viene applicato ai cluster esistenti.

Se necessario, puoi configurare un router dei log in questo progetto per instradare i log ai bucket di log in un altro progetto. Per informazioni su come configurare il router dei log, consulta Destinazioni supportate.

Esempio:

cloudAuditLogging:
  projectID: "my-fleet-host-project"

cloudAuditLogging.clusterLocation

Obbligatorio per Cloud Audit Logs
Immutabile
Stringa

La regione Google Cloud in cui vuoi archiviare gli audit log. È consigliabile scegliere una regione vicina al tuo data center on-premise

Per i nuovi cluster, se includi le sezioni gkeOnPremAPI e stackdriver nel file di configurazione, la regione impostata qui deve essere la stessa impostata in gkeConnect.location, gkeOnPremAPI.location e stackdriver.clusterLocation. Se le regioni non sono le stesse, la creazione del cluster non va a buon fine.

Esempio:

cloudAuditLogging:
  clusterLocation: "us-central1"

cloudAuditLogging.serviceAccountKeyPath

Obbligatorio per Cloud Audit Logs
Modificabile
Stringa

Il percorso del file della chiave JSON per l'account di servizio di audit logging.

Se creerai il cluster con enableAdvancedCluster impostato su true (necessario per configurare i domini di topologia), cloudAuditLogging.serviceAccountKeyPath deve essere uguale a stackdriver.serviceAccountKeyPath.

Per informazioni su come aggiornare questo campo in un cluster esistente, consulta Rotazione account di servizio account.

Esempio:

cloudAuditLogging:
  serviceAccountKeyPath: "my-key-folder/audit-log-key.json"

clusterBackup.datastore

Facoltativo
Modificabile
Stringa

Per impostazione predefinita, i file tar di backup del cluster vengono salvati nella directory gkectl-workspace/backups della workstation di amministrazione. Se vuoi archiviare i file di backup del cluster in vSphere, imposta questo campo sul datastore vSphere in cui vuoi salvare i backup.

Esempio:

clusterBackup:
  datastore: "my-datastore"

Tieni presente le seguenti differenze di assistenza per questo campo:

  • Per i cluster avanzati:

    • Versione 1.31: rimuovi clusterBackup.datastore dal file di configurazione. Il backup dei cluster in un datastore vSphere non è supportato.

    • Versione 1.32: clusterBackup.datastore è in anteprima

    • Versione 1.33 e successive: clusterBackup.datastore è in disponibilità generale.

  • Per i cluster non avanzati, clusterBackup.datastore rimane in anteprima.

Per ulteriori informazioni, consulta le seguenti risorse:

autoRepair.enabled

Facoltativo
Modificabile
Booleano
Precompilato: true

Imposta questo valore su true per attivare la riparazione automatica dei nodi. In caso contrario, imposta questo valore su false.

Per aggiornare il valore di questo campo, utilizza gkectl update admin.

Esempio:

autoRepair:
  enabled: true

secretsEncryption

Compila questa sezione se vuoi criptare i secret senza la necessità di un KMS (Key Management Service) esterno o di altre dipendenze. In caso contrario, rimuovi questa sezione o lasciala commentata.
Immutabile

Se creerai il cluster con enableAdvancedCluster impostato su true (obbligatorio per configurare i domini di topologia), rimuovi questa sezione. Questa funzionalità non è supportata con i cluster avanzati.

secretsEncryption.mode

Obbligatorio per la crittografia dei secret
Immutabile
Stringa
Valore possibile: "GeneratedKey"
Precompilato: "GeneratedKey"

La modalità di crittografia dei secret.

secretsEncryption:
  mode: "GeneratedKey"

secretsEncryption.generatedKey.keyVersion

Obbligatorio per la crittografia dei secret
Modificabile
Numero intero
Precompilato: 1

Un numero intero a tua scelta da utilizzare per il numero di versione della chiave. Ti consigliamo di iniziare con 1.

Esempio:

secretsEncryption:
  generatedKey:
    keyVersion: 1

secretsEncryption.generatedKey.disabled

Facoltativo per la crittografia dei secret
Modificabile
Booleano
Precompilato: false

Imposta questo valore su true per disabilitare la crittografia dei secret. In caso contrario, impostalo su false.

Esempio:

secretsEncryption:
  generatedKey:
    disabled: false

osImageType

Facoltativo
Modificabile
Stringa
Valori possibili: per le versioni 1.34 e precedenti: "ubuntu_containerd", "cos"
Per la versione 1.35 e successive: "ubuntu_cgv2", "cos_cgv2"
Precompilato: "ubuntu_cgv2"
Valore predefinito: "ubuntu_containerd"

Il tipo di immagine sistema operativo da eseguire sui nodi del cluster di amministrazione.

Tieni presente la seguente limitazione per i cluster avanzati:

  • Versione 1.31: se il campo enableAdvancedCluster è true, solo ubuntu-cgroupv2 e ubuntu_containerd sono supportati sui cluster avanzati.

  • Versione 1.32: tutti i tipi di immagini sistema operativo sono supportati sui cluster avanzati.

Nota: nelle versioni 1.32 e precedenti, i bundle completi non includono immagini sistema operativo cgroup v2. Se specifichi ubuntu_cgv2 o cos_cgv2, devi utilizzare un bundle normale. Per maggiori dettagli, consulta Informazioni sui bundle di Google Distributed Cloud.

Esempio:

osImageType: "cos_cgv2"