Questa pagina descrive i campi supportati nel file di configurazione dei cluster GKE su Bare Metal. Per ogni campo, la tabella seguente indica se il campo è obbligatorio. La tabella mostra anche quali campi sono modificabili, ovvero quali
campi possono essere modificati dopo la creazione di un cluster. Come indicato nella tabella, alcuni campi modificabili possono essere modificati solo durante un upgrade del 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. Anche se alcuni campi hanno valori predefiniti e altri, come metadata.name, possono essere compilati automaticamente, questo file di configurazione in formato YAML è un modello per specificare informazioni sul cluster.
Per creare un nuovo file di configurazione del cluster, utilizza il comando seguente 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, consulta Esempio di file di configurazione del cluster.
Compilazione del file di configurazione
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 viene impostato per la creazione e gli upgrade dei 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 in GKE su cluster Bare Metal.
Risorsa cluster
—
—
authentication.oidc.certificateAuthorityData
Facoltativo. Un
certificato con codifica PEM con codifica base64 per il provider OIDC. Per creare la stringa, codifica il certificato, incluse le intestazioni, in base64. Includi la stringa risultante in
certificateAuthorityData come singola riga.
Ad esempio (esempio di testo inserito per adattarlo 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. Valore 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 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, se un gruppo è dev e ha un prefisso
oidc:, oidc:dev.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.group
Facoltativo. Stringa.
JWT
che il provider utilizza per restituire i gruppi di sicurezza.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.issuerURL
Facoltativo. Stringa 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 individuare le chiavi pubbliche per la verifica dei token. L'URL deve utilizzare HTTPS.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.kubectlRedirectURL
Facoltativo. Stringa 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 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 da utilizzare come nome utente. Se non specificato, il valore predefinito è sub.
Risorsa cluster
Facoltativo
Immutabile
bypassPreflightCheck
Facoltativo. Valore booleano (true|false). Se impostato su
true, i controlli preflight interni vengono ignorati quando
applichi le risorse ai cluster esistenti. Il valore predefinito è false.
Mutabilità: 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 funzioni utilizzano il gateway di rete per GDC. Il gateway di rete per GDC è il componente chiave per abilitare le funzionalità di networking avanzate in GKE Enterprise e Google Kubernetes Engine (GKE). Uno dei principali vantaggi del gateway di rete per GDC è che può allocare dinamicamente indirizzi IP mobili da un set di indirizzi specificato in una risorsa NetworkGatewayGroup personalizzata.
Valore booleano. Imposta questo campo su false per disabilitare le funzionalità Ingress in bundle con GKE su Bare Metal. Le funzionalità Ingress in bundle per il cluster supportano solo il traffico in entrata. Se esegui l'integrazione con Istio o Anthos Service Mesh per usufruire di ulteriori vantaggi di un mesh di servizi completamente funzionale, ti consigliamo di disabilitare Ingress in bundle. Questo campo è impostato su true per impostazione predefinita. Questo campo non è presente nel file di configurazione del cluster generato. Puoi disabilitare Ingress in bundle solo per i cluster versione 1.13.0 e successive.
Valore booleano. Imposta questo campo su true per abilitare il modello di networking dei cluster in modalità flat. In modalità flat, ogni pod ha il proprio indirizzo IP univoco. I pod possono comunicare direttamente tra loro senza la necessità di un gateway intermedio o di un NAT (Network Address Translation).
flatIPv4 è false per impostazione predefinita. Puoi abilitare la modalità flat solo durante la creazione del cluster. Dopo aver abilitato la modalità flat per il 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 di origine (SNAT) è la modalità di networking predefinita. La modalità Direct Server Return (DSR) risolve 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 maschera di /18, che corrisponde a una dimensione di 14 bit (16.384 indirizzi IP).
Intervallo CIDR massimo dei pod: valore 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 tuo cluster.
Per saperne di più sulla configurazione e sull'utilizzo del networking SR-IOV, consulta la documentazione sulla configurazione del 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 di servizio (VIP). Gli intervalli non devono sovrapporsi ad alcuna subnet raggiungibile dalla tua rete. Per maggiori informazioni sull'allocazione degli indirizzi per i internet privati, consulta RFC 1918.
A partire dalla release 1.15.0 di GKE su Bare Metal, 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 Aumentare l'intervallo della rete di servizi.
Puoi aumentare solo 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 maschera di
/24, che corrisponde a una dimensione di 8 bit (256
indirizzi).
Intervallo massimo del CIDR del servizio: valore 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 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 analizzare le 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 vuoi archiviare i log di Logging e le metriche di Monitoring.
È una buona idea scegliere una regione vicina al tuo data center on-premise. Per maggiori informazioni, consulta la pagina
Località globali.
Ad esempio:
location: us-central1
Risorsa cluster
Obbligatorio
Immutabile
clusterOperations.projectID
Stringa. L'ID del progetto Google Cloud in cui vuoi visualizzare log e 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). Il nome alternativo del soggetto (SAN) è una funzionalità dei certificati SSL che consente di definire i nomi di dominio e i sottodomini per i quali vuoi che un certificato sia valido. In un cluster GKE su Bare Metal, 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 ulteriori SAN al certificato del server API per il cluster. I nomi di dominio devono essere conformi a 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 corrisponde a un indirizzo IP per una singola macchina oppure a tre macchine per un deployment ad alta disponibilità.
Facoltativo. Numero intero (non negativo). Specifica la quantità massima di richieste di pull dell'immagine che possono essere aggiunte alla coda di elaborazione per gestire i picchi nelle richieste. Non appena viene avviata la modalità pull, è possibile aggiungere una nuova richiesta alla coda. Il valore predefinito è 10. Questo campo corrisponde all'opzione della configurazione kubelet (v1beta1) di registryBurst.
Il valore per registryPullQPS ha la precedenza su questa
impostazione. Ad esempio, con le impostazioni predefinite, sono consentite fino a 10 query simultanee, ma devono essere elaborate alla
frequenza 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 maggiori
informazioni, consulta
Configurare le impostazioni di pull dell'immagine kubelet.
Facoltativo. Numero intero (non negativo). Specifica la velocità di elaborazione delle query per il pull delle immagini al secondo (QPS) delle immagini di Container Registry.
Se il valore di registryPullQPS è maggiore di 0, la frequenza di query è limitata al numero di query al secondo. Se
registryPullQPS è impostato su 0, non sono previste
limitazioni alla frequenza di query. Il valore predefinito è 5.
Questo campo corrisponde all'opzione della configurazione kubelet (v1beta1) di registryPullQPS.
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 maggiori
informazioni, consulta
Configurare le impostazioni di pull dell'immagine kubelet.
Facoltativo. Valore booleano (true|false). Questo campo
specifica se i pull di Container Registry vengono elaborati in parallelo o
uno alla volta. Il valore predefinito è true, specificando che i pull vengono elaborati uno alla volta. Se impostato su false, kubelet esegue il pull delle immagini in parallelo. Questo campo corrisponde all'opzione della configurazione kubelet (v1beta1) di serializeImagePulls.
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 maggiori
informazioni, consulta
Configurare le impostazioni di pull dell'immagine kubelet.
Risorsa cluster
Facoltativo
Modificabile
gkeConnect
Questa sezione contiene le informazioni sul progetto Google Cloud che vuoi utilizzare per connettere il 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. È definito anche 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 Fleet Service (gkehub.googleapis.com) e dal servizio Connect (gkeconnect.googleapis.com). L'appartenenza al parco risorse può essere globale o a livello di regione. Facoltativamente, puoi utilizzare gkeConnect.location per specificare la regione Google Cloud in cui vengono eseguiti il parco risorse e i servizi Connect, in modo che il traffico sia limitato alla regione.
Per un elenco delle regioni supportate, consulta Regioni supportate per l'API GKE On-Prem.
Se non specificato, vengono utilizzate le istanze globali dei servizi.
Tieni presente quanto segue:
I cluster creati con versioni precedenti alla 1.28 sono gestiti dai servizi globali del parco risorse e Connect.
I nuovi cluster creati con i client 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 corrispondere a quella configurata in
gkeOnPremAPI.location. Se le regioni non sono uguali, 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 che lo compongono 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, consulta
Disabilitazione dei
servizi.
La registrazione del tuo cluster di amministrazione o utente nell'API GKE On-Prem ti 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 gcloud CLI per
ottenere informazioni sul cluster.
L'API GKE On-Prem archivia i metadati dello 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 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 aver 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 utilizzando uno strumento standard, viene automaticamente registrato nell'API GKE On-Prem.
Risorsa cluster
Facoltativo
gkeOnPremAPI.enabled
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 annullarne la registrazione, apporta la modifica seguente e poi aggiorna il cluster:
gkeOnPremAPI:
enabled: false
Risorsa cluster
Obbligatorio
Modificabile
gkeOnPremAPI.location
La regione Google Cloud in cui l'API GKE On-Prem esegue 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
Oggetto. 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à Bilanciatore del carico 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 cambiare 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. Valore booleano (true | false). Se true,
il pool omette gli indirizzi IP che terminano con .0 e .255.
Alcuni hardware di rete eliminano il traffico verso questi indirizzi speciali. Puoi omettere questo campo, il suo valore predefinito è false.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.addressPools.manualAssign
Facoltativo. Valore 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 se specificato esplicitamente da un servizio. Puoi omettere questo campo, il suo valore predefinito è false.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.mode
obbligatorio. Stringa. Specifica la modalità di bilanciamento del carico. In modalità bundled, GKE su Bare Metal 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 la 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,
Layer 2 o Border Gateway Protocol (BGP). Se utilizzi il bilanciamento del carico in bundle standard, imposta type su layer2. Se utilizzi il bilanciamento del carico in bundle con BGP, imposta type su bgp. Se non configuri type, il valore predefinito sarà 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 normali carichi di lavoro e bilanciatori del carico. Se non specifichi un pool di nodi, i nodi del piano di controllo vengono utilizzati per il bilanciamento del carico. Questa sezione si applica solo quando la modalità di bilanciamento del carico è impostata su bundled.
Se vuoi impedire l'esecuzione dei 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
GKE su Bare Metal 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 dell'immagine che possono essere aggiunte alla coda di elaborazione per gestire i picchi nelle richieste. Non appena viene avviata la modalità pull, è possibile aggiungere una nuova richiesta alla coda. Il valore predefinito è 10. Questo campo corrisponde all'opzione della configurazione kubelet (v1beta1) di registryBurst.
Il valore per registryPullQPS ha la precedenza su questa
impostazione. Ad esempio, con le impostazioni predefinite, sono consentite fino a 10 query simultanee, ma devono essere elaborate alla
frequenza 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 maggiori
informazioni, consulta
Configurare le impostazioni di pull dell'immagine kubelet.
Facoltativo. Numero intero (non negativo). Specifica la velocità di elaborazione delle query per il pull delle immagini al secondo (QPS) delle immagini di Container Registry.
Se il valore di registryPullQPS è maggiore di 0, la frequenza di query è limitata al numero di query al secondo. Se
registryPullQPS è impostato su 0, non sono previste
limitazioni alla frequenza di query. Il valore predefinito è 5.
Questo campo corrisponde all'opzione della configurazione kubelet (v1beta1) di registryPullQPS.
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 maggiori
informazioni, consulta
Configurare le impostazioni di pull dell'immagine kubelet.
Facoltativo. Valore booleano (true|false). Questo campo
specifica se i pull di Container Registry vengono elaborati in parallelo o
uno alla volta. Il valore predefinito è true, specificando che i pull vengono elaborati uno alla volta. Se impostato su false, kubelet esegue il pull delle immagini in parallelo. Questo campo corrisponde all'opzione della configurazione kubelet (v1beta1) di serializeImagePulls.
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 maggiori
informazioni, consulta
Configurare le impostazioni di pull dell'immagine kubelet.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.ports.controlPlaneLBPort
Numero. La porta di destinazione utilizzata per il traffico inviato al piano di controllo Kubernetes (i server API Kubernetes).
Risorsa cluster
Obbligatorio
Immutabile
loadBalancer.vips.controlPlaneVIP
obbligatorio. Specifica l'indirizzo IP virtuale (VIP) per la connessione al server API Kubernetes. Questo indirizzo non deve rientrare nell'intervallo degli 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 creato. 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 (Border Gateway Protocol) dalla tua rete locale (esterna al cluster). Puoi specificare i peer BGP quando configuri il bilanciamento del carico del piano di controllo come 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 che hai 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 alcun 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. Un singolo indirizzo IPv4 o un intervallo di indirizzi IPv4. Specifica gli indirizzi IP per le macchine nodo che vuoi attivare in modalità di manutenzione. Per maggiori informazioni, consulta
Attiva 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
l'accesso alla funzionalità SUDO senza password alle macchine nodose nel
cluster. La chiave SSH, sshPrivateKeyPath, deve funzionare per l'utente specificato. Le operazioni di creazione e aggiornamento del cluster verificano che sia possibile accedere alle macchine nodo con l'utente e la chiave SSH specificati.
Risorsa cluster
Facoltativo
Modificabile
osEnvironmentConfig.addPackageRepo
Facoltativo. Valore booleano (true | false). Specifica se utilizzare o meno il tuo server di repository dei pacchetti anziché il repository Docker apt predefinito. Per utilizzare il tuo
repository di pacchetti, imposta addPackageRepo su
false. Usa questa funzionalità per saltare l'aggiunta di repository di pacchetti a ogni macchina bare metal nel tuo 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, GKE su Bare Metal supporta containerd solo come runtime del container. Il campo containerRuntime è deprecato ed è stato rimosso dal file di configurazione del cluster generato. Per GKE su Bare Metal 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 maggiori informazioni sull'impostazione del numero massimo di pod per nodo, consulta Networking dei pod.
Risorsa cluster
Facoltativo
Immutabile
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. Valore booleano (0 o 1). Valore predefinito: 1.
Questo campo specifica se eseguire o meno l'upgrade di tutti i pool di nodi worker contemporaneamente per un cluster. Per impostazione predefinita (1), esegui l'upgrade in sequenza, uno dopo l'altro. Quando imposti concurrentNodePools su 0, ogni pool di nodi worker nel cluster viene eseguito in parallelo.
Facoltativo. Valore booleano (true o false). Valore predefinito:
false. Questo campo specifica se mettere in pausa o riprendere l'upgrade di un cluster attivo. Questa funzionalità è disponibile solo per i cluster con tutti i nodi del piano di controllo nella versione secondaria 1.28 o successiva.
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. Valore 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 i 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 GKE su Bare Metal 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 server proxy. Includi il numero di porta anche se è uguale alla porta predefinita dello schema.
Facoltativo. Valore 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 solo durante l'upgrade.
Per maggiori informazioni, consulta
Utilizzare seccomp per limitare i container.
Risorsa cluster
Facoltativo
Modificabile (solo upgrade)
clusterSecurity.enableRootlessContainers
Facoltativo. Valore booleano (true|false). Attiva o disattiva i container di sistema bare metal rootless. Quando questo campo è abilitato, i container di sistema Bare Metal vengono eseguiti come utente non root con un ID utente compreso nell'intervallo 2000-5000. Se questa opzione è disattivata, i container di sistema Bare Metal vengono eseguiti come utente root. Questa funzionalità è attiva per impostazione predefinita. È vivamente sconsigliato disattivare questa funzionalità, perché l'esecuzione dei container come utente root rappresenta un rischio per la sicurezza. Dopo la creazione del cluster, questo campo può essere attivato solo durante l'upgrade. Per maggiori informazioni, consulta Non eseguire i container come utente root.
Risorsa cluster
Facoltativo
Modificabile (solo upgrade)
clusterSecurity.authorization
Facoltativo. L'autorizzazione configura l'accesso utente 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 è stato concesso il ruolo clusterrole/cluster-admin per controllo dell'accesso basato su ruoli (RBAC) di Kubernetes. 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. Questo è pratico se hai più cluster da gestire, in particolare in un ambiente ibrido con cluster GKE e on-premise.
Questo campo accetta un array di nomi di account. Sono supportati account utente e
account di servizio. 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 che quelli nuovi), poiché 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 GKE su Bare Metal consentono di 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 garantisce che
gli spazi UID e GID utilizzati dai container di sistema non si sovrappongano
a quelli assegnati ai carichi di lavoro degli utenti. 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 per la configurazione dei montaggi dei nodi, consulta Configurare i montaggi dei nodi LVP.
Risorsa cluster
Obbligatorio
Immutabile
storage
Questa sezione contiene le impostazioni per l'archiviazione del cluster.
Risorsa cluster
Obbligatorio
Immutabile
storage.lvpNodeMounts
Questa sezione specifica la configurazione (percorso) per i volumi permanenti locali supportati da dischi montati. Devi formattare e montare personalmente questi dischi. 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
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. Per ogni sottodirectory viene creato un PersistentVolume (PV) locale. 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 l'oggetto StorageClass da utilizzare per creare volumi permanenti. 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 è costituito da un singolo cluster di amministrazione e uno o più cluster utente, gestiti dal cluster di amministrazione.
GKE su Bare Metal supporta i seguenti tipi di cluster:
Amministratore: cluster utilizzato per gestire i cluster utente.
Utente: cluster utilizzato per eseguire carichi di lavoro.
Ibrido: cluster singolo per amministrazione e carichi di lavoro, in grado di gestire anche i cluster utente.
Indipendente: cluster singolo che può amministrare autonomamente e 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 gli aggiornamenti o gli upgrade. Per saperne di più su come creare un cluster, consulta Creazione di 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 un pattern di
cluster-CLUSTER_NAME, ma il prefisso cluster- non è strettamente necessario dalla release 1.7.2 di GKE su Bare Metal.
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 dell'immagine che possono essere aggiunte alla coda di elaborazione per gestire i picchi nelle richieste. Non appena viene avviata la modalità pull, è possibile aggiungere una nuova richiesta alla coda. Il valore predefinito è 10. Questo campo corrisponde all'opzione della configurazione kubelet (v1beta1) di registryBurst.
Il valore per registryPullQPS ha la precedenza su questa
impostazione. Ad esempio, con le impostazioni predefinite, sono consentite fino a 10 query simultanee, ma devono essere elaborate alla
frequenza 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 maggiori
informazioni, consulta
Configurare le impostazioni di pull dell'immagine kubelet.
Risorsa Pool di nodi
Facoltativo
Modificabile
kubeletConfig.registryPullQPS
Facoltativo. Numero intero (non negativo). Specifica la velocità di elaborazione delle query per il pull delle immagini al secondo (QPS) delle immagini di Container Registry.
Se il valore di registryPullQPS è maggiore di 0, la frequenza di query è limitata al numero di query al secondo. Se
registryPullQPS è impostato su 0, non sono previste
limitazioni alla frequenza di query. Il valore predefinito è 5.
Questo campo corrisponde all'opzione della configurazione kubelet (v1beta1) di registryPullQPS.
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 maggiori
informazioni, consulta
Configurare le impostazioni di pull dell'immagine kubelet.
Risorsa Pool di nodi
Facoltativo
Modificabile
kubeletConfig.serializeImagePulls
Facoltativo. Valore booleano (true|false). Questo campo
specifica se i pull di Container Registry vengono elaborati in parallelo o
uno alla volta. Il valore predefinito è true, specificando che i pull vengono elaborati uno alla volta. Se impostato su false, kubelet esegue il pull delle immagini in parallelo. Questo campo corrisponde all'opzione della configurazione kubelet (v1beta1) di serializeImagePulls.
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 maggiori
informazioni, consulta
Configurare le impostazioni di pull dell'immagine kubelet.
Risorsa Pool di nodi
Facoltativo
Modificabile
taints
Facoltativo. Oggetto. Un'incompatibilità dei nodi consente di contrassegnare un nodo in modo che lo scheduler ne prevenga o 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 il modo in cui vengono gestiti i pod per il nodo. L'oggetto taints può avere più incompatibilità.
Il campo effect può assumere uno dei seguenti valori:
NoSchedule: nessun pod può 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 quelli che la tollerano non vengono mai rimossi.
Per GKE su Bare Metal, le incompatibilità vengono riconciliate con i nodi del pool di nodi, a meno che l'annotazione baremetal.cluster.gke.io/label-taint-no-sync non venga applicata al cluster. 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
l'annotazione baremetal.cluster.gke.io/label-taint-no-sync non venga applicata
al cluster. 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, viene eseguito l'upgrade di ciascun nodo del cluster in sequenza, uno dopo l'altro. Puoi configurare pool di nodi worker in modo che più nodi vengano aggiornati in parallelo quando esegui l'upgrade del cluster. L'upgrade dei nodi in parallelo velocizza
in modo significativo gli upgrade dei cluster, in particolare 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. Quando imposti concurrentNodes su un numero maggiore di 1, questo campo specifica il numero di nodi di cui eseguire l'upgrade in parallelo. Tieni presente i seguenti
vincoli per concurrentNodes:
Il valore non può superare il minore tra il 50% del numero di nodi nel pool di nodi o il numero fisso 15. Ad esempio, se il tuo pool di nodi ha 20 nodi, non puoi specificare un valore superiore a 10. Se il tuo pool di nodi ha 100 nodi, 15 è il valore massimo che puoi specificare.
Quando utilizzi questo campo insieme al campo minimumAvailableNodes, i 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 un determinato numero di nodi rimanga disponibile per l'esecuzione dei 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 devono rimanere disponibili durante il processo di upgrade. Un nodo è considerato non disponibile quando è in fase di upgrade attivo. Un nodo viene considerato non disponibile anche quando si verifica una delle seguenti condizioni:
Il nodo è in modalità di manutenzione
Il nodo è in fase di riconciliazione
Il nodo è bloccato durante un upgrade
Quando 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 di minimumAvailableNodes riduce al minimo i problemi di capacità per la pianificazione dei pod e, di conseguenza, aiuta a proteggere i carichi di lavoro durante un upgrade del cluster. Tuttavia, un valore elevato di minimumAvailableNodes aumenta il rischio che un upgrade si blocchi in attesa che i nodi diventino disponibili. Per maggiori informazioni, consulta
Upgrade paralleli.
Risorsa Pool di nodi
Facoltativo
Modificabile
registryMirrors
Facoltativo. Utilizza questa sezione per specificare un mirroring del registro da utilizzare per l'installazione dei cluster, anziché di Container Registry (gcr.io). Per maggiori informazioni sull'utilizzo di un mirroring del registro, consulta Installazione di GKE su Bare Metal mediante un mirroring del registro.
Stringa. L'endpoint del mirroring, composto dall'indirizzo IP e dal numero di porta del server del registro. 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 specifichi 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 registro di sistema utilizza un certificato TLS privato. Se il registro locale non richiede un certificato TLS privato, puoi omettere questo campo.
Mirroring 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'utilizzo dei mirror del registro. Se il server del registro 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 mirroring del registro specificato (endpoint). Quando il runtime del container rileva richieste di pull per le immagini da un host specificato, controlla prima il mirroring del registro locale. Per maggiori informazioni, consulta Creare cluster dal mirroring del registro.
Il file di configurazione del cluster generato da bmctl per GKE su Bare Metal include campi per specificare i percorsi dei file delle credenziali e delle chiavi nel file system locale. Queste credenziali e chiavi sono 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 account di servizio gestito da Google che agisce per conto di Container Registry durante l'interazione con i servizi Google Cloud.
Credenziali
Facoltativo
Modificabile
sshPrivateKeyPath
Stringa. Il percorso della chiave privata SSH. Per l'accesso ai nodi è necessario SSH.
Credenziali
Facoltativo
Modificabile
gkeConnectAgentServiceAccountKeyPath
Stringa. Il percorso della chiave dell'account di servizio dell'agente.
GKE su Bare Metal utilizza questo account di servizio per mantenere una connessione tra GKE su Bare Metal e Google Cloud.
Stringa. Il percorso della chiave dell'account di servizio di registrazione.
GKE su Bare Metal utilizza questo account di servizio per registrare i cluster utente in Google Cloud.
Stringa. Il percorso della chiave dell'account di servizio delle operazioni.
GKE su Bare Metal utilizza l'account di servizio Operations 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 della maschera per il blocco CIDR IPv4 del nodo. Ad
esempio, il valore 24 si traduce in netmask
/24. Assicurati che la netmask del blocco CIDR del nodo sia superiore alla quantità massima di pod che il kubelet può pianificare, definita 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 della maschera per il blocco CIDR IPv6 del nodo. Ad
esempio, il valore 120 si traduce in netmask
/120. Assicurati che la netmask del blocco CIDR del nodo sia superiore alla quantità massima di pod che il kubelet può pianificare, definita 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.
