Anthos clusters on bare metal è ora Google Distributed Cloud (solo software) per bare metal. Per ulteriori informazioni, consulta la panoramica del prodotto.
Riferimento per il campo di configurazione del cluster
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
In questa pagina vengono descritti i campi supportati nel file di configurazione del cluster Google Distributed Cloud. Per ogni campo, la seguente tabella identifica se il campo è obbligatorio. La tabella mostra anche quali campi sono modificabili, ovvero quelli
che possono essere modificati dopo la creazione di un cluster. Come indicato nella tabella, alcuni campi modificabili possono essere modificati solo durante l'upgrade di un cluster.
Generazione di un modello per il file di configurazione del cluster
Puoi creare un file di configurazione del cluster con il comando bmctl create config. Sebbene alcuni campi abbiano valori predefiniti e altri, ad esempio metadata.name, possano essere compilati automaticamente, questo file di configurazione del formato YAML è un modello per specificare informazioni sul cluster.
Per creare un nuovo file di configurazione del cluster, utilizza questo comando nella cartella /baremetal:
bmctl create config -c CLUSTER_NAME
Sostituisci CLUSTER_NAME con il nome del cluster che vuoi creare. Per ulteriori informazioni su bmctl, consulta lo strumento bmctl.
Per un esempio del file di configurazione del cluster generato, vedi Esempio di file di configurazione del cluster.
Compilazione del file di configurazione in corso...
Nel file di configurazione, inserisci i valori dei campi come descritto nella seguente tabella di riferimento dei campi prima di creare o eseguire l'upgrade del cluster.
Campi di configurazione del cluster
Nome campo
Tipo di risorsa
Obbligatorio?
Modificabile?
anthosBareMetalVersion
Obbligatorio. Stringa. La versione del cluster. Questo valore è impostato per la creazione e gli upgrade del cluster.
Mutabilità: questo valore non può essere modificato per i cluster esistenti.
La versione può essere aggiornata solo tramite il processo di upgrade del cluster.
Risorsa cluster
Obbligatorio
Modificabile
authentication
Questa sezione contiene le impostazioni necessarie per utilizzare OpenID Connect (OIDC).
OIDC consente di utilizzare il provider di identità esistente per gestire l'autenticazione di utenti e gruppi nei cluster Google Distributed Cloud.
Risorsa cluster
—
—
authentication.oidc.certificateAuthorityData
Facoltativo. Un
certificato con codifica PEMbase64 per il provider OIDC. Per creare la stringa, codifica il certificato, incluse le intestazioni, in base64. Includi la stringa risultante in
certificateAuthorityData come una singola riga.
Ad esempio (campione aggregato per adattarsi alla tabella):
Facoltativo. Stringa. L'ID dell'applicazione client che invia le richieste di autenticazione al provider OpenID.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.clientSecret
Facoltativo. Stringa. Secret condiviso tra l'applicazione client OIDC e il provider OIDC.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.deployCloudConsoleProxy
Facoltativo. Booleano (true|false). Specifica se nel cluster viene eseguito il deployment di un proxy inverso per connettere la console Google Cloud a un provider di identità on-premise non accessibile pubblicamente su internet. Se il tuo provider di identità non è raggiungibile sulla rete internet pubblica, imposta questo campo su true per eseguire l'autenticazione con la console Google Cloud. Per impostazione predefinita, questo valore è impostato su false.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.extraParams
Facoltativo. Elenco delimitato da virgole. Parametri coppia chiave-valore aggiuntivi da inviare al provider OpenID.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.groupPrefix
Facoltativo. Stringa. Prefisso anteposto alle attestazioni dei gruppi per evitare conflitti con i nomi esistenti. Ad esempio, per il gruppo dev e il prefisso oidc:, oidc:dev.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.group
Facoltativo. Stringa.
Attestazione JWT
utilizzata dal provider per restituire i tuoi gruppi di sicurezza.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.issuerURL
Facoltativo. Stringa dell'URL. URL a cui vengono inviate le richieste di autorizzazione
al tuo OpenID, ad esempio https://example.com/adfs. Il server API Kubernetes
utilizza questo URL per scoprire le chiavi pubbliche per la verifica dei token. L'URL deve utilizzare HTTPS.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.kubectlRedirectURL
Facoltativo. Stringa dell'URL. L'URL di reindirizzamento utilizzato da kubectl per
l'autorizzazione. Quando abiliti OIDC, devi specificare un valore kubectlRedirectURL.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.proxy
Facoltativo. Stringa dell'URL. Server proxy da utilizzare per consentire al cluster di connettersi al provider OIDC, se applicabile. Il valore deve includere un nome host/indirizzo IP e, facoltativamente, una porta, un nome utente e una password. Ad
esempio: http://user:password@10.10.10.10:8888.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.scopes
Facoltativo. Elenco delimitato da virgole. Ambiti aggiuntivi da inviare al provider OpenID. Microsoft Azure e Okta richiedono l'ambito offline_access.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.usernamePrefix
Facoltativo. Stringa. Prefisso anteposto alle attestazioni del nome utente.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.username
Facoltativo. Stringa.
JWT, può essere utilizzato come nome utente. Se non specificato, il valore predefinito è sub.
Risorsa cluster
Facoltativo
Immutabile
bypassPreflightCheck
Facoltativo. Booleano (true|false). Se impostato su
true, i controlli preflight interni vengono ignorati quando
si applicano le risorse ai cluster esistenti. Il valore predefinito è false.
Modificabilità: questo valore può essere modificato per i cluster esistenti con il comando bmctl update.
Risorsa cluster
Facoltativo
Modificabile
clusterNetwork
Questa sezione contiene le impostazioni di rete per il cluster.
Risorsa cluster
Obbligatorio
Modificabile
clusterNetwork.advancedNetworking
Valore booleano. Imposta questo campo su true per abilitare funzionalità di networking avanzate, come il bilanciamento del carico in bundle con BGP o il gateway NAT in uscita. Entrambe queste funzionalità utilizzano il gateway di rete per GDC. Network Gateway per GDC è il componente chiave per abilitare funzionalità di networking avanzate in GKE Enterprise e Google Kubernetes Engine (GKE). Uno dei principali vantaggi di Network Gateway per GDC è che può allocare dinamicamente indirizzi IP mobili da un insieme di indirizzi da te specificati in una risorsa personalizzata di NetworkGatewayGroup.
Valore booleano. Imposta questo campo su false per disabilitare le funzionalità di Ingress in bundle con Google Distributed Cloud. Le funzionalità Ingress in bundle per il cluster supportano solo il traffico in entrata. Se esegui l'integrazione con Istio o Cloud Service Mesh per i vantaggi aggiuntivi di un mesh di servizi completamente funzionale, ti consigliamo di disabilitare il traffico in entrata in bundle. Questo campo è impostato su true per impostazione predefinita. Questo campo non è presente nel file di configurazione del cluster generato. Puoi disabilitare il traffico Ingress in bundle solo per i cluster in versione 1.13.0 e successive.
Valore booleano. Imposta questo campo su true per abilitare il modello di networking del cluster in modalità flat. In modalità flat, ogni pod ha il proprio indirizzo IP univoco. I pod possono comunicare tra loro direttamente senza la necessità di un gateway intermedio o di una Network Address Translation (NAT).
flatIPv4 è false per impostazione predefinita. Puoi abilitare la modalità flat solo durante la creazione del cluster. Una volta abilitata la modalità flat per il tuo cluster, non puoi disabilitarla.
Risorsa cluster
Facoltativo
Immutabile
clusterNetwork.forwardMode
Facoltativo. Stringa. Specifica la modalità di networking per il bilanciamento del carico di Dataplane V2. Network Address Translation (SNAT) di origine è la modalità di networking predefinita. La modalità Direct Server Return (DSR) consente di risolvere i problemi relativi al bilanciamento del carico SNAT. In modalità DSR (forwardMode: dsr), il nodo del bilanciatore del carico utilizza le opzioni IP per salvare l'indirizzo di origine del client.
La modalità di networking per il bilanciamento del carico di Dataplane V2 può essere configurata solo al momento della creazione del cluster.
Obbligatorio. Intervallo di indirizzi IPv4 in formato a blocchi CIDR. I pod specificano gli intervalli IP da cui vengono allocate le reti di pod.
Intervallo CIDR pod minimo: valore della maschera di /18, che corrisponde a una dimensione di 14 bit (16.384 indirizzi IP).
Intervallo massimo CIDR pod: valore della maschera di /8, che corrisponde a una dimensione di 24 bit (16.777.216 indirizzi IP).
Ad esempio:
pods:
cidrBlocks:
- 192.168.0.0/16
Risorsa cluster
Obbligatorio
Immutabile
clusterNetwork.sriovOperator
Facoltativo. Valore booleano. Imposta questo campo su true per abilitare il networking SR-IOV per il cluster.
Per saperne di più sulla configurazione e sull'utilizzo del networking SR-IOV,
consulta la documentazione
Configurare il networking SR-IOV.
Risorsa cluster
Facoltativo
Modificabile
clusterNetwork.services.cidrBlocks
Obbligatorio. Intervallo di indirizzi IPv4 in formato a blocchi CIDR. Specifica l'intervallo di indirizzi IP da cui vengono allocati gli indirizzi IP virtuali (VIP) di servizio. Gli intervalli non devono sovrapporsi ad alcuna subnet raggiungibile dalla tua rete. Per ulteriori informazioni sull'allocazione degli indirizzi per le reti internet private, consulta RFC 1918.
A partire dalla release 1.15.0 di Google Distributed Cloud, questo campo è modificabile. Se necessario, puoi aumentare il numero di indirizzi IP allocati per i servizi dopo aver creato un cluster. Per maggiori
informazioni, consulta la pagina Aumentare l'intervallo di rete dei servizi.
Puoi solo aumentare l'intervallo del CIDR del servizio IPv4. L'intervallo di rete non può essere ridotto, il che significa che la maschera (il valore dopo "/") non può essere aumentata.
Intervallo CIDR minimo del servizio: valore della maschera di
/24, che corrisponde a una dimensione di 8 bit (256
indirizzi).
Intervallo CIDR massimo del servizio: valore della maschera di /12, che corrisponde a una dimensione di 20 bit (1.048.576 indirizzi IP).
Ad esempio:
services:
cidrBlocks:
- 10.96.0.0/12
Risorsa cluster
Obbligatorio
Modificabile
clusterOperations
Questa sezione contiene informazioni per Cloud Logging e Cloud Monitoring.
Risorsa cluster
Obbligatorio
Modificabile
clusterOperations.enableApplication
Questo campo non è più utilizzato e non ha alcun effetto. Il logging e il monitoraggio delle applicazioni sono abilitati nella risorsa personalizzata Stackdriver. Per
maggiori informazioni sull'abilitazione del logging e del monitoraggio delle applicazioni, consulta
Abilitare il logging e il monitoraggio delle applicazioni.
Risorsa cluster
Autonomo
Modificabile
clusterOperations.disableCloudAuditLogging
Valore booleano. Cloud Audit Logs è utile per indagare sulle richieste API sospette e per raccogliere statistiche. Cloud Audit Logs è abilitato (disableCloudAuditLogging: false) per impostazione predefinita. Imposta su
true per disabilitare Cloud Audit Logs.
Stringa. Una regione Google Cloud in cui archiviare i log di Logging e le metriche di Monitoring.
È consigliabile scegliere una regione vicina al data center on-premise. Per maggiori informazioni, consulta la sezione
Località globali.
Ad esempio:
location: us-central1
Risorsa cluster
Obbligatorio
Immutabile
clusterOperations.projectID
Stringa. L'ID del progetto Google Cloud in cui vuoi visualizzare i log e le metriche.
Risorsa cluster
Obbligatorio
Immutabile
controlPlane
Questa sezione contiene informazioni sul piano di controllo e sui suoi componenti.
Risorsa cluster
Obbligatorio
Modificabile
controlPlane.apiServerCertExtraSANs
Facoltativo. Un array di stringhe (nomi di dominio e indirizzi IP). Un nome alternativo del soggetto (SAN) è una funzionalità dei certificati SSL che consente di definire i nomi di dominio e i sottodomini su cui vuoi che sia valido un certificato. In un cluster Google Distributed Cloud, le SAN per il certificato del server API includono gli indirizzi IP e VIP dei nodi del piano di controllo e i nomi DNS di Kubernetes per impostazione predefinita.
Utilizza questo campo per aggiungere altre SAN al certificato del server API per il cluster. I nomi di dominio devono essere conformi alla specifica RFC 1035.
Per ulteriori informazioni, vedi Aggiungere domini al certificato del server API.
Questo campo può essere aggiunto o modificato in qualsiasi momento.
Risorsa cluster
Facoltativo
Modificabile
controlPlane.nodePoolSpec
Questa sezione specifica gli indirizzi IP per il pool di nodi utilizzato dal piano di controllo e dai suoi componenti. La specifica del pool di nodi del piano di controllo (come la specifica del pool di nodi del bilanciatore del carico) è speciale. Questa specifica dichiara e controlla le risorse critiche del cluster. L'origine canonica per questa risorsa è questa sezione nel file di configurazione del cluster. Non modificare direttamente le risorse del pool di nodi del piano di controllo di primo livello. Modifica le sezioni associate nel file di configurazione del cluster.
Risorsa cluster
Obbligatorio
Modificabile
controlPlane.nodePoolSpec.nodes
Obbligatorio. Un array di indirizzi IP. In genere, questo array è un indirizzo IP per una singola macchina o indirizzi IP per tre macchine per un deployment ad alta disponibilità (HA).
Facoltativo. Numero intero (non negativo). Specifica la quantità massima di richieste di pull delle immagini che possono essere aggiunte alla coda di elaborazione per gestire i picchi nelle richieste. Non appena inizia un pull, è possibile aggiungere una nuova richiesta alla coda. Il valore predefinito è 10. Questo campo corrisponde all'opzione di configurazione kubelet registryBurst (v1beta1).
Il valore di registryPullQPS ha la precedenza su questa
impostazione. Ad esempio, con le impostazioni predefinite, sono consentiti i burst di un massimo di 10 query simultanee, ma devono essere elaborati alla velocità predefinita di cinque query al secondo. Questo comportamento di burst viene utilizzato solo quando registryPullQPS è maggiore di 0.
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta tramite gli upgrade del cluster. Per ulteriori informazioni, consulta Configurare le impostazioni pull delle immagini kubelet.
Facoltativo. Numero intero (non negativo). Specifica la velocità di elaborazione delle query per i pull delle query al secondo (QPS) dell'immagine di Container Registry.
Se il criterio registryPullQPS è impostato su un valore maggiore di 0, la frequenza delle query è limitata a quel numero di query al secondo. Se
registryPullQPS è impostato su 0, non sono previste
limitazioni sulla frequenza di query. Il valore predefinito è 5.
Questo campo corrisponde all'opzione di configurazione kubelet registryPullQPS (v1beta1).
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta tramite gli upgrade del cluster. Per ulteriori informazioni, consulta Configurare le impostazioni pull delle immagini kubelet.
Facoltativo. Booleano (true|false). Questo campo
specifica se le pull di Container Registry vengono elaborate in parallelo o
una alla volta. Il valore predefinito è true e specifica che i pull vengono elaborati uno alla volta. Se impostato su false, kubelet estrae le immagini in parallelo. Questo campo corrisponde all'opzione di configurazione kubelet serializeImagePulls (v1beta1).
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta tramite gli upgrade del cluster. Per ulteriori informazioni, consulta Configurare le impostazioni pull delle immagini kubelet.
Risorsa cluster
Facoltativo
Modificabile
gkeConnect
Questa sezione contiene informazioni sul progetto Google Cloud che vuoi utilizzare per connettere il tuo cluster a Google Cloud.
Risorsa cluster
Obbligatorio
Immutabile
gkeConnect.projectID
Obbligatorio: stringa. L'ID del progetto Google Cloud che vuoi utilizzare per connettere il cluster a Google Cloud. Questo è anche indicato come progetto host del parco risorse.
Questo valore non può essere modificato per i cluster esistenti.
Risorsa cluster
Obbligatorio
Immutabile
gkeConnect.location
Facoltativo. Stringa. Valore predefinito: global.
L'appartenenza al parco risorse per i tuoi cluster è gestita dal servizio parco risorse (gkehub.googleapis.com) e dal servizio Connect (gkeconnect.googleapis.com). L'appartenenza al parco risorse può essere globale o regionale. Facoltativamente, puoi utilizzare gkeConnect.location
per specificare la regione Google Cloud in cui vengono eseguiti il parco risorse e i servizi Connect, in modo da limitare il traffico alla tua regione.
I cluster creati con versioni precedenti alla 1.28 sono gestiti dai servizi globali Fleet e Connect.
I nuovi cluster creati utilizzando i client dell'API GKE On-Prem, come
la console Google Cloud, Google Cloud CLI o Terraform, utilizzano la stessa
regione specificata per l'API GKE On-Prem.
Per i nuovi cluster, se includi questo campo, la regione specificata deve essere uguale a quella configurata in gkeOnPremAPI.location. Se le regioni non corrispondono, la creazione del cluster non riesce.
Questo valore non può essere modificato per i cluster esistenti.
Risorsa cluster
Facoltativo
Immutabile
gkeOnPremAPI
Nella versione 1.16 e successive, se l'API GKE On-Prem è abilitata nel tuo progetto Google Cloud, tutti i cluster nel progetto vengono registrati automaticamente nell'API GKE On-Prem nella regione configurata in clusterOperations.location.
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 alcun cluster nel progetto, disabilita gkeonprem.googleapis.com (il nome del servizio per l'API GKE On-Prem) nel progetto. Per le istruzioni, vedi
Disabilitare
i servizi.
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 alcun cluster nel progetto, disabilita gkeonprem.googleapis.com (il nome del servizio per l'API GKE On-Prem) nel progetto. Per le istruzioni, vedi
Disabilitare
i servizi.
La registrazione del cluster di amministrazione o dell'utente nell'API GKE On-Prem consente di utilizzare strumenti standard come la console Google Cloud, Google Cloud CLI o
Terraform per visualizzare i dettagli del cluster e gestire il ciclo di vita del cluster. Ad esempio, puoi eseguire i comandi dell'interfaccia a riga di comando gcloud per
ottenere informazioni sul cluster.
L'API GKE On-Prem archivia i metadati sullo stato del cluster in Google Cloud.
Questi metadati consentono all'API di gestire il ciclo di vita del cluster. Gli strumenti standard utilizzano l'API GKE On-Prem e collettivamente sono definiti client dell'API GKE On-Prem.
Se imposti gkeOnPremAPI.enabled su true, prima di creare o aggiornare il cluster utilizzando bmctl, assicurati di eseguire i passaggi descritti in Prima di iniziare per abilitare e inizializzare l'API GKE On-Prem.
Dopo aver aggiunto questa sezione e creato o aggiornato il cluster, se in seguito rimuovi la sezione e aggiorni il cluster, l'aggiornamento non andrà a buon fine.
Se preferisci creare il cluster utilizzando uno strumento standard anziché bmctl, consulta quanto segue:
Quando crei un cluster con uno strumento standard, viene automaticamente registrato nell'API GKE On-Prem.
Risorsa cluster
Facoltativo
gkeOnPremAPI.enabled
Per impostazione predefinita, il cluster è 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 che il cluster è stato registrato nell'API GKE On-Prem, se devi annullare la registrazione del cluster, apporta la seguente modifica e aggiorna il cluster:
gkeOnPremAPI:
enabled: false
Risorsa cluster
Obbligatorio
Modificabile
gkeOnPremAPI.location
La regione Google Cloud in cui viene eseguita l'API GKE On-Prem e archivia i metadati del cluster. Scegli una delle
regioni supportate. Deve essere una stringa non vuota se gkeOnPremAPI.enabled è true. Se
gkeOnPremAPI.enabled è false, non
includere questo campo.
Se questa sezione non è inclusa nel file di configurazione, questo campo è impostato su clusterOperations.location.
Risorsa cluster
Facoltativo
Immutabile
kubevirt.useEmulation (deprecato)
Obsoleta. A partire dalla release 1.11.2, puoi abilitare o disabilitare
il runtime VM su GDC aggiornando solo la risorsa personalizzata VMRuntime.
Valore booleano. Determina se viene utilizzata o meno l'emulazione del software per eseguire le macchine virtuali. Se il nodo supporta la virtualizzazione hardware, imposta useEmulation su false per migliorare le prestazioni. Se la virtualizzazione hardware non è supportata o hai dubbi, impostala su true.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer
Questa sezione contiene le impostazioni per il bilanciamento del carico del cluster.
Risorsa cluster
Obbligatorio
Modificabile
loadBalancer.addressPools
Oggetti Il nome e un array di indirizzi IP per il pool del bilanciatore del carico del cluster. La configurazione del pool di indirizzi è valida solo per la modalità LB bundled nei cluster non di amministrazione. Puoi aggiungere nuovi pool di indirizzi in qualsiasi momento, ma non puoi rimuovere i pool di indirizzi esistenti.
Un pool di indirizzi esistente può essere modificato per modificare solo i campi avoidBuggyIPs
e manualAssign.
Risorsa cluster
Facoltativo
Immutabile
loadBalancer.addressPools.addresses
Array di intervalli di indirizzi IP. Specifica un elenco di intervalli IP non sovrapposti per il bilanciatore del carico del piano dati. Tutti gli indirizzi devono trovarsi nella stessa subnet dei nodi del bilanciatore del carico.
Stringa. Il nome che scegli per il pool del bilanciatore del carico del cluster.
Risorsa cluster
Obbligatorio
Immutabile
loadBalancer.addressPools.avoidBuggyIPs
Facoltativo. Booleano (true | false). Se true,
il pool omette gli indirizzi IP che terminano con .0 e .255.
Alcuni hardware di rete ignorano il traffico verso questi indirizzi speciali. Puoi omettere questo campo. Il valore predefinito è false.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.addressPools.manualAssign
Facoltativo. Booleano (true | false). Se true,
gli indirizzi in questo pool non vengono assegnati automaticamente ai servizi Kubernetes. Se true, un indirizzo IP in questo pool viene utilizzato solo quando è specificato esplicitamente da un servizio. Puoi omettere questo campo. Il valore predefinito è false.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.mode
Obbligatorio. Stringa. Specifica la modalità di bilanciamento del carico. In modalità bundled, Google Distributed Cloud installa un bilanciatore del carico sui nodi del bilanciatore del carico durante la creazione del cluster. In modalità manual, il cluster si basa su un bilanciatore del carico esterno configurato manualmente. Per maggiori informazioni, consulta
Panoramica dei bilanciatori del carico.
Valori consentiti: bundled | manual
Risorsa cluster
Obbligatorio
Immutabile
loadBalancer.type
Facoltativo. Stringa. Specifica il tipo di bilanciamento del carico in bundle utilizzato: livello 2 o BGP (Border Gateway Protocol). Se utilizzi il bilanciamento del carico standard in bundle, imposta type su layer2. Se utilizzi il bilanciamento del carico in bundle con BGP, imposta type su bgp. Se non imposti type, il valore predefinito è layer2.
Valori consentiti: layer2 | bgp
Risorsa cluster
Facoltativo
Immutabile
loadBalancer.nodePoolSpec
Facoltativo. Utilizza questa sezione per configurare un pool di nodi del bilanciatore del carico. I nodi specificati fanno parte del cluster Kubernetes ed eseguono carichi di lavoro e bilanciatori del carico normali. Se non specifichi un pool di nodi, per il bilanciamento del carico vengono utilizzati i nodi del piano di controllo. Questa sezione si applica solo quando la modalità di bilanciamento del carico è impostata su bundled.
Se vuoi impedire l'esecuzione di carichi di lavoro su un nodo nel pool di nodi del bilanciatore del carico, aggiungi la seguente incompatibilità al nodo:
node-role.kubernetes.io/load-balancer:NoSchedule
Google Distributed Cloud aggiunge tolleranze per questa incompatibilità ai pod richiesti per il bilanciamento del carico.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.nodePoolSpec.nodes
Questa sezione contiene un array di indirizzi IP per i nodi nel pool di nodi del bilanciatore del carico.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.nodePoolSpec.nodes.address
Facoltativo. Stringa (indirizzo IPv4). Indirizzo IP di un nodo. Sebbene i nodi nel pool di nodi del bilanciatore del carico possano eseguire carichi di lavoro, sono separati dai nodi nei pool di nodi worker. Non puoi includere un determinato nodo cluster in più di un pool di nodi. Gli indirizzi IP dei nodi sovrapposti bloccano la creazione del cluster e altre operazioni del cluster.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.nodePoolSpec.kubeletConfig
Facoltativo.
Questa sezione contiene i campi che configurano kubelet su tutti i nodi nel pool di nodi del piano di controllo.
Facoltativo. Numero intero (non negativo). Specifica il numero massimo di richieste di pull delle immagini che possono essere aggiunte alla coda di elaborazione per gestire i picchi nelle richieste. Non appena inizia un pull, è possibile aggiungere una nuova richiesta alla coda. Il valore predefinito è 10. Questo campo corrisponde all'opzione di configurazione kubelet registryBurst (v1beta1).
Il valore di registryPullQPS ha la precedenza su questa
impostazione. Ad esempio, con le impostazioni predefinite, sono consentiti i burst di un massimo di 10 query simultanee, ma devono essere elaborati alla velocità predefinita di cinque query al secondo. Questo comportamento di burst viene utilizzato solo quando registryPullQPS è maggiore di 0.
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta tramite gli upgrade del cluster. Per ulteriori informazioni, consulta Configurare le impostazioni pull delle immagini kubelet.
Facoltativo. Numero intero (non negativo). Specifica la velocità di elaborazione delle query per i pull delle query al secondo (QPS) dell'immagine di Container Registry.
Se il criterio registryPullQPS è impostato su un valore maggiore di 0, la frequenza delle query è limitata a quel numero di query al secondo. Se
registryPullQPS è impostato su 0, non sono previste
limitazioni sulla frequenza di query. Il valore predefinito è 5.
Questo campo corrisponde all'opzione di configurazione kubelet registryPullQPS (v1beta1).
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta tramite gli upgrade del cluster. Per ulteriori informazioni, consulta Configurare le impostazioni pull delle immagini kubelet.
Facoltativo. Booleano (true|false). Questo campo
specifica se le pull di Container Registry vengono elaborate in parallelo o
una alla volta. Il valore predefinito è true e specifica che i pull vengono elaborati uno alla volta. Se impostato su false, kubelet estrae le immagini in parallelo. Questo campo corrisponde all'opzione di configurazione kubelet serializeImagePulls (v1beta1).
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta tramite gli upgrade del cluster. Per ulteriori informazioni, consulta Configurare le impostazioni pull delle immagini kubelet.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.ports.controlPlaneLBPort
Numero. La porta di destinazione utilizzata per il traffico inviato al piano di controllo Kubernetes (server API Kubernetes).
Risorsa cluster
Obbligatorio
Immutabile
loadBalancer.vips.controlPlaneVIP
Obbligatorio. Specifica l'indirizzo IP virtuale (VIP) per connettersi al server API Kubernetes. Questo indirizzo non deve rientrare nell'intervallo di indirizzi IP utilizzati per i pool di indirizzi del bilanciatore del carico, loadBalancer.addressPools.addresses.
Risorsa cluster
Obbligatorio
Immutabile
loadBalancer.vips.ingressVIP
Facoltativo. Stringa (indirizzo IPv4). L'indirizzo IP che hai scelto di configurare sul bilanciatore del carico per il traffico in entrata.
Risorsa cluster
Facoltativo
Immutabile
loadBalancer.localASN
Facoltativo. Stringa. Specifica il numero di sistema autonomo (ASN) per il cluster in fase di creazione. Questo campo viene utilizzato durante la configurazione della soluzione di bilanciamento del carico in bundle che utilizza il protocollo BGP (Border Gateway Protocol).
Per maggiori informazioni, consulta
Configurare i bilanciatori del carico in bundle con BGP.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.bgpPeers
Facoltativo. Oggetto (elenco di mappature). Questa sezione specifica uno o più peer BGP (BGP) della rete locale (esterna al cluster). Specifica i peer BGP quando configuri il bilanciamento del carico del piano di controllo in una parte della soluzione di bilanciamento del carico in bundle che utilizza BGP. Ogni peer viene specificato con una mappatura composta da un indirizzo IP, un numero di sistema autonomo (ASN) e, facoltativamente, un elenco di uno o più indirizzi IP per i nodi del piano di controllo. La configurazione del peering BGP per il bilanciamento del carico del piano di controllo non può essere aggiornata dopo la creazione del cluster.
Facoltativo. Stringa. Il numero di sistema autonomo (ASN) per la rete
che contiene il dispositivo peer esterno. Specifica un ASN per ogni peer BGP configurato per il bilanciamento del carico del piano di controllo, quando configuri la soluzione di bilanciamento del carico in bundle che utilizza BGP.
Per maggiori informazioni, consulta
Configurare i bilanciatori del carico in bundle con BGP.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.bgpPeers.controlPlaneNodes
Facoltativo. Array di indirizzi IP (IPv4). Uno o più indirizzi IP per i nodi del piano di controllo che si connettono al peer BGP esterno, quando configuri la soluzione di bilanciamento del carico in bundle che utilizza BGP. Se non specifichi nessun nodo del piano di controllo, tutti i nodi del piano di controllo si connetteranno al peer esterno. Se specifichi uno o più indirizzi IP, solo i nodi specificati partecipano alle sessioni di peering.
Per maggiori informazioni, consulta
Configurare i bilanciatori del carico in bundle con BGP.
Risorsa cluster
Facoltativo
Modificabile
maintenanceBlocks.cidrBlocks
Facoltativo. Singolo indirizzo IPv4 o un intervallo di indirizzi IPv4. Specifica
gli indirizzi IP delle macchine nodo che vuoi attivare
in modalità di manutenzione. Per maggiori informazioni, consulta
Attivare la modalità di manutenzione
dei nodi.
Ad esempio:
maintenanceBlocks:
cidrBlocks:
- 192.168.1.200 # Single machine
- 192.168.1.100-192.168.1.109 # Ten machines
Risorsa cluster
Facoltativo
Modificabile
nodeAccess.loginUser
Facoltativo. Stringa. Specifica il nome utente non root che vuoi utilizzare per accedere alla funzionalità SUDO senza password alle macchine nodo nel tuo cluster. La chiave SSH, sshPrivateKeyPath, deve funzionare per l'utente specificato. Le operazioni di creazione e aggiornamento del cluster verificano che alle macchine nodo sia possibile accedere con l'utente e la chiave SSH specificati.
Risorsa cluster
Facoltativo
Modificabile
osEnvironmentConfig.addPackageRepo
Facoltativo. Booleano (true | false). Specifica se utilizzare o meno il tuo server di repository di pacchetti, anziché il repository Docker apt predefinito. Per utilizzare il tuo
repository di pacchetti, imposta addPackageRepo su
false. Utilizza questa funzionalità per saltare l'aggiunta di repository di pacchetti a ogni macchina bare metal nel deployment. Per maggiori
informazioni, consulta
Utilizzare un server di repository di pacchetti privato.
Risorsa cluster
Facoltativo
Immutabile
nodeConfig
Questa sezione contiene le impostazioni per la configurazione dei nodi cluster.
Risorsa cluster
Facoltativo
Modificabile (solo upgrade)
nodeConfig.containerRuntime (deprecato)
Ritirato. A partire dalla release 1.13.0, Google Distributed Cloud supporta containerd solo come runtime del container. Il campo containerRuntime è deprecato ed è stato rimosso dal file di configurazione del cluster generato. Per Google Distributed Cloud versione 1.13.0 e successive, se il file di configurazione del cluster contiene questo campo, il valore deve essere containerd.
Risorsa cluster
Facoltativo
Modificabile (solo upgrade)
nodeConfig.podDensity
Questa sezione specifica la configurazione della densità dei pod.
Risorsa cluster
Facoltativo
Immutabile
nodeConfig.podDensity.maxPodsPerNode
Facoltativo. Numero intero. Specifica il numero massimo di pod che possono essere eseguiti su un singolo nodo. Per i cluster autogestiti, i valori consentiti per maxPodsPerNode sono 32-250 per i cluster ad alta disponibilità e 64-250 per i cluster non ad alta disponibilità. Per i cluster utente, i valori consentiti per
maxPodsPerNode sono 32-250.
Il valore predefinito se non specificato è 110. Una volta creato il cluster, questo valore non può essere aggiornato.
Kubernetes assegna un blocco CIDR (Classless Inter-Domain Routing) a ciascun nodo, in modo che ogni pod possa avere un indirizzo IP univoco. Le dimensioni
del blocco CIDR corrispondono al numero massimo di pod per nodo.
Per ulteriori informazioni sull'impostazione del numero massimo di pod per nodo,
consulta Networking dei pod.
Questa sezione specifica una configurazione del registro privato a livello di nodo per i cluster utente. I registri privati a livello di nodo sono destinati all'utilizzo con i tuoi carichi di lavoro per offrirti un maggiore controllo sui pull delle immagini e sulla relativa sicurezza.
Per i cluster di amministrazione, il registro privato a livello di nodo è specificato nella sezione Credenziali del file di configurazione del cluster di amministrazione.
Se applicabile, utilizza questa sezione per specificare il nome e lo spazio dei nomi del secret creato per archiviare il certificato CA (CA radice del server) per il registro privato. Se il tuo registro locale non richiede un certificato TLS privato, puoi omettere questo blocco.
Il supporto per la configurazione di un registro privato a livello di nodo è disponibile in Anteprima solo per i cluster della versione 1.29.
Stringa. Questo campo specifica l'host e la porta per un singolo registro privato. Puoi specificare l'host con un nome di dominio o un indirizzo IP. Non includere il prefisso http o https.
Il campo host è obbligatorio quando specifichi un registro privato per un cluster utente.
Il supporto per la configurazione di un registro privato a livello di nodo è disponibile in Anteprima solo per i cluster della versione 1.29.
Se applicabile, utilizza questa sezione per specificare il nome e lo spazio dei nomi del secret creato per archiviare le credenziali del registro privato.
Utilizza il blocco pullCredentialSecretRef quando configuri un cluster utente per concedere ai nodi l'accesso a un registro privato che richiede l'autenticazione.
Il supporto per la configurazione di un registro privato a livello di nodo è disponibile in Anteprima solo per i cluster della versione 1.29.
Il supporto per la configurazione di un registro privato a livello di nodo è disponibile in Anteprima solo per i cluster della versione 1.29.
Risorsa cluster
Facoltativo
Modificabile
nodePoolUpgradeStrategy
Facoltativo. Questa sezione contiene le impostazioni per configurare la strategia di upgrade per i pool di nodi worker nel cluster. Per maggiori informazioni, consulta
Upgrade paralleli.
Risorsa cluster
Facoltativo
Modificabile
nodePoolUpgradeStrategy.concurrentNodePools
Facoltativo. Booleano (0 o 1). Valore predefinito: 1.
Questo campo specifica se eseguire o meno l'upgrade di tutti i pool di nodi worker per un cluster contemporaneamente. Per impostazione predefinita (1), esegui l'upgrade
in sequenza, uno dopo l'altro. Se imposti concurrentNodePools
su 0, ogni pool di nodi worker nel cluster esegue l'upgrade
in parallelo.
I nodi in ogni pool di nodi worker vengono aggiornati in base alla strategia di upgrade nella specifica del pool di nodi corrispondente.
Risorsa cluster
Facoltativo
Modificabile
nodePoolUpgradeStrategy.pause
Facoltativo. Booleano (true o false). Valore predefinito:
false. Questo campo specifica se mettere in pausa o riprendere l'upgrade di un cluster attivo.
Questa sezione contiene le informazioni di configurazione per i controlli di integrità periodici. Nella risorsa Cluster, l'unica impostazione disponibile per i controlli di integrità periodici è il campo enable. Per maggiori
informazioni, consulta
Controlli di integrità periodici.
Risorsa cluster
Facoltativo
Modificabile
periodicHealthCheck.enable
Facoltativo. Booleano (true|false). Abilita o disabilita i controlli di integrità periodici per il cluster. I controlli di integrità periodici sono abilitati per impostazione predefinita su tutti i cluster. Puoi disabilitare i controlli di integrità periodici per un cluster impostando il campo periodicHealthCheck.enable su false.
Per maggiori informazioni, consulta
Disattivare i controlli di integrità periodici
Risorsa cluster
Facoltativo
Modificabile
profile
Facoltativo. Stringa. Se profile è impostato su edge per un cluster autonomo, riduce al minimo il consumo di risorse del cluster. Il profilo perimetrale è disponibile solo per cluster autonomi.
Il profilo perimetrale ha requisiti di risorse di sistema ridotti ed è
consigliato per i dispositivi periferici con vincoli delle risorse restrittivi.
Per i requisiti hardware associati al profilo perimetrale, consulta
Requisiti delle risorse per i cluster autonomi che utilizzano il profilo perimetrale.
Risorsa cluster
Facoltativo
Immutabile
proxy
Se la tua rete è protetta da un server proxy, compila questa sezione.
In caso contrario, rimuovi questa sezione.
Risorsa cluster
Facoltativo
Modificabile
proxy.noProxy
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.
Risorsa cluster
Facoltativo
Immutabile
proxy.url
Stringa. L'indirizzo HTTP del tuo server proxy. Includi il numero di porta anche se è uguale alla porta predefinita dello schema.
Facoltativo. Booleano (true|false). Abilita o disabilita seccomp a livello di cluster. Se questo campo è disabilitato, i container senza un profilo seccomp nel file di configurazione del cluster vengono eseguiti senza limiti. Se questo campo è abilitato, gli stessi container vengono protetti tramite il profilo seccomp predefinito del runtime dei container. Questa funzione è attivata per impostazione predefinita.
Dopo la creazione del cluster, questo campo può essere attivato/disattivato solo durante l'upgrade.
Per maggiori informazioni, consulta
Utilizzare seccomp per limitare i contenitori.
Risorsa cluster
Facoltativo
Modificabile (solo upgrade)
clusterSecurity.enableRootlessContainers
Facoltativo. Booleano (true|false). Attiva o disattiva i container di sistema bare metal rootless. Se questo campo è abilitato, i container di sistema bare metal vengono eseguiti come utente non root con un ID utente compreso tra 2000 e 5000. Se questa opzione è disattivata, i container di sistema bare metal vengono eseguiti come utente root. Questa funzione è attiva per impostazione predefinita. La disattivazione di questa funzionalità è fortemente sconsigliata, perché l'esecuzione di container come utente root rappresenta un rischio per la sicurezza. Dopo la creazione del cluster, questo campo può essere attivato/disattivato solo durante l'upgrade. Per maggiori informazioni, consulta Non eseguire container come utente root.
Risorsa cluster
Facoltativo
Modificabile (solo upgrade)
clusterSecurity.authorization
Facoltativo. L'autorizzazione configura l'accesso degli utenti al cluster.
Risorsa cluster
Facoltativo
Modificabile
clusterSecurity.authorization.clusterAdmin
Facoltativo. Specifica l'amministratore per questo cluster.
Facoltativo. Il campo gcpAccounts specifica un elenco di account a cui viene concesso il ruolo di controllo dell'accesso basato su ruoli (RBAC) di Kubernetes clusterrole/cluster-admin. Gli account con questo ruolo hanno accesso completo a tutte le risorse del cluster in tutti gli spazi dei nomi. Questo campo configura anche i criteri RBAC che consentono agli account specificati di utilizzare il gateway di connessione per eseguire i comandi kubectl sul cluster. Ciò è pratico se hai più cluster da gestire, in particolare in un ambiente ibrido con cluster GKE e cluster on-premise.
Questo campo accetta un array di nomi account. Gli account utente e
gli account di servizio sono supportati. Per gli utenti, devi specificare gli indirizzi email dei loro account Google Cloud. Per gli account di servizio, specifica gli indirizzi email nel seguente formato: SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com.
Ad esempio:
Quando aggiorni un cluster per aggiungere un account, assicurati di includere tutti
gli account nell'elenco (sia quelli esistenti sia quelli nuovi) perché il
comando di aggiornamento sovrascrive l'elenco con ciò che hai specificato nell'aggiornamento.
Questo campo si applica solo ai cluster che possono eseguire carichi di lavoro. Ad
esempio, non puoi specificare gcpAccounts per i cluster
di amministrazione.
Risorsa cluster
Facoltativo
Modificabile
clusterSecurity.startUIDRangeRootlessContainers
Facoltativo. Numero intero. Valore predefinito: 2000. I container di sistema in Google Distributed Cloud aiutano a installare e gestire i cluster. Gli ID utente (UID) e gli ID gruppo (GID) utilizzati da questi container possono essere controllati dal campo startUIDRangeRootlessContainers nella specifica del cluster. I container di sistema utilizzano gli UID e i GID compresi nell'intervallo da
startUIDRangeRootlessContainers a
startUIDRangeRootlessContainers + 2999, che fornisce un intervallo
compreso tra 2000 e 4999 per impostazione predefinita. Quando aggiorni
startUIDRangeRootlessContainers, seleziona un valore che garantisca
che gli spazi UID e GID utilizzati dai container di sistema non si sovrappongano
a quelli assegnati ai carichi di lavoro utente. Il valore startUIDRangeRootlessContainers può essere modificato solo durante gli upgrade.
Obbligatorio. Stringa. Utilizza il campo path per specificare il percorso della macchina host in cui è possibile rilevare i dischi montati. Viene creato un PersistentVolume (PV) locale per ogni montaggio. Il percorso predefinito è
/mnt/localpv-share. Per istruzioni su come configurare i montaggi dei nodi, consulta Configurare i montaggi dei nodi LVP.
Risorsa cluster
Obbligatorio
Immutabile
storage
Questa sezione contiene le impostazioni per lo spazio di archiviazione del cluster.
Risorsa cluster
Obbligatorio
Immutabile
storage.lvpNodeMounts
Questa sezione specifica la configurazione (percorso) per i volumi permanenti locali supportati dai dischi montati. Devi formattare e montare questi dischi autonomamente. Puoi eseguire questa attività prima o dopo la creazione del cluster. Per
maggiori informazioni, consulta
Montaggi dei nodi LVP.
Risorsa cluster
Obbligatorio
Immutabile
storage.lvpShare
Questa sezione specifica la configurazione per i volumi permanenti locali supportati da sottodirectory in un file system condiviso. Queste sottodirectory vengono create automaticamente durante la creazione del cluster.
Per maggiori informazioni, consulta la pagina
Condivisione
LVP.
Risorsa cluster
Obbligatorio
Immutabile
storage.lvpShare.path
Obbligatorio. Stringa. Utilizza il campo path per specificare il percorso della macchina host in cui è possibile creare le sottodirectory. Viene creato un PersistentVolume (PV) locale per ogni sottodirectory. Per istruzioni su come configurare la condivisione LVP, consulta Configurare una condivisione LVP.
Risorsa cluster
Obbligatorio
Immutabile
storage.lvpShare.numPVUnderSharedPath
Obbligatorio. Stringa. Specifica il numero di sottodirectory da creare in
lvpShare.path. Il valore predefinito è 5. Per istruzioni su come configurare la condivisione LVP, consulta Configurare una condivisione LVP.
Risorsa cluster
Obbligatorio
Immutabile
storage.lvpShare.storageClassName
Obbligatorio. Stringa. Specifica il valore di StorageClass da utilizzare per creare volumi permanenti. L'oggetto StorageClass viene creato durante la creazione del cluster. Il valore predefinito è local-shared. Per istruzioni su come configurare la condivisione LVP, consulta Configurare una condivisione LVP.
Risorsa cluster
Facoltativo
Immutabile
type
Obbligatorio. Stringa. Specifica il tipo di cluster. Il modello di deployment standard è composto da un singolo cluster di amministrazione e uno o più cluster utente, gestiti dal cluster di amministrazione.
Google Distributed Cloud supporta i seguenti tipi di cluster:
Amministratore: cluster utilizzato per gestire i cluster utente.
Utente: cluster utilizzato per eseguire i carichi di lavoro.
Ibrido: cluster singolo per l'amministrazione e i carichi di lavoro, in grado di gestire anche i cluster utente.
Autonomo: un singolo cluster che può amministrare sé stesso e che può anche eseguire carichi di lavoro, ma non può creare o gestire altri cluster utente.
Il tipo di cluster viene specificato al momento della creazione del cluster e non può essere modificato per aggiornamenti o upgrade. Per saperne di più su come creare un cluster, consulta Creazione dei cluster: panoramica.
Valori consentiti: admin | user | hybrid | standalone
Questo valore non può essere modificato per i cluster esistenti.
Risorsa cluster
Obbligatorio
Immutabile
name
Obbligatorio. Stringa. In genere, il nome dello spazio dei nomi utilizza il pattern cluster-CLUSTER_NAME, ma il prefisso cluster- non è strettamente richiesto dalla release 1.7.2 di Google Distributed Cloud.
Questo valore non può essere modificato per i cluster esistenti.
Risorsa spazio dei nomi
Obbligatorio
Immutabile
clusterName
Stringa. Obbligatorio. Il nome del cluster a cui stai aggiungendo il pool di nodi. Crea la risorsa del pool di nodi nello stesso spazio dei nomi del cluster associato e fai riferimento al nome del cluster in questo campo. Per
maggiori informazioni, consulta
Aggiungere e rimuovere
pool di nodi in un cluster.
Facoltativo. Numero intero (non negativo). Specifica la quantità massima di richieste di pull delle immagini che possono essere aggiunte alla coda di elaborazione per gestire i picchi nelle richieste. Non appena inizia un pull, è possibile aggiungere una nuova richiesta alla coda. Il valore predefinito è 10. Questo campo corrisponde all'opzione di configurazione kubelet registryBurst (v1beta1).
Il valore di registryPullQPS ha la precedenza su questa
impostazione. Ad esempio, con le impostazioni predefinite, sono consentiti i burst di un massimo di 10 query simultanee, ma devono essere elaborati alla velocità predefinita di cinque query al secondo. Questo comportamento di burst viene utilizzato solo quando registryPullQPS è maggiore di 0.
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta tramite gli upgrade del cluster. Per ulteriori informazioni, consulta Configurare le impostazioni pull delle immagini kubelet.
Risorsa Pool di nodi
Facoltativo
Modificabile
kubeletConfig.registryPullQPS
Facoltativo. Numero intero (non negativo). Specifica la velocità di elaborazione delle query per i pull delle query al secondo (QPS) dell'immagine di Container Registry.
Se il criterio registryPullQPS è impostato su un valore maggiore di 0, la frequenza delle query è limitata a quel numero di query al secondo. Se
registryPullQPS è impostato su 0, non sono previste
limitazioni sulla frequenza di query. Il valore predefinito è 5.
Questo campo corrisponde all'opzione di configurazione kubelet registryPullQPS (v1beta1).
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta tramite gli upgrade del cluster. Per ulteriori informazioni, consulta Configurare le impostazioni pull delle immagini kubelet.
Risorsa Pool di nodi
Facoltativo
Modificabile
kubeletConfig.serializeImagePulls
Facoltativo. Booleano (true|false). Questo campo
specifica se le pull di Container Registry vengono elaborate in parallelo o
una alla volta. Il valore predefinito è true e specifica che i pull vengono elaborati uno alla volta. Se impostato su false, kubelet estrae le immagini in parallelo. Questo campo corrisponde all'opzione di configurazione kubelet serializeImagePulls (v1beta1).
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta tramite gli upgrade del cluster. Per ulteriori informazioni, consulta Configurare le impostazioni pull delle immagini kubelet.
Risorsa Pool di nodi
Facoltativo
Modificabile
taints
Facoltativo. Oggetti Un'incompatibilità dei nodi consente di contrassegnare un nodo in modo che lo scheduler ne eviti o ne impedisca l'utilizzo per determinati pod. Un'incompatibilità
è composta da una coppia chiave-valore e da un effetto associato. I valori key e value sono stringhe che utilizzi per identificare l'incompatibilità, mentre il valore effect specifica la modalità di gestione dei pod per il nodo. L'oggetto taints può avere
più incompatibilità.
Il campo effect può avere uno dei seguenti valori:
NoSchedule: nessun pod è in grado di eseguire la pianificazione sul nodo a meno che non abbia una tolleranza corrispondente.
PreferNoSchedule: il sistema evita di posizionare un pod che non tollera l'incompatibilità sul nodo, ma non è obbligatorio.
NoExecute: i pod che non tollerano l'incompatibilità vengono rimossi immediatamente, mentre i pod che tollerano l'incompatibilità non vengono mai rimossi.
Per Google Distributed Cloud, le incompatibilità vengono riconciliate con i nodi del
pool di nodi a meno che al cluster non venga applicata
l'annotazione baremetal.cluster.gke.io/label-taint-no-sync. Per maggiori informazioni sulle
incompatibilità, consulta
Incompatibilità e tolleranze.
Ad esempio:
taints:
- key: status
value: testpool
effect: NoSchedule
Risorsa Pool di nodi
Facoltativo
Modificabile
labels
Facoltativo. Mappatura (coppie chiave-valore).
Le etichette vengono riconciliate con i nodi del pool di nodi, a meno che al cluster non venga applicata l'annotazione baremetal.cluster.gke.io/label-taint-no-sync. Per maggiori informazioni sulle etichette, consulta
Etichette e selettori.
Risorsa Pool di nodi
Facoltativo
Modificabile
upgradeStrategy
Facoltativo. Questa sezione contiene le impostazioni per configurare la strategia di upgrade per i nodi in un pool di nodi worker. Per maggiori informazioni, consulta
Upgrade paralleli.
Nota: non aggiungere questa sezione per i pool di nodi del piano di controllo o del bilanciatore del carico.
Risorsa Pool di nodi
Facoltativo
Modificabile
upgradeStrategy.parallelUpgrade
Facoltativo. Questa sezione contiene le impostazioni per configurare gli upgrade dei nodi paralleli per un pool di nodi worker. In un tipico upgrade predefinito del cluster, ogni nodo del cluster viene eseguito in sequenza, uno dopo l'altro. Puoi configurare pool di nodi worker in modo da eseguire l'upgrade di più nodi in parallelo quando esegui l'upgrade del cluster. L'upgrade dei nodi in parallelo velocizza in modo significativo gli upgrade dei cluster, soprattutto per i cluster con centinaia di nodi.
Per un pool di nodi worker, puoi specificare il numero di nodi di cui eseguire l'upgrade contemporaneamente e impostare una soglia minima per il numero di nodi in grado di eseguire carichi di lavoro durante il processo di upgrade.
Facoltativo. Numero intero (positivo). Valore predefinito: 1. Massimo: 15.
Per impostazione predefinita (1), l'upgrade dei nodi viene eseguito in sequenza, uno dopo l'altro. Se imposti concurrentNodes su un numero maggiore di 1, questo campo specifica il numero di nodi di cui eseguire l'upgrade in parallelo. Nota i seguenti vincoli per concurrentNodes:
Il valore non può superare il 50% inferiore tra il numero di nodi nel pool di nodi o il numero fisso 15. Ad esempio, se il pool di nodi contiene 20 nodi, non puoi specificare un valore maggiore di 10. Se il pool di nodi contiene 100 nodi, 15 è il valore massimo che puoi specificare.
Se utilizzi questo campo insieme al campo minimumAvailableNodes, i relativi valori combinati non possono superare il numero totale di nodi nel pool di nodi. Ad esempio, se il pool di nodi ha 20 nodi e minimumAvailableNodes è impostato su 18, concurrentNodes non può superare 2.
Gli upgrade paralleli non rispettano il budget di interruzione dei pod (PDB).
Se i tuoi carichi di lavoro sono sensibili alle interruzioni, ti consigliamo di specificare minimumAvailableNodes per garantire che una determinata quantità di nodi rimanga disponibile per eseguire i carichi di lavoro durante il processo di upgrade. Per maggiori informazioni, consulta
Upgrade paralleli.
Facoltativo. Numero intero (non negativo). Valore predefinito: dipende da concurrentNodes. Per maggiori dettagli sui valori predefiniti per minimumAvailableNodes, consulta
Valori predefiniti per upgrade parallelo. minimumAvailableNodes consente di specificare la quantità di nodi nel pool di nodi che deve rimanere disponibile per tutta la durata del processo di upgrade. Un nodo è considerato non disponibile
quando l'upgrade è in corso. Un nodo è considerato non disponibile anche quando una delle seguenti condizioni è vera:
Il nodo è in modalità di manutenzione
Il nodo è in fase di riconciliazione
Il nodo è bloccato durante un upgrade
Se utilizzi questo campo insieme al campo concurrentNodes, i relativi valori combinati non possono superare il numero totale di nodi nel pool di nodi. Ad esempio, se il pool di nodi ha 20 nodi e
concurrentNodes è impostato su 10,
minimumAvailableNodes non può superare 10.
Un valore elevato per minimumAvailableNodes riduce al minimo i problemi di capacità per la pianificazione dei pod e, di conseguenza, aiuta a proteggere i carichi di lavoro durante l'upgrade del cluster. Tuttavia, un valore elevato di minimumAvailableNodes
aumenta il rischio di blocco dell'upgrade in attesa che i nodi
diventino disponibili. Per maggiori informazioni, consulta
Upgrade paralleli.
Facoltativo. Utilizza questa sezione per specificare un registro privato da utilizzare per le immagini dei carichi di lavoro. Questo metodo di configurazione del registro privato nella sezione delle credenziali del file di configurazione del cluster è destinato solo ai cluster ibridi o autonomi con pool di nodi worker.
Stringa. Questo campo specifica l'host e la porta per un singolo registro privato. Puoi specificare l'host con un nome di dominio o un indirizzo IP. Non includere il prefisso http o https.
Il campo host è obbligatorio quando specifichi un registro privato per un cluster ibrido o autonomo.
Facoltativo. Stringa. Percorso del file del certificato CA (CA radice del server) se il server del registry utilizza un certificato TLS privato. Se il tuo registro locale non richiede un certificato TLS privato, puoi omettere questo campo.
Utilizza il campo pullCredentialConfigPath quando configuri un cluster ibrido o autonomo per concedere ai nodi l'accesso a un registro privato che richiede l'autenticazione.
Credenziali
Facoltativo
Modificabile
registryMirrors
Facoltativo. Utilizza questa sezione per specificare un mirror del registro da utilizzare per l'installazione dei cluster, anziché Container Registry (gcr.io). Per ulteriori informazioni sull'utilizzo di un mirror del registro, consulta Installare Google Distributed Cloud utilizzando un mirror del registro.
Stringa. L'endpoint del mirror, costituito dall'indirizzo IP del server del registry e dal numero di porta. Facoltativamente, puoi utilizzare il tuo spazio dei nomi nel server del registry anziché lo spazio dei nomi principale. Senza uno spazio dei nomi, il formato dell'endpoint è REGISTRY_IP:PORT. Quando utilizzi uno spazio dei nomi, il formato dell'endpoint è REGISTRY_IP:PORT/v2/NAMESPACE.
/v2 è obbligatorio quando si specifica uno spazio dei nomi.
Il campo endpoint è obbligatorio quando specifichi un mirror del registro. Puoi specificare più mirror/endpoint.
Facoltativo. Stringa. Percorso del file del certificato CA (CA radice del server) se il server del registry utilizza un certificato TLS privato. Se il tuo registro locale non richiede un certificato TLS privato, puoi omettere questo campo.
Mirroring del registro
Facoltativo
Modificabile
registryMirrors.pullCredentialConfigPath
Facoltativo. Stringa. Percorso del
file di configurazione dell'interfaccia a riga di comando Docker, config.json. Docker salva le impostazioni di autenticazione nel file di configurazione. Questo campo si applica solo all'uso dei mirror del registro. Se il tuo server del registry non richiede un file di configurazione Docker per l'autenticazione, puoi omettere questo campo.
Facoltativo. Un array di nomi di dominio per gli host di cui viene eseguito il mirroring localmente per il Mirror del registro specificato (endpoint). Quando il runtime del container rileva richieste di pull per le immagini da un host specificato, controlla prima il Mirror del registro locale. Per ulteriori informazioni, consulta Creare cluster dal mirror del registro.
Il file di configurazione del cluster generato da bmctl per Google Distributed Cloud include campi per specificare i percorsi dei file di credenziali e chiavi nel file system locale. Le credenziali e le chiavi necessarie per connettere i tuoi cluster tra loro e al tuo progetto Google Cloud.
Stringa. Il percorso della chiave dell'account di servizio di Container Registry. L'account di servizio di Container Registry
è un agente di servizio che agisce per conto di Container Registry quando
interagisce con i servizi Google Cloud.
Credenziali
Facoltativo
Modificabile
sshPrivateKeyPath
Stringa. Il percorso della chiave privata SSH. Per l'accesso ai nodi è necessario il protocollo SSH.
Credenziali
Facoltativo
Modificabile
gkeConnectAgentServiceAccountKeyPath
Stringa. Il percorso della chiave dell'account di servizio dell'agente.
Google Distributed Cloud utilizza questo account di servizio per mantenere una connessione tra Google Distributed Cloud e Google Cloud.
Stringa. Il percorso della chiave dell'account di servizio di registrazione.
Google Distributed Cloud utilizza questo account di servizio per registrare i cluster
utente in Google Cloud.
Stringa. Il percorso della chiave dell'account di servizio delle operazioni.
Google Distributed Cloud utilizza l'account di servizio operativo per eseguire l'autenticazione con Google Cloud Observability per accedere all'API Logging e all'API Monitoring.
Definisce la configurazione per l'intervallo CIDR IPv4. È necessario specificare almeno uno dei
campi ipv4 o ipv6 per la
risorsa ClusterCidrConfig.
Risorsa ClusterCIDRConfig
Facoltativo
Immutabile
ipv4.cidr
Stringa. Imposta il blocco CIDR del nodo IPv4. I nodi possono avere un solo intervallo per ogni famiglia. Questo blocco CIDR deve corrispondere al CIDR del pod descritto nella risorsa Cluster.
Ad esempio:
ipv4:
cidr: "10.1.0.0/16"
Risorsa ClusterCIDRConfig
Obbligatorio
Immutabile
ipv4.perNodeMaskSize
Numero intero. Definisce le dimensioni di maschera per il blocco CIDR IPv4 del nodo. Ad esempio, il valore 24 corrisponde a una netmask /24. Assicurati che la netmask del blocco CIDR del nodo sia superiore al numero massimo di pod che il kubelet può pianificare, definito nel flag --max-pods di kubelet.
Risorsa ClusterCIDRConfig
Obbligatorio
Immutabile
ipv6
Definisce la configurazione per l'intervallo CIDR IPv6. È necessario specificare almeno uno dei
campi ipv4 o ipv6 per la
risorsa ClusterCidrConfig.
Risorsa ClusterCIDRConfig
Facoltativo
Immutabile
ipv6.cidr
Stringa. Imposta il blocco CIDR del nodo IPv6. I nodi possono avere un solo intervallo per ogni famiglia.
Ad esempio:
ipv6:
cidr: "2620:0:1000:2631:3:10:3:0/112"
Risorsa ClusterCIDRConfig
Obbligatorio
Immutabile
ipv6.perNodeMaskSize
Numero intero. Definisce le dimensioni di maschera per il blocco CIDR IPv6 del nodo. Ad esempio, il valore 120 corrisponde a una netmask /120. Assicurati che la netmask del blocco CIDR del nodo sia superiore al numero massimo di pod che il kubelet può pianificare, definito nel flag --max-pods di kubelet.
Risorsa ClusterCIDRConfig
Obbligatorio
Immutabile
nodeSelector.matchLabels
Definisce i nodi a cui è applicabile la configurazione CIDR. Un selettore di nodi vuoto funziona come impostazione predefinita e si applica a tutti i nodi.
