- Risorsa: Cluster
- Fleet
- 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
- 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. |
create |
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: |
update |
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. |
default |
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. |
cluster |
Solo output. Il certificato pubblico con codifica PEM della CA del cluster. |
maintenance |
Facoltativo. Configurazione della policy di manutenzione a livello di cluster. |
control |
Solo output. La versione di release del control plane |
node |
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. |
control |
Facoltativo. La configurazione del control plane del cluster. |
system |
Facoltativo. La configurazione dei componenti aggiuntivi di sistema. |
external |
Facoltativo. Pool di indirizzi IPv4 per il bilanciamento del carico esterno del piano dati del cluster. |
control |
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. |
maintenance |
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). |
target |
Facoltativo. La versione del cluster di destinazione. Ad esempio: "1.5.0". |
release |
Facoltativo. Il canale di rilascio a cui è iscritto un cluster. |
survivability |
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 con control plane locale. |
external |
Facoltativo. Pool di indirizzi IPv6 per il bilanciamento del carico esterno del piano dati del cluster. |
connection |
Solo output. Lo stato di connessione attuale del cluster. |
external |
Facoltativo. Pool di bilanciatori del carico esterni per il cluster. |
zone |
Facoltativo. La configurazione della crittografia dello spazio di archiviazione della zona |
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 appartenenza 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 | |
|---|---|
cluster |
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. |
services |
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 | |
|---|---|
admin |
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. |
maintenance |
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 per manutenzione consentite in un determinato momento è 3. |
MaintenanceWindow
Configurazione del periodo di manutenzione
| Rappresentazione JSON |
|---|
{
"recurringWindow": {
object ( |
| Campi | |
|---|---|
recurring |
Configurazione di un periodo di manutenzione ricorrente. |
RecurringTimeWindow
Rappresenta un intervallo 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 | |
|---|---|
start |
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: |
end |
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. Attenzione: 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 con 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.
Attenzione: 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 con 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 ( |
| Campi | |
|---|---|
node |
Nome delle zone Google Distributed Cloud Edge in cui verrà creato questo pool di nodi. Ad esempio: |
node |
Il numero di nodi che fungono da repliche del control plane. |
machine |
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= |
shared |
Configurazione della policy relativa al deployment delle applicazioni utente. |
control |
Facoltativo. Nome dello schema di archiviazione dei nodi del control plane. Attenzione: la funzionalità dello schema di archiviazione locale dei nodi configurabile è una funzionalità sperimentale e non è consigliata per l'uso generale nei cluster/node pool di produzione. |
SystemAddonsConfig
Configurazione che i clienti possono definire per i componenti aggiuntivi di sistema GDCE.
| Rappresentazione JSON |
|---|
{ "ingress": { object ( |
| Campi | |
|---|---|
ingress |
Facoltativo. Configurazione per Ingress. |
vm |
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. |
ipv4 |
Facoltativo. VIP Ingress. |
VMServiceConfig
VMServiceConfig definisce la configurazione per il servizio VM GDCE.
| Rappresentazione JSON |
|---|
{ "vmmEnabled": boolean } |
| Campi | |
|---|---|
vmm |
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 | |
|---|---|
kms |
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. |
kms |
Solo output. La versione CryptoKeyVersion di Cloud KMS attualmente in uso per proteggere i dischi del control plane. Applicabile solo se è impostato kmsKey. |
kms |
Solo output. Disponibilità della CryptoKey di Cloud KMS. In caso contrario |
kms |
Solo output. Stato di errore restituito da Cloud KMS quando viene utilizzata questa chiave. Questo campo può essere compilato solo se |
resource |
Solo output. Lo stato attuale della risorsa associata alla chiave 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. |
target |
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. |
create |
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: |
start |
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: |
end |
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: |
update |
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 | |
|---|---|
offline |
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 è 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. |
update |
Solo output. La data e 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
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 | |
|---|---|
address |
Facoltativo. Nome del pool del bilanciatore del carico esterno. |
ipv4 |
Obbligatorio. Intervallo di indirizzi IPv4 non sovrapposti del pool del bilanciatore del carico esterno. |
ipv6 |
Facoltativo. Intervallo di indirizzi IPv6 non sovrapposto del pool di bilanciatori del carico esterni. |
avoid |
Facoltativo. Se impostato su 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. |
manual |
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 | |
|---|---|
kms |
Facoltativo. La chiave Cloud KMS |
kms |
Solo output. La versione CryptoKey Cloud KMS attualmente utilizzata per la crittografia/decrittografia |
resource |
Solo output. Lo stato attuale della risorsa CMEK |
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. |