Riferimento per il campo di configurazione del cluster
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive i campi supportati nel file di configurazione del cluster per il software Distributed Cloud solo per 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 template 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, come metadata.name, possano essere compilati automaticamente, questo file di configurazione in formato YAML è un modello per specificare le informazioni sul cluster.
Per creare un nuovo file di configurazione del cluster, utilizza il seguente comando nella cartella /baremetal:
bmctlcreateconfig-cCLUSTER_NAME
Sostituisci CLUSTER_NAME con il nome del cluster che vuoi creare. Per saperne di più su bmctl, consulta la sezione 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 è 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 ti consente di utilizzare il tuo provider di identità esistente per gestire l'autenticazione di utenti e gruppi nei tuoi cluster.
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 formato base64. Includi la stringa risultante in certificateAuthorityData come singola riga.
Ad esempio (esempio con ritorno a capo per adattarsi alla tabella):
Facoltativo. Stringa. L'ID dell'applicazione client che effettua le richieste di autenticazione al provider OpenID.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.clientSecret
Facoltativo. Stringa. Secret condiviso tra applicazione client OIDC e provider OIDC.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.deployCloudConsoleProxy
Facoltativo. Booleano (true|false). Specifica se nel cluster è stato eseguito il deployment di un reverse proxy 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 tramite internet pubblico, 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, dato un gruppo dev e un prefisso oidc:, oidc:dev.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.group
Facoltativo. Stringa.
JWT
utilizzato dal provider per restituire i tuoi gruppi di sicurezza.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.issuerURL
Facoltativo. Stringa URL. URL a cui vengono inviate le richieste di autorizzazione al tuo provider OpenID, ad esempio https://example.com/adfs. Il server API Kubernetes utilizza questo URL per rilevare 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 attivi OIDC, devi specificare un valore kubectlRedirectURL.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.proxy
Facoltativo. Stringa URL. Server proxy da utilizzare per il cluster per 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 dei nomi utente.
Risorsa cluster
Facoltativo
Immutabile
authentication.oidc.username
Facoltativo. Stringa.
Attestazione JWT da utilizzare 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.
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 della rete per il cluster.
Risorsa cluster
Obbligatorio
Modificabile
clusterNetwork.advancedNetworking
Valore booleano. Imposta questo campo su true per abilitare le funzionalità di networking avanzate, come il bilanciamento del carico in bundle con BGP o il gateway NAT in uscita. Entrambe le funzionalità utilizzano il gateway di rete per GDC.
Network Gateway for GDC è il componente chiave per abilitare le funzionalità di networking avanzate in Google Distributed Cloud e Google Kubernetes Engine (GKE). Uno dei principali vantaggi del gateway di rete per GDC è che può allocare dinamicamente indirizzi IP mobili da un insieme di indirizzi specificati in una risorsa personalizzata NetworkGatewayGroup.
Valore booleano. Imposta questo campo su false per disabilitare le funzionalità Ingress in bundle con il software 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 ottenere i vantaggi aggiuntivi di un mesh di servizi completamente funzionale, ti consigliamo di disabilitare l'Ingress in bundle. Questo campo è impostato su true per impostazione predefinita. Questo campo non è presente nel file di configurazione del cluster generato. Puoi disattivare Ingress in bundle solo per i cluster versione 1.13.0 e successive.
Valore booleano. Imposta questo campo su true per attivare 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 un Network Address Translation (NAT).
flatIPv4 è false per impostazione predefinita. Puoi attivare la modalità flat solo durante la creazione del cluster. Una volta attivata la modalità flat per il cluster, non puoi disattivarla.
Risorsa cluster
Facoltativo
Immutabile
clusterNetwork.forwardMode
Facoltativo. Stringa. Specifica la modalità di networking per il bilanciamento del carico di Dataplane V2. La Network Address Translation dell'origine (SNAT) è la modalità di networking predefinita. La modalità Direct Server Return (DSR) supera i problemi del 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 nel formato di blocco CIDR. I pod specificano gli intervalli IP da cui vengono allocate le reti dei pod.
Intervallo CIDR dei pod minimo: valore della maschera di /18, che corrisponde a una dimensione di 14 bit (16.384 indirizzi IP).
Intervallo CIDR dei pod massimo: 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 tuo cluster.
Per ulteriori informazioni sulla configurazione e sull'utilizzo del networking SR-IOV, consulta la documentazione Configura il networking SR-IOV.
Risorsa cluster
Facoltativo
Modificabile
clusterNetwork.services.cidrBlocks
Obbligatorio. Intervallo di indirizzi IPv4 nel formato di blocco CIDR. Specifica l'intervallo di indirizzi IP da cui vengono allocati gli indirizzi IP virtuali (VIP) del servizio. Gli intervalli non devono sovrapporsi alle subnet raggiungibili dalla tua rete. Per saperne di più sull'allocazione degli indirizzi per le reti internet private, consulta RFC 1918.
A partire dalla versione 1.15.0 del software Google Distributed Cloud per bare metal, questo campo è modificabile. Se necessario, puoi aumentare il numero di indirizzi IP allocati per i servizi dopo aver creato un cluster. Per saperne di più, consulta Aumenta l'intervallo della rete di 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 dei servizi: valore della maschera di /24, che corrisponde a una dimensione di 8 bit (256 indirizzi).
Intervallo CIDR massimo dei servizi: 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 viene più utilizzato e non ha alcun effetto. Il logging e il monitoraggio delle applicazioni sono abilitati nella risorsa personalizzata Google Cloud Observability. Per saperne di più sull'abilitazione del logging e del monitoraggio delle applicazioni, consulta Abilita il logging e il monitoraggio delle applicazioni.
Risorsa cluster
No-op
Modificabile
clusterOperations.disableCloudAuditLogging
Valore booleano. Cloud Audit Logs è utile per esaminare le richieste API sospette e per raccogliere statistiche. Cloud Audit Logs è abilitato (disableCloudAuditLogging: false) per impostazione predefinita. Imposta su true per disattivare Cloud Audit Logs.
Stringa. Una regione Google Cloud in cui vuoi instradare e archiviare le metriche di Monitoring. Ti consigliamo di scegliere una regione vicina al tuo data center on-premise. Durante la creazione del cluster, questo valore viene utilizzato per impostare il valore clusterLocation nella specifica della risorsa stackdriver.
Il valore specificato viene utilizzato anche da Google Cloud Observability per etichettare metriche e log. Queste etichette possono essere utilizzate per filtrare in Metrics Explorer ed Esplora log.
Stringa. L'ID progetto del progetto Google Cloud in cui vuoi visualizzare
log e metriche. Durante la creazione del cluster, questo valore viene utilizzato per impostare il valore projectID nella specifica della risorsa stackdriver.
Risorsa cluster
Obbligatorio
Immutabile
controlPlane
Questa sezione contiene informazioni sul control plane 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 per i quali vuoi che un certificato sia valido. In un cluster per bare metal, i SAN per il certificato del server API includono per impostazione predefinita gli indirizzi IP e VIP dei nodi del control plane e i nomi DNS di Kubernetes. Utilizza questo campo per aggiungere SAN aggiuntive al certificato del server API per il cluster. I nomi di dominio devono essere conformi allo standard RFC 1035.
Per saperne di più, vedi Aggiungi domini al certificato del server API.
Questo campo può essere aggiunto o modificato in qualsiasi momento.
Risorsa cluster
Facoltativo
Modificabile
controlPlane.loadBalancer
Questa sezione contiene le impostazioni per il bilanciamento del carico del control plane. I campi di questa sezione sono disponibili solo per i cluster della versione 1.32 e successive.
Facoltativo. Numero intero. Specifica il numero di messaggi ARP spontanei (GARP) che Keepalived deve inviare alla volta dopo che un nodo del control plane passa al ruolo di server master. Questo valore corrisponde all'impostazione vrrp_garp_master_repeat per Keepalived. Il valore predefinito è 5. Per ulteriori informazioni, consulta
Personalizzazione di Keepalived.
Risorsa cluster
Facoltativo
Modificabile
controlPlane.loadBalancer.mode
Facoltativo. Stringa. Se impostata su bundled, questa impostazione specifica che i bilanciatori del carico del control plane vengono eseguiti sui nodi del control plane. Se è impostato e configuri un pool di nodi del bilanciatore del carico con loadBalancer.nodePoolSpec, i bilanciatori del carico del control plane vengono eseguiti sui nodi del control plane e i bilanciatori del carico del data plane vengono eseguiti sul pool di nodi del bilanciatore del carico. Per saperne di più, consulta
Separazione
dei bilanciatori del carico.
Se imposti controlPlane.loadBalancer.mode su manual, anche loadBalancer.mode deve essere impostato su manual. Questa impostazione viene utilizzata per attivare il bilanciamento manuale del carico. Per saperne di più, consulta Configura il bilanciamento manuale del carico.
Non è necessario impostare controlPlane.loadBalancer.mode su manual per configurare il bilanciamento manuale del carico.
Valori consentiti: bundled | manual
Risorsa cluster
Facoltativo
Immutabile
controlPlane.nodePoolSpec
Questa sezione specifica gli indirizzi IP per il pool di nodi utilizzato dal control plane e dai relativi componenti. La specifica pool di nodi del control plane (come la specifica pool di nodi del bilanciatore del carico) è speciale. Questa specifica dichiara e controlla le risorse critiche del cluster. L'origine canonica di questa risorsa è questa sezione nel file di configurazione del cluster. Non modificare direttamente le risorse pool di nodi del control plane di primo livello. Modifica invece 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 affidabilità (HA).
Questo campo può essere modificato ogni volta che aggiorni o esegui l'upgrade di un cluster.
Risorsa cluster
Obbligatorio
Modificabile
controlPlane.nodePoolSpec.nodes.address
Obbligatorio. Stringa (indirizzo IPv4). Quando specifichi un pool di nodi, utilizzi il campo address per specificare l'indirizzo IPv4 predefinito per l'accesso SSH per ogni nodo. L'accesso SSH è necessario per le operazioni amministrative del cluster, come installazioni e upgrade. Per impostazione predefinita, questo indirizzo IP viene utilizzato anche per il traffico di dati e Kubernetes. Tuttavia, se specifichi l'indirizzo k8sIP per un determinato nodo, il traffico viene suddiviso tra i due indirizzi del nodo, con l'indirizzo k8sIP utilizzato esclusivamente per il traffico di dati e Kubernetes.
Questo campo può essere modificato ogni volta che aggiorni o esegui l'upgrade di un cluster.
Risorsa cluster
Obbligatorio
Modificabile
controlPlane.nodePoolSpec.nodes.k8sIP
Facoltativo. Stringa (indirizzo IPv4). Quando specifichi l'indirizzo k8sIP facoltativo per un nodo, questo viene dedicato alla gestione del traffico di dati e Kubernetes per il nodo, ad esempio richieste e risposte per l'API Kubernetes, kubelet e i workload. Quando specifichi k8sIP, l'indirizzo IP del nodo standard nodePoolSpec.nodes.address viene utilizzato esclusivamente per le connessioni SSH al nodo. Se non specifichi un indirizzo k8sIP, l'indirizzo IP del nodo standard gestisce tutto il traffico per il nodo.
Facoltativo. Numero intero (non negativo). Specifica la quantità massima di richieste di pull di immagini che possono essere aggiunte alla coda di elaborazione per gestire i picchi di richieste. Non appena inizia un'operazione di pull, è possibile aggiungere una nuova richiesta alla coda. Il valore predefinito è 10. Questo campo corrisponde all'opzione di configurazione kubelet (v1beta1) registryBurst.
Il valore di registryPullQPS ha la precedenza su questa impostazione. Ad esempio, con le impostazioni predefinite, sono consentiti burst fino a 10 query simultanee, ma devono essere elaborati 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 durante gli upgrade del cluster. Per saperne di più, consulta Configura le impostazioni di pull delle immagini kubelet.
Facoltativo. Numero intero (non negativo). Specifica la frequenza di elaborazione delle query per i pull di immagini di Artifact Registry in query al secondo (QPS).
Quando 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 esiste alcuna limitazione alla frequenza delle query. Il valore predefinito è 5.
Questo campo corrisponde all'opzione di configurazione kubelet (v1beta1) registryPullQPS.
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta durante gli upgrade del cluster. Per saperne di più, consulta Configura le impostazioni di pull delle immagini kubelet.
Facoltativo. Booleano (true|false). Questo campo specifica se i pull di Artifact Registry vengono elaborati in parallelo o uno alla volta. Il valore predefinito è true, che specifica 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 di configurazione kubelet (v1beta1) serializeImagePulls.
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta durante gli upgrade del cluster. Per saperne di più, consulta Configura le impostazioni di pull delle immagini kubelet.
Risorsa cluster
Facoltativo
Modificabile
controlPlane.schedulerConfiguration
Specifica argomenti e configurazioni aggiuntivi per kube-scheduler.
Questo campo consente di definire i vincoli di distribuzione della topologia dei pod predefiniti a livello di cluster.
Definisce i vincoli predefiniti applicati ai pod che non hanno vincoli di distribuzione della topologia definiti.
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 tuo cluster a Google Cloud. Questo è anche chiamato 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 (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 i servizi del parco risorse e di Connect, in modo che il traffico sia limitato alla tua 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 Fleet e Connect.
I nuovi cluster creati utilizzando 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 essere la stessa configurata in gkeOnPremAPI.location. Se le regioni non sono le stesse, la creazione del cluster non va a buon fine.
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 del 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 cluster nel progetto, disabilita gkeonprem.googleapis.com (il nome del servizio per l'API GKE On-Prem) nel progetto. Per istruzioni, vedi
Disabilitare
i servizi.
Se vuoi registrare tutti i cluster del progetto nell'API GKE On-Prem, assicurati di seguire i passaggi descritti in Prima di iniziare per attivare e utilizzare l'API GKE On-Prem nel progetto.
Se non vuoi registrare il cluster nell'API GKE On-Prem, includi questa sezione e imposta gkeOnPremAPI.enabled su false.
Se non vuoi registrare cluster nel progetto, disabilita gkeonprem.googleapis.com (il nome del servizio per l'API GKE On-Prem) nel progetto. Per istruzioni, vedi
Disabilitare
i servizi.
La registrazione del cluster di amministrazione o utente nell'API GKE On-Prem ti consente di utilizzare strumenti standard, ovvero 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 di 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 alla gestione delle API di gestire il ciclo di vita del cluster. Gli strumenti standard utilizzano l'API GKE On-Prem e, collettivamente, vengono definiti client API GKE On-Prem.
Se imposti gkeOnPremAPI.enabled su true, prima di creare o aggiornare il cluster utilizzando bmctl, assicurati di seguire 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 utilizzando uno strumento standard, il cluster viene registrato automaticamente 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 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 l'API GKE On-Prem viene eseguita 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)
Deprecato. A partire dalla versione 1.11.2, puoi abilitare o disabilitare il runtime VM su GDC aggiornando solo la risorsa personalizzata VMRuntime.
Valore booleano. Determina se l'emulazione software viene utilizzata o meno 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 se non hai la certezza, 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 solo per cambiare 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 componenti hardware di rete eliminano il traffico verso questi indirizzi speciali. Puoi omettere questo campo, il cui 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 se viene specificato esplicitamente da un servizio. Puoi omettere questo campo, il cui valore predefinito è false.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.mode
Obbligatorio. Stringa. Specifica la modalità di bilanciamento del carico. In modalità bundled, il software 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 saperne di più, 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 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 normali e bilanciatori del carico. Se non specifichi un pool di nodi, i nodi del control plane 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 workload su un nodo nel pool di nodi del bilanciatore del carico, aggiungi la seguente incompatibilità al nodo:
node-role.kubernetes.io/load-balancer:NoSchedule
Il software Google Distributed Cloud aggiunge tolleranze per questa incompatibilità ai pod necessari 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.
Per impostazione predefinita, tutti i nodi nel pool di nodi del bilanciatore del carico devono trovarsi nella stessa subnet di livello 2 dei VIP del bilanciatore del carico configurati nella sezione loadBalancer.addressPools del file di configurazione. Tuttavia, se specifichi un indirizzo IP Kubernetes k8sIP per un nodo, solo questo indirizzo deve trovarsi nella stessa subnet di livello 2 degli altri VIP del bilanciatore del carico.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.nodePoolSpec.nodes.address
Facoltativo. Stringa (indirizzo IPv4). Quando specifichi un pool di nodi, utilizzi il campo address per specificare l'indirizzo IPv4 predefinito per l'accesso SSH per ogni nodo. L'accesso SSH è necessario per le operazioni amministrative del cluster, come installazioni e upgrade. Per impostazione predefinita, questo indirizzo IP viene utilizzato anche per il traffico di dati e Kubernetes. Tuttavia, se specifichi l'indirizzo k8sIP per un determinato nodo, il traffico viene suddiviso tra i due indirizzi per il nodo, con l'indirizzo k8sIP utilizzato esclusivamente per il traffico di dati e Kubernetes.
Sebbene i nodi nel pool di nodi del bilanciatore del carico possano eseguire workload, sono separati dai nodi nei node pool dei worker. Non puoi includere un determinato nodo del cluster in più di un pool di nodi. Gli indirizzi IP dei nodi sovrapposti bloccano la creazione del cluster e altre operazioni del cluster.
Facoltativo. Stringa (indirizzo IPv4). Quando specifichi l'indirizzo k8sIP facoltativo per un nodo, questo viene dedicato alla gestione del traffico di dati e Kubernetes per il nodo, ad esempio richieste e risposte per l'API Kubernetes, kubelet e i workload. Quando specifichi k8sIP, l'indirizzo IP del nodo standard nodePoolSpec.nodes.address viene utilizzato esclusivamente per le connessioni SSH al nodo. Se non specifichi un indirizzo k8sIP, l'indirizzo IP del nodo standard gestisce tutto il traffico per il nodo.
Facoltativo. Numero intero (non negativo). Specifica il numero massimo di richieste di pull di immagini che possono essere aggiunte alla coda di elaborazione per gestire i picchi di richieste. Non appena inizia un'operazione di pull, è possibile aggiungere una nuova richiesta alla coda. Il valore predefinito è 10. Questo campo corrisponde all'opzione di configurazione kubelet (v1beta1) registryBurst.
Il valore di registryPullQPS ha la precedenza su questa impostazione. Ad esempio, con le impostazioni predefinite, sono consentiti burst fino a 10 query simultanee, ma devono essere elaborati 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 durante gli upgrade del cluster. Per saperne di più, consulta Configura le impostazioni di pull delle immagini kubelet.
Facoltativo. Numero intero (non negativo). Specifica la frequenza di elaborazione delle query per i pull di immagini di Artifact Registry in query al secondo (QPS).
Quando 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 esiste alcuna limitazione alla frequenza delle query. Il valore predefinito è 5.
Questo campo corrisponde all'opzione di configurazione kubelet (v1beta1) registryPullQPS.
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta durante gli upgrade del cluster. Per saperne di più, consulta Configura le impostazioni di pull delle immagini kubelet.
Facoltativo. Booleano (true|false). Questo campo specifica se i pull di Artifact Registry vengono elaborati in parallelo o uno alla volta. Il valore predefinito è true, che specifica 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 di configurazione kubelet (v1beta1) serializeImagePulls.
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta durante gli upgrade del cluster. Per saperne di più, consulta Configura le impostazioni di pull delle immagini kubelet.
Risorsa cluster
Facoltativo
Modificabile
loadBalancer.ports.controlPlaneLBPort
Numero. La porta di destinazione utilizzata per il traffico inviato al control plane Kubernetes (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 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 saperne di più, consulta Configura 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) della tua rete locale (esterna al cluster). Specifica i peer BGP quando configuri il bilanciamento del carico del control plane nell'ambito della soluzione di bilanciamento del carico in bundle che utilizza BGP. Ogni peer è 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 control plane. La configurazione del peering BGP per il bilanciamento del carico del control plane non può essere aggiornata dopo la creazione del cluster.
Facoltativo. Stringa. Il numero di sistema autonomo (ASN) della rete che contiene il dispositivo peer esterno. Specifica un ASN per ogni peer BGP che configuri per il bilanciamento del carico del control plane, quando configuri la soluzione di bilanciamento del carico integrata che utilizza BGP.
Per saperne di più, consulta Configura 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 control plane che si connettono al peer BGP esterno, quando configuri la soluzione di bilanciamento del carico integrato che utilizza BGP. Se non specifichi alcun nodo del control plane, tutti i nodi del control plane si connetteranno al peer esterno. Se specifichi uno o più indirizzi IP, solo i nodi specificati partecipano alle sessioni di peering.
Per saperne di più, consulta Configura 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 delle macchine nodo che vuoi mettere in modalità di manutenzione. Per saperne di più, consulta
Attiva la modalità di manutenzione per i nodi.
Ad esempio:
maintenanceBlocks:cidrBlocks:-192.168.1.200# Single machine-192.168.1.100-192.168.1.109# Ten machines
Facoltativo. Specifica la configurazione dell'adattatore per la scalabilità automatica orizzontale dei pod in base alle metriche personalizzate. Questa funzionalità è disponibile in anteprima per i cluster della versione 1.34.
Ad esempio:
apiVersion:baremetal.cluster.gke.io/v1kind:Clustermetadata:name:cluster1namespace:cluster-cluster1annotations:preview.baremetal.cluster.gke.io/metrics-adapter:"true"spec:# ... other existing cluster configurations ...metricsAdapter:prometheus:url:"http://prometheus-k8s.monitoring.svc.cluster.local:9090"orgID:"production-environment"auth:configSecretRef:name:prometheus-auth-secretkey:configrules:configMapKeyRefs:-name:my-app-ruleskey:config.yaml
Risorsa cluster
Facoltativo
Modificabile
metricsAdapter.prometheus
Facoltativo. Specifica le impostazioni per la connessione a un server Prometheus.
In questo modo, puoi utilizzare la tua istanza di Prometheus come provider di metriche personalizzate per la scalabilità automatica orizzontale dei pod. Quando specifichi il campo metricsAdapter.prometheus, devi specificare anche il campo metricsAdapter.rules.
Risorsa cluster
Facoltativo
Modificabile
metricsAdapter.prometheus.url
Obbligatorio quando si specificano le impostazioni di Prometheus. L'URL dell'endpoint Prometheus. In questo caso, quando utilizzi Prometheus come provider di metriche personalizzate per la scalabilità automatica orizzontale dei pod, utilizza il seguente nome di dominio completo (FQDN):
prometheus: il nome del servizio Kubernetes (il servizio dell'applicazione Prometheus stesso).
k8s: il nome dello spazio dei nomi Kubernetes in cui è in esecuzione il servizio.
svc: indica che si tratta di un tipo di risorsa Service all'interno del cluster.
cluster.local: il suffisso di dominio predefinito per la rete interna del cluster Kubernetes.
Risorsa cluster
Obbligatorio
Modificabile
metricsAdapter.prometheus.orgID
Facoltativo. Stringa. Specifica l'ID organizzazione da includere nell'intestazione "X-Scope-OrgID".
Risorsa cluster
Facoltativo
Modificabile
metricsAdapter.prometheus.auth
Facoltativo. Questa sezione contiene le impostazioni di autenticazione richieste dal motore per i suggerimenti per la connessione a Prometheus. La scalabilità automatica orizzontale dei pod supporta i meccanismi di autenticazione di base (nome utente e password) e di autenticazione con token di connessione. Devi archiviare tutte le credenziali in un secret utilizzando il formato kubeconfig. Se l'istanza Prometheus non richiede l'autenticazione, rimuovi questa sezione.
Risorsa cluster
Facoltativo
Modificabile
metricsAdapter.prometheus.auth.configSecretRef
Facoltativo. Specifica il secret e la chiave nel secret per l'autenticazione.
Obbligatorio quando si specifica l'autenticazione di base. Stringa. La chiave all'interno del campo data del secret da selezionare per recuperare le credenziali per l'autenticazione. Deve essere una chiave secret valida.
Facoltativo. Booleano (true|false). Il valore predefinito è false; l'autenticazione fallisce se il segreto o la chiave non sono definiti.
Risorsa cluster
Facoltativo
Modificabile
metricsAdapter.rules
Facoltativo. Specifica le regole di rilevamento delle metriche per l'adattatore. Se viene fornito metricsAdapter.prometheus, questo campo è obbligatorio.
Risorsa cluster
Facoltativo
Modificabile
metricsAdapter.rules.configMapKeyRefs
Obbligatorio quando si specifica il campo metricsAdapter. configMapKeyRefs contiene un elenco di riferimenti alle chiavi ConfigMap che contengono le configurazioni delle regole. Queste regole vengono unite in ordine dal controller.
Risorsa cluster
Facoltativo
Modificabile
metricsAdapter.rules.configMapKeyRefs.name
Obbligatorio. Stringa. Il nome del ConfigMap che contiene le regole.
Risorsa cluster
Obbligatorio
Modificabile
metricsAdapter.rules.configMapKeyRefs.key
Obbligatorio. Stringa. La chiave all'interno del campo data di ConfigMap da cui selezionare per recuperare le regole. Deve essere una chiave ConfigMap valida.
Risorsa cluster
Obbligatorio
Modificabile
nodeAccess.loginUser
Facoltativo. Stringa. Specifica il nome utente non root che vuoi utilizzare per l'accesso alle 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 sia possibile accedere alle macchine dei nodi 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 del Package Repository, anziché il repository Docker apt predefinito. Per utilizzare il tuo Package Repository, imposta addPackageRepo su false. Utilizza questa funzionalità per evitare di aggiungere repository di pacchetti a ogni macchina bare metal nel tuo deployment. Per saperne di più, consulta Utilizza un server Package Repository privato.
Risorsa cluster
Facoltativo
Immutabile
nodeConfig
Questa sezione contiene le impostazioni per la configurazione dei nodi del cluster.
Risorsa cluster
Facoltativo
Modificabile (solo upgrade)
nodeConfig.containerRuntime (deprecato)
Deprecato. A partire dalla versione 1.13.0, Google Distributed Cloud supporta
containerd solo come runtime del container. Il campo containerRuntime è stato ritirato ed è stato rimosso dal file di configurazione del cluster generato. Per le versioni software di Google Distributed Cloud 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 affidabilità (HA) e 64-250
per i cluster non HA. 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 ogni nodo in modo che ogni pod possa avere un indirizzo IP univoco. La dimensione del blocco CIDR corrisponde al numero massimo di pod per nodo.
Per ulteriori informazioni sull'impostazione del numero massimo di pod per nodo, consulta Networking di pod e servizi.
Risorsa cluster
Facoltativo
Immutabile
nodeConfig.privateRegistries
Questa sezione specifica una configurazione del registry privato a livello di nodo per i cluster utente. I registry privati a livello di nodo sono destinati all'utilizzo con i tuoi workload per darti un maggiore controllo sui pull delle immagini e sulla relativa sicurezza.
Per i cluster di amministrazione, il registry 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 registry privato. Se il registry locale non richiede un certificato TLS privato, puoi omettere questo blocco.
Se più mirror del registry fanno riferimento a secret dei certificati CA in spazi dei nomi diversi, inclusi i secret che condividono nomi identici, il sistema aggiunge un prefisso con lo spazio dei nomi di origine per rendere univoco il nome del secret del certificato CA negli spazi dei nomi del cluster. Se più registry privati fanno riferimento a secret dei certificati CA con lo stesso nome in spazi dei nomi diversi (ad eccezione dello spazio dei nomi "anthos-creds" o del cluster), il sistema aggiunge un prefisso al nome del secret di destinazione per assicurarsi che i nomi dei secret dei certificati CA siano univoci negli spazi dei nomi. Il sistema non aggiungerà un prefisso ai secret nello spazio dei nomi del cluster o nello spazio dei nomi di origine in "anthos-creds".
L'elenco seguente mostra la fase di lancio per versione per la configurazione di un registry privato a livello di nodo:
Stringa. Questo campo specifica l'host e la porta per un singolo registry 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 registry privato per un cluster utente.
L'elenco seguente mostra la fase di lancio per versione per la configurazione di un registry privato a livello di nodo:
Se applicabile, utilizza questa sezione per specificare il nome e lo spazio dei nomi del secret creato per archiviare le credenziali del registry privato.
Utilizza il blocco pullCredentialSecretRef quando configuri un cluster utente per consentire ai nodi di accedere a un registry privato che richiede l'autenticazione.
L'elenco seguente mostra la fase di lancio per versione per la configurazione di un registry privato a livello di nodo:
Facoltativo. Questa sezione contiene le impostazioni per configurare la strategia di upgrade per i pool di nodi worker nel cluster. Per saperne di più, 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 contemporaneo di tutti i pool di nodi worker per un cluster. Per impostazione predefinita (1), l'upgrade viene eseguito in sequenza, uno dopo l'altro. Quando imposti concurrentNodePools su 0, l'upgrade di ogni pool di nodi worker nel cluster viene eseguito in parallelo.
L'upgrade dei nodi in ogni pool di nodi worker viene eseguito in base alla strategia di upgrade nella specifica NodePool corrispondente.
Risorsa cluster
Facoltativo
Modificabile
nodePoolUpgradeStrategy.pause
Facoltativo. Valore booleano (true o false). Valore predefinito:
false. Questo campo specifica se mettere in pausa o riprendere un upgrade del 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 saperne di più, consulta Controlli di integrità periodici.
Risorsa cluster
Facoltativo
Modificabile
periodicHealthCheck.enable
Facoltativo. Booleano (true|false). Attiva o disattiva i controlli di integrità periodici per il tuo cluster. I controlli di integrità periodici sono abilitati per impostazione predefinita su tutti i cluster. Puoi disattivare i controlli di integrità periodici per un cluster impostando il campo periodicHealthCheck.enable su false.
Per saperne di più, consulta Disattiva i controlli di integrità periodici
Risorsa cluster
Facoltativo
Modificabile
profile
Facoltativo. Stringa. Quando 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 edge ha requisiti di risorse di sistema ridotti ed è consigliato per i dispositivi edge con vincoli di 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 si trova dietro 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 il cluster 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 è lo stesso della porta predefinita dello schema.
Facoltativo. Booleano (true|false). Attiva o disattiva seccomp a livello di cluster. Quando questo campo è disattivato, i container senza un profilo seccomp nel file di configurazione del cluster vengono eseguiti senza limitazioni. Quando questo campo è abilitato, gli stessi container vengono protetti utilizzando il profilo seccomp predefinito del runtime del container. Questa funzione è attivata per impostazione predefinita.
Dopo la creazione del cluster, questo campo può essere attivato/disattivato solo durante l'upgrade.
Per saperne di più, consulta
Utilizza seccomp per limitare i container.
Risorsa cluster
Facoltativo
Modificabile (solo upgrade)
clusterSecurity.enableRootlessContainers
Facoltativo. Booleano (true|false). Attiva o disattiva i container di sistema bare metal senza root. 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 l'opzione è disattivata, i container di sistema Bare Metal vengono eseguiti come utente root. Per impostazione predefinita, questa funzionalità è abilitata. La disattivazione di questa funzionalità è sconsigliata, perché l'esecuzione di container come utente root comporta un rischio per la sicurezza. Dopo la creazione del cluster, questo campo può essere attivato/disattivato solo durante l'upgrade. Per saperne di più, consulta Non eseguire i 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 del 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 ogni risorsa del cluster in tutti gli spazi dei nomi. Questo campo configura anche le policy RBAC che consentono agli account specificati di utilizzare il gateway di connessione per eseguire i comandi kubectl sul cluster. Questo è utile 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 gli account utente e i service account. Per gli utenti, specifica gli indirizzi email dei loro account Google Cloud . Per i service account, 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 i dati specificati nell'aggiornamento.
Questo campo si applica solo ai cluster che possono eseguire workload. 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 nel software 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 nell'intervallo da startUIDRangeRootlessContainers a startUIDRangeRootlessContainers + 2999, che fornisce un intervallo da 2000 a 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 workload 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 sulla configurazione dei punti di montaggio dei nodi, consulta Configura i punti di montaggio 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 da 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 gli oggetti PersistentVolume locali supportati da sottodirectory in un file system condiviso. Queste sottodirectory vengono generate automaticamente durante la creazione del cluster.
Per saperne di più, consulta la sezione Quota 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 sulla configurazione della condivisione LVP, consulta Configurazione di 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 sulla configurazione della condivisione LVP, consulta Configurazione di una condivisione LVP.
Risorsa cluster
Obbligatorio
Immutabile
storage.lvpShare.storageClassName
Obbligatorio. Stringa. Specifica la classe di archiviazione da utilizzare per creare volumi permanenti. La classe StorageClass viene creata durante la creazione del cluster. Il valore predefinito è local-shared. Per istruzioni su come configurare la condivisione LVP, consulta Configurazione di 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 da uno o più cluster utente, gestiti dal cluster di amministrazione.
Il software Google Distributed Cloud supporta i seguenti tipi di cluster:
Amministratore: cluster utilizzato per gestire i cluster utente.
Utente: cluster utilizzato per eseguire i workload.
Ibrido: un singolo cluster sia per l'amministrazione che per i workload, che può anche gestire i cluster utente.
Autonomo: un singolo cluster che può amministrarsi autonomamente e che può anche eseguire workload, 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.
Facoltativo. Utilizza questa sezione per specificare la modalità di funzionamento della scalabilità automatica verticale dei pod. Questa funzionalità è disponibile in Anteprima per i cluster della versione 1.33 e successive.
Ad esempio:
apiVersion:baremetal.cluster.gke.io/v1kind:Clustermetadata:name:cluster1namespace:cluster-cluster1annotations:preview.baremetal.cluster.gke.io/vertical-pod-autoscaler:enablespec:# ... other cluster spec fieldsverticalPodAutoscaling:# Set to true for automated updatesenableUpdater:true# Set to true to reduce recommender memory usageenableMemorySaver:true
Puoi aggiornare il cluster in qualsiasi momento per attivare, disattivare o configurare la scalabilità automatica verticale dei pod. Per ulteriori informazioni sull'attivazione e sull'utilizzo della scalabilità automatica verticale dei pod, consulta Configura la scalabilità automatica verticale dei pod.
Facoltativo. Booleano (true|false). Attiva o disattiva la modalità di risparmio memoria per la scalabilità automatica verticale dei pod. La modalità Risparmio memoria riduce il footprint della memoria del componente del suggeritore di scalabilità automatica verticale dei pod. Quando impostienableMemorySaver Atrue, il sistema di raccomandazione traccia e calcola solo le aggregazioni per i pod che hanno una corrispondenzaVerticalPodAutoscaler risorsa personalizzata. La modalità Risparmio memoria è disattivata (false) per impostazione predefinita.
La scalabilità automatica verticale dei pod è disponibile in Anteprima per i cluster della versione 1.33 e successive. Puoi aggiornare il cluster in qualsiasi momento per attivare o disattivare la modalità Risparmio memoria. Per saperne di più, consulta Informazioni sulle modalità di scalabilità automatica verticale dei pod.
Facoltativo. Booleano (true|false). Specifica la modalità di applicazione dei suggerimenti per le risorse dei pod:
In modalità di suggerimento (enableUpdater: false),
la scalabilità automatica verticale dei pod analizza l'utilizzo delle risorse e pubblica
i valori consigliati per le richieste e i limiti di CPU e memoria nella
sezione dello stato delle risorse personalizzate VerticalPodAutoscaler
che crei. In modalità di suggerimento, per implementare le impostazioni delle risorse suggerite, devi modificare le risorse manualmente.
In modalità di aggiornamento automatico (enableUpdater: true), la scalabilità automatica verticale dei pod analizza l'utilizzo delle risorse e pubblica i valori consigliati per le richieste e i limiti di CPU e memoria nella sezione dello stato delle risorse personalizzate VerticalPodAutoscaler che crei. In seguito, la scalabilità automatica verticale dei pod applica automaticamente i suggerimenti.
Per impostazione predefinita, il gestore della scalabilità automatica verticale dei pod viene eseguito in modalità di suggerimento (enableUpdater: false).
La scalabilità automatica verticale dei pod è disponibile in Anteprima per i cluster della versione 1.33 e successive. Puoi aggiornare il cluster in qualsiasi momento per specificare la modalità di applicazione dei suggerimenti per le risorse dei pod. Per saperne di più, consulta Informazioni sulle modalità di scalabilità automatica verticale dei pod.
Facoltativo. Specifica le impostazioni per la connessione a un server Prometheus.
Questo campo di configurazione del cluster consente l'utilizzo della tua istanza Prometheus come provider di cronologia permanente per la scalabilità automatica verticale dei pod. Questa funzionalità è disponibile in anteprima per i cluster della versione 1.34. Se abilitato, il componente del motore per suggerimenti può eseguire query sul server Prometheus all'avvio o al riavvio per recuperare i dati sull'utilizzo delle risorse storiche a lungo termine (metriche di utilizzo della CPU e memoria utilizzata) per tutti i pod gestiti.
L'esempio seguente mostra una configurazione di Prometheus che utilizza l'autenticazione di base:
apiVersion:baremetal.cluster.gke.io/v1kind:Clustermetadata:name:cluster1namespace:cluster-cluster1annotations:preview.baremetal.cluster.gke.io/vertical-pod-autoscaler:enablespec:# ... other cluster spec fieldsverticalPodAutoscaling:...# other vertical Pod autoscaling fieldsprometheus:url:"http://prometheus.prometheus.svc.cluster.local:9090"auth:basicAuth:usernameRef:name:prom-basic-credskey:usernamepasswordRef:name:prom-basic-credskey:password
Obbligatorio quando si specificano le impostazioni di Prometheus. L'URL dell'endpoint Prometheus. Quando utilizzi Prometheus come provider di cronologia permanente per la scalabilità automatica verticale dei pod, utilizza il seguente nome di dominio completo (FQDN):
prometheus: il nome del servizio Kubernetes (il servizio dell'applicazione Prometheus stesso).
prometheus: il nome dello spazio dei nomi Kubernetes in cui è in esecuzione il servizio.
svc: indica che si tratta di un tipo di risorsa Service all'interno del cluster.
cluster.local: il suffisso di dominio predefinito per la rete interna del cluster Kubernetes.
Risorsa cluster
Obbligatorio
Modificabile
verticalPodAutoscaling.prometheus.auth
Facoltativo. Questa sezione contiene le impostazioni di autenticazione richieste dal motore per i suggerimenti per la connessione a Prometheus. La scalabilità automatica verticale dei pod supporta i meccanismi di autenticazione di base (nome utente e password) e di autenticazione con token di connessione. Se l'istanza Prometheus non richiede l'autenticazione, rimuovi questa sezione.
Se l'istanza Prometheus utilizza un metodo di autenticazione diverso,
ad esempio Transport Layer Security (TLS), non è supportata per l'utilizzo
con la funzionalità di scalabilità automatica verticale dei pod. Per ulteriori requisiti, consulta Utilizza Prometheus come provider di cronologia persistente.
Risorsa cluster
Facoltativo
Modificabile
verticalPodAutoscaling.prometheus.auth.basicAuth
Facoltativo. Specifica il nome utente e la password per l'autenticazione di base.
Obbligatorio quando si specifica l'autenticazione di base. Stringa. La chiave all'interno del campo data del secret da cui selezionare per recuperare il nome utente. Deve essere una chiave secret valida.
Obbligatorio quando si specifica l'autenticazione di base. Stringa. Il nome del secret che contiene la password. Il secret a cui viene fatto riferimento deve contenere sia la password sia il nome utente.
Obbligatorio quando si specifica l'autenticazione di base. Stringa. La chiave all'interno del campo data del secret da selezionare per recuperare la password. Deve essere una chiave secret valida.
Obbligatorio quando si specifica l'autenticazione con token di connessione. Stringa. La chiave all'interno del campo data del secret da selezionare per recuperare il token. Deve essere una chiave secret valida.
Facoltativo. Booleano (true|false). Il valore predefinito è false; l'autenticazione fallisce se il segreto o la chiave non sono definiti.
Risorsa cluster
Facoltativo
Modificabile
name
Obbligatorio. Stringa. In genere, il nome dello spazio dei nomi utilizza un pattern di cluster-CLUSTER_NAME, ma il prefisso cluster- non è strettamente obbligatorio dalla release 1.7.2 del software 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 pool di nodi nello stesso spazio dei nomi del cluster associato e fai riferimento al nome del cluster in questo campo. Per saperne di più, consulta Aggiungi e rimuovi pool di nodi in un cluster.
Facoltativo. Numero intero (non negativo). Specifica la quantità massima di richieste di pull di immagini che possono essere aggiunte alla coda di elaborazione per gestire i picchi di richieste. Non appena inizia un'operazione di pull, è possibile aggiungere una nuova richiesta alla coda. Il valore predefinito è 10. Questo campo corrisponde all'opzione di configurazione kubelet (v1beta1) registryBurst.
Il valore di registryPullQPS ha la precedenza su questa impostazione. Ad esempio, con le impostazioni predefinite, sono consentiti burst fino a 10 query simultanee, ma devono essere elaborati 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 durante gli upgrade del cluster. Per saperne di più, consulta Configura le impostazioni di pull delle immagini kubelet.
Risorsa NodePool
Facoltativo
Modificabile
kubeletConfig.registryPullQPS
Facoltativo. Numero intero (non negativo). Specifica la frequenza di elaborazione delle query per i pull di immagini di Artifact Registry in query al secondo (QPS).
Quando 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 esiste alcuna limitazione alla frequenza delle query. Il valore predefinito è 5.
Questo campo corrisponde all'opzione di configurazione kubelet (v1beta1) registryPullQPS.
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta durante gli upgrade del cluster. Per saperne di più, consulta Configura le impostazioni di pull delle immagini kubelet.
Risorsa NodePool
Facoltativo
Modificabile
kubeletConfig.serializeImagePulls
Facoltativo. Booleano (true|false). Questo campo specifica se i pull di Artifact Registry vengono elaborati in parallelo o uno alla volta. Il valore predefinito è true, che specifica 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 di configurazione kubelet (v1beta1) serializeImagePulls.
Questo campo può essere impostato ogni volta che crei, aggiorni o esegui l'upgrade di un cluster e l'impostazione viene mantenuta durante gli upgrade del cluster. Per saperne di più, consulta Configura le impostazioni di pull delle immagini kubelet.
Risorsa NodePool
Facoltativo
Modificabile
taints
Facoltativo. Oggetti Un'incompatibilità dei nodi ti consente di contrassegnare un nodo in modo che lo scheduler ne eviti o impedisca l'utilizzo per determinati pod. Un taint è costituito da una coppia chiave-valore e da un effetto associato. I valori key e value sono stringhe che utilizzi per identificare la contaminazione, mentre il valore effect specifica come vengono gestiti i pod per il nodo. L'oggetto taints può avere più taint.
Il campo effect può assumere uno dei seguenti valori:
NoSchedule: nessun pod può essere pianificato 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 la taint vengono rimossi immediatamente, mentre i pod che la tollerano non vengono mai rimossi.
Per il software Google Distributed Cloud, i taint vengono riconciliati 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 ulteriori informazioni sulle incompatibilità, consulta Incompatibilità e tolleranze.
Ad esempio:
taints:-key:statusvalue:testpooleffect:NoSchedule
Risorsa NodePool
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 saperne di più sulle etichette, consulta Etichette e selettori.
Risorsa NodePool
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 saperne di più, consulta Upgrade paralleli.
Nota: non aggiungere questa sezione per i pool di nodi del control plane o del bilanciatore del carico.
Risorsa NodePool
Facoltativo
Modificabile
upgradeStrategy.parallelUpgrade
Facoltativo. Questa sezione contiene le impostazioni per la configurazione degli upgrade dei nodi in parallelo per un pool di nodi worker. In un tipico upgrade predefinito del cluster, ogni nodo del cluster viene aggiornato in sequenza, uno dopo l'altro. Puoi configurare i pool di nodi worker in modo che più nodi eseguano l'upgrade in parallelo quando esegui l'upgrade del cluster. L'upgrade dei nodi in parallelo accelera notevolmente 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 puoi impostare una soglia minima per il numero di nodi in grado di eseguire i workload durante il processo di upgrade.
Facoltativo. Numero intero (positivo). Valore predefinito: 1. Max: 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 50% del numero di nodi nel pool di nodi o il numero fisso 15, a seconda di quale sia il valore più basso. 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 tuo 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 workload sono sensibili alle interruzioni, ti consigliamo di specificare minimumAvailableNodes per garantire che un determinato numero di nodi rimanga disponibile per l'esecuzione dei workload durante il processo di upgrade. Per saperne di più, 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 l'upgrade parallelo. minimumAvailableNodes consente di specificare il numero 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 è 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 valori combinati non possono superare il numero totale di nodi nel pool di nodi. Ad esempio, se il tuo 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 workload durante l'upgrade di un cluster. Tuttavia, un valore elevato per minimumAvailableNodes aumenta il rischio che un upgrade si blocchi in attesa che i nodi diventino disponibili. Per saperne di più, consulta Upgrade paralleli.
Risorsa NodePool
Facoltativo
Modificabile
privateRegistries
Facoltativo. Utilizza questa sezione per specificare un registry privato da utilizzare per le immagini dei workload. Questo metodo di configurazione del registry privato nella sezione delle credenziali del file di configurazione del cluster è per i cluster ibridi o autonomi che hanno solo pool di nodi worker.
Stringa. Questo campo specifica l'host e la porta per un singolo registry 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 registry privato per un cluster ibrido o autonomo.
Ad esempio:
-host:10.200.0.2:5007
Credenziali
Facoltativo
Modificabile
privateRegistries.caCertPath
Facoltativo. Stringa. Percorso del file del certificato CA (CA radice del server) se il server del registry utilizza un certificato TLS privato. Se il registry locale non richiede un certificato TLS privato, puoi omettere questo campo.
Credenziali
Facoltativo
Modificabile
privateRegistries.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 di registry privati a livello di nodo.
Utilizza il campo pullCredentialConfigPath quando configuri un cluster ibrido o autonomo per consentire ai nodi di accedere a un registry privato che richiede l'autenticazione.
Credenziali
Facoltativo
Modificabile
registryMirrors
Facoltativo. Utilizza questa sezione per specificare un mirror del registry da utilizzare per l'installazione dei cluster, anziché Artifact Registry (gcr.io). Per ulteriori informazioni sull'utilizzo di un mirror del registry, consulta Utilizza un mirror del registry per le immagini container.
Stringa. L'endpoint del mirror, composto dall'indirizzo IP e dal numero di porta del server del registry. 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 registry. Puoi specificare più mirror ed 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 registry locale non richiede un certificato TLS privato, puoi omettere questo campo.
Mirroring del registry
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 registry. Se il server del registry non richiede un file di configurazione Docker per l'autenticazione, il valore predefinito è false.
Facoltativo. Un array di nomi di dominio per gli host di cui viene eseguito il mirroring locale per il mirror del registry specificato (endpoint). Quando il runtime del container rileva richieste di pull per le immagini da un host specificato, controlla prima il mirror del registry locale. Per ulteriori informazioni, consulta Crea cluster dal mirror del registry.
Il file di configurazione del cluster generato da bmctl include campi per specificare i percorsi dei file di credenziali e chiavi nel file system locale. Queste credenziali e chiavi sono necessarie per connettere i cluster tra loro e al tuo progetto Google Cloud .
Stringa. Il percorso di una chiave del account di servizio con le autorizzazioni IAM necessarie per accedere alle risorse Artifact Registry.
Credenziali
Facoltativo
Modificabile
sshPrivateKeyPath
Stringa. Il percorso della chiave privata SSH. SSH è obbligatorio per l'accesso ai nodi.
Credenziali
Facoltativo
Modificabile
gkeConnectAgentServiceAccountKeyPath
Stringa. Il percorso della chiave del account di servizio dell'agente.
Google Distributed Cloud utilizza questo account di servizio per mantenere una connessione tra i cluster on-premise e Google Cloud.
Stringa. Il percorso della chiave del account di servizio di registrazione.
Google Distributed Cloud utilizza questo account di servizio per registrare i cluster utente con Google Cloud.
Stringa. Il percorso della chiave del account di servizio delle operazioni.
Google Distributed Cloud utilizza il account di servizio operativo per autenticarsi con Google Cloud Observability per l'accesso all'API Logging e all'API Monitoring. Ad eccezione dei cluster utente, è richiesta la chiave del account di servizio operativo. I cluster utente utilizzano le credenziali specificate per il cluster di gestione (amministratore o ibrido).
Non puoi disattivare Cloud Logging e Cloud Monitoring per i tuoi cluster.
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 di 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 la dimensione della maschera per il blocco CIDR IPv4 del nodo. Ad esempio, il valore 24 si traduce nella netmask /24. Assicurati che la netmask del blocco CIDR del nodo sia più grande
del numero massimo di pod che 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 di ogni famiglia.
Ad esempio:
ipv6:cidr:"2620:0:1000:2631:3:10:3:0/112"
Risorsa ClusterCIDRConfig
Obbligatorio
Immutabile
ipv6.perNodeMaskSize
Numero intero. Definisce la dimensione della maschera per il blocco CIDR IPv6 del nodo. Ad esempio, il valore 120 si traduce nella netmask /120. Assicurati che la netmask del blocco CIDR del nodo sia più grande
del numero massimo di pod che 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 funge da impostazione predefinita che si applica a tutti i nodi.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2026-10-27 UTC."],[],[]]
