- Risorsa: cluster
- Parco risorse
- ClusterNetworking
- Autorizzazione
- ClusterUser
- MaintenancePolicy
- MaintenanceWindow
- RecurringTimeWindow
- TimeWindow
- MaintenanceExclusionWindow
- ControlPlane
- Telecomando
- 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. 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. 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 del networking a livello di cluster. |
authorization |
Obbligatorio. Immutabile. Criterio RBAC che verrà applicato e gestito 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 rilascio del control plane |
nodeVersion |
Solo output. La versione di rilascio 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 viene attivato il supporto di 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 per il caso in cui la connettività di rete viene persa. 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 attuale della connessione del cluster. |
externalLoadBalancerAddressPools[] |
Facoltativo. Pool del bilanciatore del carico esterno per il cluster. |
zoneStorageEncryption |
Facoltativo. Configurazione della crittografia dell'archiviazione della zona |
containerRuntimeConfig |
Facoltativo. La configurazione del runtime del container del 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 criteri 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 Hub Membership gestita associata a questo cluster. I nomi delle iscrizioni sono formattati come |
ClusterNetworking
Configurazione del networking 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
Criterio RBAC che verrà applicato e gestito 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 la presenza di 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 |
Una RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) per la ricorrenza di questa finestra. Continuano per l'intervallo di tempo tra l'ora di inizio e quella di fine. |
TimeWindow
Rappresenta un periodo di tempo arbitrario.
| Rappresentazione JSON |
|---|
{ "startTime": string, "endTime": string } |
| Campi | |
|---|---|
startTime |
L'ora in cui inizia la 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 in cui termina la 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 della 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 piano di controllo 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ò causare la perdita di dati. |
Remoto
Questo tipo non contiene 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 piano di controllo 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ò causare la perdita di dati.
| Rappresentazione JSON |
|---|
{
"nodeLocation": string,
"nodeCount": integer,
"machineFilter": string,
"sharedDeploymentPolicy": enum ( |
| 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 filtraggio accetta stringhe come "name= |
sharedDeploymentPolicy |
Configurazione dei criteri relativi alla modalità di deployment delle applicazioni utente. |
controlPlaneNodeStorageSchema |
Facoltativo. Nome dello schema di archiviazione dei nodi del control plane. |
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 del 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 in entrata. |
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 della chiave KMS gestita dal cliente per i nodi del control plane.
| Rappresentazione JSON |
|---|
{ "kmsKey": string, "kmsKeyActiveVersion": string, "kmsKeyState": enum ( |
| Campi | |
|---|---|
kmsKey |
Facoltativo. La chiave di crittografia 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 CryptoKeyVersion di Cloud KMS attualmente in uso per proteggere i dischi del control plane. Applicabile solo se è impostata kmsKey. |
kmsKeyState |
Solo output. Disponibilità della chiave di crittografia Cloud KMS. In caso contrario, i nodi potrebbero andare offline perché non possono accedere ai dati locali. |
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 a 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/l'eliminazione del cluster. |
RECONCILING |
Il cluster è in fase di aggiornamento, ad esempio degli upgrade di versione. |
MaintenanceEvent
Un evento di manutenzione è un'operazione che potrebbe causare interruzioni temporanee ai workload del cluster, inclusi gli upgrade del cluster basati su Google o avviati dall'utente, le 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 es. a causa di finestre 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. L'ora in cui è stata creata la richiesta di 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: |
startTime |
Solo output. L'ora in cui è iniziato l'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, correttamente o meno. Se l'evento di manutenzione è suddiviso in più finestre 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 gestito da Google. |
Pianifica
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. Per impostazione predefinita, verrà selezionato il canale REGULAR. |
NONE |
Nessun canale di rilascio. |
REGULAR |
Canale di rilascio regolare. |
SurvivabilityConfig
Configurazione della sopravvivenza del cluster, ad esempio per il caso in cui la connettività di rete viene persa.
| Rappresentazione JSON |
|---|
{ "offlineRebootTtl": string } |
| Campi | |
|---|---|
offlineRebootTtl |
Facoltativo. Periodo di tempo che consente il riavvio dei nodi del cluster e il loro funzionamento senza connettività di rete a Google. Il valore predefinito 0 significa che non è consentito. Il periodo di tempo massimo è 7 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 del bilanciatore del carico esterno con configurazione personalizzata come nome, assegnazione manuale/automatica, intervallo di indirizzi IPv4 non sovrapposto e intervallo di indirizzi 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 sovrapposto del pool del bilanciatore del carico esterno. |
ipv6Range[] |
Facoltativo. Intervallo di indirizzi IPv6 non sovrapposto del pool del bilanciatore del carico esterno. |
avoidBuggyIps |
Facoltativo. Se il valore è true, il pool omette gli indirizzi IP che terminano con .0 e .255. Alcuni hardware di rete eliminano il traffico verso questi indirizzi speciali. Il valore predefinito è false. |
manualAssign |
Facoltativo. Se è true, gli indirizzi in questo pool non vengono assegnati automaticamente ai servizi Kubernetes. Se è vero, un indirizzo IP in questo pool viene utilizzato solo quando viene specificato esplicitamente da un servizio. Il valore predefinito è false. |
ZoneStorageEncryption
Configurazione del supporto CMEK per l'archiviazione di zona
| Rappresentazione JSON |
|---|
{
"kmsKey": string,
"kmsKeyActiveVersion": string,
"resourceState": enum ( |
| Campi | |
|---|---|
kmsKey |
Facoltativo. Chiave Cloud KMS |
kmsKeyActiveVersion |
Solo output. La versione CryptoKey Cloud KMS attualmente utilizzata per la crittografia/decrittografia |
resourceState |
Solo output. Lo stato attuale della risorsa della chiave CMEK |
ContainerRuntimeConfig
Configurazione del runtime del container del cluster.
| Rappresentazione JSON |
|---|
{
"defaultContainerRuntime": enum ( |
| Campi | |
|---|---|
defaultContainerRuntime |
Facoltativo. Il runtime del container predefinito da configurare nel cluster. |
DefaultContainerRuntime
Elenco dei runtime dei container supportati.
| Enum | |
|---|---|
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED |
Runtime container non specificato. |
RUNC |
Utilizza runc come runtime del container predefinito nel cluster. |
GVISOR |
Utilizza gVisor come runtime del container predefinito nel cluster. |
GoogleGroupAuthenticationConfig
Configurazione dell'autenticazione del gruppo Google 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. |