- Risorsa: Cluster
- Fleet
- ClusterNetworking
- Autorizzazione
- ClusterUser
- MaintenancePolicy
- MaintenanceWindow
- RecurringTimeWindow
- TimeWindow
- MaintenanceExclusionWindow
- ControlPlane
- Remoto
- Locale
- SharedDeploymentPolicy
- SystemAddonsConfig
- Ingress
- VMServiceConfig
- ControlPlaneEncryption
- Stato
- MaintenanceEvent
- Tipo
- Programmazione
- Stato
- ReleaseChannel
- SurvivabilityConfig
- ConnectionState
- Stato
- ExternalLoadBalancerPool
- ZoneStorageEncryption
- ContainerRuntimeConfig
- DefaultContainerRuntime
- GoogleGroupAuthenticationConfig
- Metodi
Risorsa: Cluster
Un cluster Kubernetes Google Distributed Cloud Edge.
| Rappresentazione JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "fleet": { object ( |
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa del cluster. |
createTime |
Solo output. La data e l'ora in cui è stato creato il cluster. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
updateTime |
Solo output. La data e l'ora dell'ultimo aggiornamento del cluster. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
labels |
Etichette associate a questa risorsa. Un oggetto contenente un elenco di coppie |
fleet |
Obbligatorio. Configurazione del parco risorse. |
networking |
Obbligatorio. Configurazione di rete a livello di cluster. |
authorization |
Obbligatorio. Immutabile. Policy RBAC che verrà applicata e gestita da GEC. |
defaultMaxPodsPerNode |
Facoltativo. Il numero massimo predefinito di pod per nodo utilizzato se non è stato specificato esplicitamente un valore massimo per un pool di nodi in questo cluster. Se non specificato, verrà utilizzato il valore predefinito di Kubernetes. |
endpoint |
Solo output. L'indirizzo IP del server API Kubernetes. |
port |
Solo output. Il numero di porta del server API Kubernetes. |
clusterCaCertificate |
Solo output. Il certificato pubblico con codifica PEM della CA del cluster. |
maintenancePolicy |
Facoltativo. Configurazione della policy di manutenzione a livello di cluster. |
controlPlaneVersion |
Solo output. La versione di release del control plane |
nodeVersion |
Solo output. La versione di release più bassa tra tutti i nodi worker. Questo campo può essere vuoto se il cluster non ha nodi worker. |
controlPlane |
Facoltativo. La configurazione del control plane del cluster. |
systemAddonsConfig |
Facoltativo. La configurazione dei componenti aggiuntivi di sistema. |
externalLoadBalancerIpv4AddressPools[] |
Facoltativo. Pool di indirizzi IPv4 per il bilanciamento del carico esterno del piano dati del cluster. |
controlPlaneEncryption |
Facoltativo. Opzioni di crittografia del disco del control plane remoto. Questo campo viene utilizzato solo quando si attiva il supporto CMEK. |
status |
Solo output. Lo stato attuale del cluster. |
maintenanceEvents[] |
Solo output. Tutti gli eventi di manutenzione pianificati per il cluster, inclusi quelli in corso, pianificati per il futuro e completati in passato (fino a 90 giorni). |
targetVersion |
Facoltativo. La versione del cluster di destinazione. Ad esempio: "1.5.0". |
releaseChannel |
Facoltativo. Il canale di rilascio a cui è iscritto un cluster. |
survivabilityConfig |
Facoltativo. Configurazione della sopravvivenza del cluster, ad esempio nel caso in cui venga persa la connessione di rete. Nota: questo vale solo per i cluster del control plane locale. |
externalLoadBalancerIpv6AddressPools[] |
Facoltativo. Pool di indirizzi IPv6 per il bilanciamento del carico esterno del piano dati del cluster. |
connectionState |
Solo output. Lo stato di connessione attuale del cluster. |
externalLoadBalancerAddressPools[] |
Facoltativo. Pool di bilanciatori del carico esterni per il cluster. |
zoneStorageEncryption |
Facoltativo. La configurazione della crittografia dello spazio di archiviazione della zona |
containerRuntimeConfig |
Facoltativo. La configurazione del runtime del container del cluster. |
enableRemoteBackup |
Facoltativo. Se impostato su true, la funzionalità di backup/ripristino remoto verrà abilitata per questo cluster. |
enableClusterIsolation |
Facoltativo. Indica se il cluster deve essere isolato. go/cluster-isolation-in-gdcc-cluster |
googleGroupAuthentication |
Facoltativo. La configurazione dell'autenticazione del gruppo Google del cluster. |
Parco risorse
Configurazione relativa al parco risorse.
I parchi risorse sono un concetto di Google Cloud per l'organizzazione logica dei cluster; ti consentono di utilizzare e gestire le funzionalità multi-cluster e di applicare policy coerenti in tutti i tuoi sistemi.
| Rappresentazione JSON |
|---|
{ "project": string, "membership": string } |
| Campi | |
|---|---|
project |
Obbligatorio. Il nome del progetto host del parco risorse in cui verrà registrato questo cluster. I nomi dei progetti sono formattati come |
membership |
Solo output. Il nome della risorsa di iscrizione all'hub gestito associata a questo cluster. I nomi delle iscrizioni sono formattati come |
ClusterNetworking
Configurazione di rete a livello di cluster.
| Rappresentazione JSON |
|---|
{ "clusterIpv4CidrBlocks": [ string ], "servicesIpv4CidrBlocks": [ string ] } |
| Campi | |
|---|---|
clusterIpv4CidrBlocks[] |
Obbligatorio. A tutti i pod del cluster viene assegnato un indirizzo IPv4 RFC1918 in questi blocchi. È supportato un solo blocco. Questo campo non può essere modificato dopo la creazione. |
servicesIpv4CidrBlocks[] |
Obbligatorio. A tutti i servizi del cluster viene assegnato un indirizzo IPv4 RFC1918 in questi blocchi. È supportato un solo blocco. Questo campo non può essere modificato dopo la creazione. |
Autorizzazione
Policy RBAC che verrà applicata e gestita da GEC.
| Rappresentazione JSON |
|---|
{
"adminUsers": {
object ( |
| Campi | |
|---|---|
adminUsers |
Obbligatorio. Utente a cui verrà concesso il ruolo cluster-admin, che permette di avere l'accesso completo al cluster. Al momento, questo è un campo singolo, ma in futuro verrà ampliato per consentire più amministratori. |
ClusterUser
Un'entità utente per una policy RBAC.
| Rappresentazione JSON |
|---|
{ "username": string } |
| Campi | |
|---|---|
username |
Obbligatorio. Un nome utente Google attivo. |
MaintenancePolicy
Configurazione della policy di manutenzione.
| Rappresentazione JSON |
|---|
{ "window": { object ( |
| Campi | |
|---|---|
window |
Specifica il periodo di manutenzione in cui può essere eseguita la manutenzione. |
maintenanceExclusions[] |
Facoltativo. Esclusioni dalla manutenzione automatica. La manutenzione non di emergenza non deve essere eseguita in questi periodi. Ogni esclusione ha un nome univoco e può essere attiva o scaduta. Il numero massimo di esclusioni dalla manutenzione consentite in un determinato momento è 3. |
MaintenanceWindow
Configurazione del periodo di manutenzione
| Rappresentazione JSON |
|---|
{
"recurringWindow": {
object ( |
| Campi | |
|---|---|
recurringWindow |
Configurazione di un periodo di manutenzione ricorrente. |
RecurringTimeWindow
Rappresenta un periodo di tempo arbitrario che si ripete.
| Rappresentazione JSON |
|---|
{
"window": {
object ( |
| Campi | |
|---|---|
window |
La finestra della prima ricorrenza. |
recurrence |
Un RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) per la ricorrenza di questa finestra. Continuano per l'intervallo di tempo compreso tra l'ora di inizio e l'ora di fine. |
TimeWindow
Rappresenta un intervallo di tempo arbitrario.
| Rappresentazione JSON |
|---|
{ "startTime": string, "endTime": string } |
| Campi | |
|---|---|
startTime |
L'ora di inizio della finestra. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
endTime |
L'ora di fine della finestra. L'ora di fine deve essere successiva all'ora di inizio. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
MaintenanceExclusionWindow
Rappresenta un periodo di esclusione dalla manutenzione.
| Rappresentazione JSON |
|---|
{
"window": {
object ( |
| Campi | |
|---|---|
window |
Facoltativo. La finestra temporale. |
id |
Facoltativo. Un ID univoco (per cluster) per la finestra. |
ControlPlane
Configurazione del control plane del cluster.
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione
|
|
remote |
Configurazione del control plane remoto. |
local |
Configurazione del control plane locale. Avviso: i cluster del control plane locale devono essere creati nel proprio progetto. I cluster del control plane locale non possono coesistere nello stesso progetto con altri tipi di cluster, inclusi i cluster non GDCE. La combinazione di cluster GDCE del control plane locale con qualsiasi altro tipo di cluster nello stesso progetto può comportare la perdita di dati. |
Remoto
Questo tipo non ha campi.
Configurazione specifica per i cluster con un control plane ospitato da remoto.
Locale
Configurazione specifica per i cluster con un control plane ospitato localmente.
Avviso: i cluster del control plane locale devono essere creati nel proprio progetto. I cluster del control plane locale non possono coesistere nello stesso progetto con altri tipi di cluster, inclusi i cluster non GDCE. La combinazione di cluster GDCE del control plane locale con qualsiasi altro tipo di cluster nello stesso progetto può comportare la perdita di dati.
| Rappresentazione JSON |
|---|
{ "nodeLocation": string, "nodeCount": integer, "machineFilter": string, "sharedDeploymentPolicy": enum (/1.13.0/docs/="/distributed-cloud/connected/latest/docs/reference/container/rest/v1/projects.locations.clusters#SharedDeploymentPolicy">SharedDeploymentPolicy), "controlPlaneNodeStorageSchema": string, "controlPlaneNodeSystemPartitionSize": SystemPartitionGiBSize) } |
| Campi | |
|---|---|
nodeLocation |
Nome delle zone Google Distributed Cloud Edge in cui verrà creato questo pool di nodi. Ad esempio: |
nodeCount |
Il numero di nodi che fungono da repliche del control plane. |
machineFilter |
Solo le macchine che corrispondono a questo filtro potranno ospitare i nodi del control plane. Il linguaggio di applicazione dei filtri accetta stringhe come "name= |
sharedDeploymentPolicy |
Configurazione dei criteri relativi al deployment delle applicazioni utente. |
controlPlaneNodeStorageSchema |
Facoltativo. Nome dello schema di archiviazione dei nodi del control plane. |
controlPlaneNodeSystemPartitionSize |
Facoltativo. Dimensioni della partizione di sistema per i nodi del control plane in GiB. |
SystemAddonsConfig
Configurazione che i clienti possono definire per i componenti aggiuntivi di sistema GDCE.
| Rappresentazione JSON |
|---|
{ "ingress": { object ( |
| Campi | |
|---|---|
ingress |
Facoltativo. Configurazione per Ingress. |
vmServiceConfig |
Facoltativo. Configurazione per il servizio VM. |
In entrata
Configurazione per il componente aggiuntivo Ingress che consente ai clienti di creare un oggetto Ingress per gestire l'accesso esterno ai server in un cluster. Il componente aggiuntivo è costituito da istiod e istio-ingress.
| Rappresentazione JSON |
|---|
{ "disabled": boolean, "ipv4Vip": string } |
| Campi | |
|---|---|
disabled |
Facoltativo. Indica se Ingress è disabilitato. |
ipv4Vip |
Facoltativo. VIP Ingress. |
VMServiceConfig
VMServiceConfig definisce la configurazione per il servizio VM GDCE.
| Rappresentazione JSON |
|---|
{ "vmmEnabled": boolean } |
| Campi | |
|---|---|
vmmEnabled |
Facoltativo. Indica se VMM è abilitato. |
ControlPlaneEncryption
Configurazione per il supporto delle chiavi KMS gestite dal cliente per i nodi del control plane.
| Rappresentazione JSON |
|---|
{ "kmsKey": string, "kmsKeyActiveVersion": string, "kmsKeyState": enum ( |
| Campi | |
|---|---|
kmsKey |
Facoltativo. La CryptoKey Cloud KMS, ad esempio projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, da utilizzare per proteggere i dischi del control plane. Se non specificata, verrà utilizzata una chiave gestita da Google. |
kmsKeyActiveVersion |
Solo output. La versione CryptoKeyVersion di Cloud KMS attualmente in uso per proteggere i dischi del control plane. Applicabile solo se è impostato kmsKey. |
kmsKeyState |
Solo output. Disponibilità della CryptoKey di Cloud KMS. In caso contrario |
kmsStatus |
Solo output. Stato di errore restituito da Cloud KMS quando viene utilizzata questa chiave. Questo campo può essere compilato solo se |
resourceState |
Solo output. Lo stato attuale della risorsa associata alla CMEK. |
Stato
Indica lo stato del cluster.
| Enum | |
|---|---|
STATUS_UNSPECIFIED |
Stato sconosciuto. |
PROVISIONING |
Il cluster è in fase di creazione. |
RUNNING |
Il cluster è stato creato ed è completamente utilizzabile. |
DELETING |
Il cluster è in fase di eliminazione. |
ERROR |
Lo stato indica che si sono verificati alcuni errori durante la riconciliazione/eliminazione del cluster. |
RECONCILING |
Il cluster è in fase di aggiornamento della versione o di altre operazioni. |
MaintenanceEvent
Un evento di manutenzione è un'operazione che potrebbe causare interruzioni temporanee dei workload del cluster, tra cui upgrade del cluster gestiti da Google o avviati dall'utente, modifiche alla configurazione del cluster avviate dall'utente che richiedono il riavvio dei nodi e così via.
| Rappresentazione JSON |
|---|
{ "uuid": string, "targetVersion": string, "operation": string, "type": enum ( |
| Campi | |
|---|---|
uuid |
Solo output. UUID dell'evento di manutenzione. |
targetVersion |
Solo output. La versione di destinazione del cluster. |
operation |
Solo output. L'operazione per l'esecuzione dell'evento di manutenzione. Specificato nel formato projects/*/locations/*/operations/*. Se l'evento di manutenzione è suddiviso in più operazioni (ad esempio a causa di periodi di manutenzione), viene registrata l'ultima. |
type |
Solo output. Il tipo di evento di manutenzione. |
schedule |
Solo output. La pianificazione dell'evento di manutenzione. |
state |
Solo output. Lo stato dell'evento di manutenzione. |
createTime |
Solo output. La data e l'ora in cui è stata creata la richiesta di supporto per eventi di manutenzione. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
startTime |
Solo output. L'ora di inizio dell'evento di manutenzione. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
endTime |
Solo output. L'ora in cui l'evento di manutenzione è terminato, con o senza esito positivo. Se l'evento di manutenzione è suddiviso in più periodi di manutenzione, endTime viene aggiornato solo al termine dell'intero flusso. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
updateTime |
Solo output. L'ora in cui è stato aggiornato il messaggio dell'evento di manutenzione. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
Tipo
Indica il tipo di evento di manutenzione.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Non specificato. |
USER_INITIATED_UPGRADE |
Upgrade avviato dagli utenti. |
GOOGLE_DRIVEN_UPGRADE |
Upgrade basato su Google. |
Pianificazione
Indica quando deve essere eseguito l'evento di manutenzione.
| Enum | |
|---|---|
SCHEDULE_UNSPECIFIED |
Non specificato. |
IMMEDIATELY |
Subito dopo aver ricevuto la richiesta. |
Stato
Indica lo stato dell'evento di manutenzione.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Non specificato. |
RECONCILING |
L'evento di manutenzione è in corso. Il cluster potrebbe essere inutilizzabile. |
SUCCEEDED |
L'evento di manutenzione è riuscito. |
FAILED |
L'evento di manutenzione non è riuscito. |
ReleaseChannel
Il canale di rilascio a cui è iscritto un cluster.
| Enum | |
|---|---|
RELEASE_CHANNEL_UNSPECIFIED |
Canale di rilascio non specificato. Il valore predefinito sarà il canale REGULAR. |
NONE |
Nessun canale di rilascio. |
REGULAR |
Canale di rilascio regolare. |
SurvivabilityConfig
Configurazione della sopravvivenza del cluster, ad esempio nel caso in cui venga persa la connessione di rete.
| Rappresentazione JSON |
|---|
{ "offlineRebootTtl": string } |
| Campi | |
|---|---|
offlineRebootTtl |
Facoltativo. Periodo di tempo che consente di riavviare i nodi del cluster e renderli funzionali senza connettività di rete a Google. Il valore predefinito 0 indica che non è consentito. Il periodo di tempo massimo è 30 giorni. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
ConnectionState
ConnectionState contiene lo stato attuale della connessione dal cluster a Google.
| Rappresentazione JSON |
|---|
{
"state": enum ( |
| Campi | |
|---|---|
state |
Solo output. Lo stato attuale della connessione. |
updateTime |
Solo output. L'ora dell'ultima modifica dello stato della connessione. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
Stato
Lo stato della connessione.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Stato della connessione sconosciuto. |
DISCONNECTED |
Questo cluster è attualmente disconnesso da Google. |
CONNECTED |
Questo cluster è attualmente connesso a Google. |
CONNECTED_AND_SYNCING |
Questo cluster è attualmente connesso a Google, ma potrebbe essersi riconnesso di recente dopo una disconnessione. La sincronizzazione è ancora in corso. |
ExternalLoadBalancerPool
Pool di bilanciatori del carico esterni con configurazione personalizzata, ad esempio nome, assegnazione manuale/automatica, intervallo di indirizzi IPv4 non sovrapposti e IPv6 facoltativo.
| Rappresentazione JSON |
|---|
{ "addressPool": string, "ipv4Range": [ string ], "ipv6Range": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
| Campi | |
|---|---|
addressPool |
Facoltativo. Nome del pool del bilanciatore del carico esterno. |
ipv4Range[] |
Obbligatorio. Intervallo di indirizzi IPv4 non sovrapposti del pool di bilanciatori del carico esterni. |
ipv6Range[] |
Facoltativo. Intervallo di indirizzi IPv6 non sovrapposto del pool di bilanciatori del carico esterni. |
avoidBuggyIps |
Facoltativo. 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. Il valore predefinito è false. |
manualAssign |
Facoltativo. Se impostato su true, gli indirizzi di questo pool non vengono assegnati automaticamente ai servizi Kubernetes. Se il valore è true, un indirizzo IP in questo pool viene utilizzato solo se viene specificato esplicitamente da un servizio. Il valore predefinito è false. |
ZoneStorageEncryption
Configurazione per il supporto CMEK dello spazio di archiviazione a livello di zona
| Rappresentazione JSON |
|---|
{
"kmsKey": string,
"kmsKeyActiveVersion": string,
"resourceState": enum ( |
| Campi | |
|---|---|
kmsKey |
Facoltativo. La chiave Cloud KMS |
kmsKeyActiveVersion |
Solo output. La versione CryptoKeyVersion di Cloud KMS attualmente utilizzata per la crittografia/decrittografia |
resourceState |
Solo output. Lo stato attuale della risorsa CMEK |
ContainerRuntimeConfig
Configurazione del runtime del container del cluster.
| Rappresentazione JSON |
|---|
{ "defaultContainerRuntime": enum /1.13.0/docs/f="/distributed-cloud/connected/latest/docs/reference/container/rest/v1/projects.locations.clusters#DefaultContainerRuntime">DefaultContainerRuntime) } |
| Campi | |
|---|---|
defaultContainerRuntime |
Facoltativo. Il runtime dei container predefinito da configurare nel cluster. |
DefaultContainerRuntime
Elenco dei runtime dei container supportati.
| Enum | |
|---|---|
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED |
Runtime del container non specificato. |
RUNC |
Utilizza runc come runtime dei container predefinito nel cluster. |
GVISOR |
Utilizza gVisor come runtime dei container predefinito nel cluster. |
GoogleGroupAuthenticationConfig
Configurazione dell'autenticazione di Google Gruppi del cluster. go/gdc-google-group-authentication
| Rappresentazione JSON |
|---|
{ "enable": boolean } |
| Campi | |
|---|---|
enable |
Facoltativo. Se true, il cluster verrà configurato per utilizzare l'autenticazione di Google Gruppi. |
Metodi |
|
|---|---|
|
Crea un nuovo cluster in un progetto e una località specifici. |
|
Elimina un singolo cluster. |
|
Genera un token di accesso per un cluster. |
|
Genera una credenziale offline per un cluster. |
|
Recupera i dettagli di un singolo cluster. |
|
Elenca i cluster in un progetto e una località specifici. |
|
Aggiorna i parametri di un singolo cluster. |
|
Esegue l'upgrade di un singolo cluster. |