Per informazioni sulla versione, consulta le note di rilascio di Distributed Cloud connesso.

Crea e gestisci i cluster

Questa pagina descrive come creare e gestire le risorse del cluster Google Distributed Cloud connected.

Per saperne di più sui cluster Distributed Cloud connesso, vedi Come funziona Distributed Cloud connesso.

I server connessi a Distributed Cloud e le implementazioni multi-rack di Distributed Cloud Connected, in cui un rack di base aggrega le risorse di uno o più rack autonomi, supportano solo i cluster del control plane locale. Non puoi creare cluster del piano di controllo Cloud su questi tipi di deployment.

Crea un cluster

Per creare un cluster connesso Distributed Cloud, completa i passaggi in questa sezione. La creazione di un cluster è uno dei numerosi passaggi necessari per eseguire il deployment di un carico di lavoro su Distributed Cloud Connected.

Per creare un cluster con un control plane locale in grado di eseguire i workload mentre è temporaneamente disconnesso da Google Cloud, leggi prima la sezione Modalità di sopravvivenza.

Per completare questa attività, devi disporre del ruolo Amministratore container edge (roles/edgecontainer.admin) nel tuo progetto Google Cloud .

Console

Nella console Google Cloud , vai alla pagina Cluster.

Vai a Cluster
Fai clic su Crea cluster.
Nella pagina Crea un cluster, fai clic sulla scheda On-premise.
Accanto all'opzione Distributed Cloud Edge, fai clic su Configura.
Nella pagina Impostazioni di base del cluster, fornisci le seguenti informazioni:
- Nome: un nome univoco che identifica questo cluster. Questo nome deve essere conforme a RFC 1213 e contenere solo caratteri alfanumerici minuscoli e trattini (-). Deve iniziare e terminare con un carattere alfanumerico.
- Località: la Google Cloud regione in cui vuoi creare questo cluster.
- Numero massimo predefinito di pod per nodo: il numero massimo desiderato di pod Kubernetes da eseguire su ogni nodo di questo cluster.
- Etichette: ti consente di aggiungere una o più etichette a questo cluster facendo clic su Aggiungi etichetta.
Nel menu di navigazione a sinistra, fai clic su Networking.
Nella pagina Networking, fornisci le seguenti informazioni:
- Intervallo di indirizzi dei pod predefiniti del cluster: il blocco CIDR IPv4 desiderato per i pod Kubernetes in esecuzione su questo cluster.
- Intervallo di indirizzi del servizio: il blocco CIDR IPv4 desiderato per i servizi Kubernetes in esecuzione su questo cluster.
Per ulteriori informazioni, consulta Allocazione di indirizzi di rete di pod e servizi cloud distribuiti.
Nel menu di navigazione a sinistra, fai clic su Autorizzazione.
Nella pagina Autorizzazione, fornisci il nome dell'account utente all'interno del progetto Google Cloud di destinazione autorizzato a modificare le risorse del cluster.
Nel menu di navigazione a sinistra, fai clic su Norme di manutenzione.

Avviso: un cluster Distributed Cloud connesso non ha un periodo di manutenzione predefinito. Ciò significa che un aggiornamento software può potenzialmente interrompere un carico di lavoro critico. Per garantire l'alta disponibilità, devi configurare periodi di manutenzione scaglionati per i tuoi cluster Distributed Cloud in modo che gli aggiornamenti software vengano eseguiti in momenti diversi e i tuoi workload rimangano disponibili.
Nella pagina Policy di manutenzione, fornisci le seguenti informazioni:
- Abilita periodo di manutenzione: seleziona questa casella di controllo per configurare un periodo di manutenzione per il cluster. Per evitare tempi di inattività imprevisti causati dagli aggiornamenti software connessi a Distributed Cloud, ti consigliamo vivamente di configurare sempre una periodo di manutenzionene per ogni cluster Distributed Cloud che crei. Per maggiori informazioni, vedi Informazioni su aggiornamenti software e periodi di manutenzione.
- Ora di inizio: la data e l'ora in cui inizia il periodo di manutenzione per questo cluster.
- Ora di fine: la data e l'ora in cui termina la finestra di manutenzione per questo cluster.
- RRule: la frequenza del periodo di manutenzione nel formato FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
  - FREQ può essere DAILY o WEEKLY.
  - BYDAY: un elenco delimitato da virgole dei giorni durante i quali può verificarsi la manutenzione se FREQ è impostato su WEEKLY. Se ometti il parametro BYDAY, Google sceglie il giorno della settimana per te.
  - Se imposti FREQ su DAILY, i periodi di manutenzione si verificano ogni giorno durante le ore specificate.
Assegna un pool di nodi al cluster eseguendo una delle seguenti operazioni:
- Per assegnare un pool di nodi esistente a questo cluster, nella sezione Node pool nel riquadro di navigazione a sinistra, seleziona il pool di nodi esistente e verifica che la configurazione pool di nodi nella pagina Dettagli node pool sia corretta.
- Per creare un nuovo pool di nodi da assegnare a questo cluster, fai clic su add_boxAggiungi node pool e fornisci le seguenti informazioni nella pagina Dettagli del node pool:
  - Nome del node pool: un nome univoco che identifica questo pool di nodi.
  - Etichette del pool di nodi: fai clic su Aggiungi etichetta per aggiungere una o più etichette a questo pool di nodi.
  - Preferenza dei nodi worker: seleziona i nodi connessi a Distributed Cloud da assegnare a questo pool di nodi.
Per creare il cluster Distributed Cloud connesso, fai clic su Crea.

gcloud

Utilizza il comando gcloud edge-cloud container clusters create:

gcloud edge-cloud container clusters create CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --fleet-project=FLEET_PROJECT_ID \
    --cluster-ipv4-cidr=CLUSTER_IPV4_CIDR_BLOCK \
    --services-ipv4-cidr=SERVICE_IPV4_CIDR_BLOCK \
    --default-max-pods-per-node=MAX_PODS_PER_NODE \
    --release-channel RELEASE_CHANNEL \
    --control-plane-kms-key=CONTROL_PLANE_KMS_KEY \
    --control-plane-node-location=CONTROL_PLANE_LOCATION \
    --control-plane-node-count=CONTROL_PLANE_NODE_COUNT \
    --control-plane-machine-filter=CONTROL_PLANE_NODE_FILTER \
    --control-plane-shared-deployment-policy=CONTROL_PLANE_NODE_SHARING \
    --external-lb-ipv4-address-pools=IPV4_DATA_PLANE_ADDRESSES \
    --version SOFTWARE_VERSION \
    --offline-reboot-ttl REBOOT_TIMEOUT

Sostituisci quanto segue:

CLUSTER_ID: un nome univoco che identifica questo cluster. Questo nome deve essere conforme a RFC 1213 e contenere solo caratteri alfanumerici minuscoli e trattini (-). Deve iniziare e terminare con un carattere alfanumerico.
PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui viene creato il cluster e in cui viene eseguito il provisioning del control plane Kubernetes per il cluster.
FLEET_PROJECT_ID: l'ID del progetto host del parco risorse in cui è registrato il cluster. Se questo flag viene omesso, il progetto del cluster connesso Distributed Cloud viene utilizzato come progetto host del parco.
CLUSTER_IPV4_CIDR_BLOCK: il blocco CIDR IPv4 desiderato per i pod Kubernetes che vengono eseguiti su questo cluster.
SERVICE_IPV4_CIDR_BLOCK: il blocco CIDR IPv4 desiderato per i servizi Kubernetes in esecuzione su questo cluster.
MAX_PODS_PER_NODE (facoltativo): il numero massimo desiderato di pod Kubernetes da eseguire su ogni nodo di questo cluster.
RELEASE_CHANNEL: (facoltativo) specifica il canale di rilascio per la versione del software Distributed Cloud che vuoi che questo cluster esegua. I valori validi sono REGULAR (abilita gli upgrade automatici del cluster) e NONE (disabilita gli upgrade automatici del cluster). Se omesso, il valore predefinito è REGULAR.
CONTROL_PLANE_KMS_KEY (facoltativo): il percorso completo della chiave Cloud KMS che vuoi utilizzare con il nodo del control plane di questo cluster. Ad esempio:
```
/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
```
Questo flag si applica solo se hai integrato Distributed Cloud connesso con Cloud Key Management Service come descritto in Attivare il supporto delle chiavi di crittografia gestite dal cliente (CMEK) per lo spazio di archiviazione locale.

Se stai creando un cluster con un control plane locale, oltre a sostituire le variabili precedenti, sostituisci anche quanto segue:

CONTROL_PLANE_LOCATION: indica a Distributed Cloud di eseguire il deployment dei carichi di lavoro del control plane per questo cluster in locale. Il valore è il nome della zona connessa a Distributed Cloud di destinazione.
CONTROL_PLANE_NODE_COUNT (facoltativo): specifica il numero di nodi su cui eseguire i carichi di lavoro del control plane locale. I valori validi sono 3 per l'alta disponibilità e 1 per il funzionamento standard. Se omesso, il valore predefinito è 3.
CONTROL_PLANE_NODE_FILTER (facoltativo): specifica un elenco formattato con espressioni regolari dei nodi che eseguono i carichi di lavoro del control plane locale. Se omesso, Distributed Cloud seleziona i nodi automaticamente in modo casuale.
CONTROL_PLANE_NODE_SHARING: (facoltativo) specifica se i workload delle applicazioni possono essere eseguiti sui nodi che eseguono i workload del piano di controllo locale. I valori validi sono DISALLOWED e ALLOWED. Se omesso, Se omesso, il valore predefinito è DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES: specifica un elenco delimitato da virgole di indirizzi IPv4, intervalli di indirizzi o subnet per il traffico in entrata per i servizi eseguiti dietro il bilanciatore del carico Distributed Cloud quando il cluster è in esecuzione in modalità di sopravvivenza.
SOFTWARE_VERSION: specifica la versione del software Distributed Cloud (connesso) che vuoi che questo cluster esegua nel formato 1.X.Y, dove X è la versione secondaria e Y è la versione patch, ad esempio 1.5.1. Se omessa, viene utilizzata la versione software predefinita del server, che in genere è l'ultima versione disponibile di Distributed Cloud Connected. Per ottenere le versioni software disponibili per la creazione di cluster, inclusa la versione predefinita del server, consulta Ottenere le versioni software disponibili per un cluster. Devi impostare il flag RELEASE_CHANNEL su NONE per specificare una versione del software del cluster.
REBOOT_TIMEOUT: (richiede gcloud alpha) specifica una finestra temporale in secondi durante la quale un nodo del cluster può rientrare in un cluster dopo il riavvio mentre il cluster è in esecuzione in modalità di sopravvivenza. Se omesso, il valore predefinito è 0, che non consente ai nodi riavviati di ricongiungersi al cluster finché la connessione a Google Cloud non è stata ristabilita. Questa è una funzionalità a livello di anteprima.

ATTENZIONE: se specifichi una finestra di timeout per il riavvio, i nodi che sono andati offline possono riavviarsi e ricongiungersi al cluster anche se disattivi o elimini la chiave di archiviazione per il periodo di tempo specificato.

API

Invia una richiesta POST al metodo projects.locations.clusters:

POST /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&requestId=REQUEST_ID&fleetId=FLEET_PROJECT_ID

{
  "labels": { LABELS,
  },
  "authorization": {
    "adminUsers": {
      "username": "USERNAME"
    }
  },
  "fleet": {
    "project": "FLEET_PROJECT_ID"
  },
  "networking": {
    "clusterIpv4CidrBlocks": CLUSTER_IPV4_CIDR_BLOCK,
    "servicesIpv4CidrBlocks": SERVICE_IPV4_CIDR_BLOCK,
      },
  "defaultMaxPodsPerNode": MAX_PODS_PER_NODE,
  "releaseChannel": "RELEASE_CHANNEL",
  "controlPlaneEncryption": {
   "kmsKey": CONTROL_PLANE_KMS_KEY,
  },      
  "controlPlane": {
    "local": {
      "nodeLocation": "CONTROL_PLANE_LOCATION",
      "nodeCount": CONTROL_PLANE_NODE_COUNT,
      "machineFilter": "CONTROL_PLANE_NODE_FILTER",
      "sharedDeploymentPolicy": "CONTROL_PLANE_NODE_SHARING"
    }
  },
  "externalLoadBalancerIpv4AddressPools": [
    "IPV4_DATA_PLANE_ADDRESSES"
  ],
  "targetVersion": "SOFTWARE_VERSION",
  "offlineRebootTtl": "REBOOT_TIMEOUT",
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la Google Cloud regione in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.
CLUSTER_ID: un nome univoco che identifica questo cluster. Questo nome deve essere conforme a RFC 1213 e contenere solo caratteri alfanumerici minuscoli e trattini (-). Deve iniziare e terminare con un carattere alfanumerico.
REQUEST_ID: un ID programmatico univoco che identifica questa richiesta.
FLEET_PROJECT_ID: l'ID del progetto host del parco risorse in cui è registrato il cluster. Può trattarsi di un progetto separato o del progetto connesso a Distributed Cloud a cui appartiene questo cluster (PROJECT_ID). La registrazione del parco risorse è obbligatoria.
LABELS: un elenco di etichette da applicare a questa risorsa cluster.
USERNAME: il nome dell'account utente all'interno del progetto Google Cloud di destinazione autorizzato a modificare le risorse del cluster.
CLUSTER_IPV4_CIDR_BLOCK: il blocco CIDR IPv4 desiderato per i pod Kubernetes che vengono eseguiti su questo cluster.
SERVICE_IPV4_CIDR_BLOCK: il blocco CIDR IPv4 desiderato per i servizi Kubernetes in esecuzione su questo cluster.
MAX_PODS_PER_NODE: il numero massimo desiderato di pod Kubernetes da eseguire su ogni nodo di questo cluster.
RELEASE_CHANNEL: (facoltativo) specifica il canale di rilascio per la versione del software Distributed Cloud connesso che vuoi che questo cluster esegua. I valori validi sono REGULAR (abilita gli upgrade automatici del cluster) e NONE (disabilita gli upgrade automatici del cluster). Se omesso, il valore predefinito è REGULAR.
CONTROL_PLANE_KMS_KEY (facoltativo): il percorso completo della chiave Cloud KMS che vuoi utilizzare con il nodo del control plane di questo cluster. Ad esempio:
```
/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
```
Questo parametro si applica solo se hai integrato Distributed Cloud connesso a Cloud Key Management Service come descritto in Attivare il supporto delle chiavi di crittografia gestite dal cliente (CMEK) per lo spazio di archiviazione locale.

Se stai creando un cluster con un control plane locale, oltre a sostituire le variabili precedenti, sostituisci anche quanto segue:

CONTROL_PLANE_LOCATION: indica a Distributed Cloud di eseguire il deployment dei carichi di lavoro del control plane per questo cluster in locale. Il valore è il nome della zona Distributed Cloud di destinazione.
CONTROL_PLANE_NODE_COUNT: specifica il numero di nodi su cui eseguire i carichi di lavoro del control plane locale. I valori validi sono 3 per l'alta disponibilità e 1 per il funzionamento standard.
CONTROL_PLANE_NODE_FILTER (facoltativo): specifica un elenco formattato con espressioni regolari dei nodi che eseguono i carichi di lavoro del control plane locale. Se omesso, Distributed Cloud seleziona i nodi automaticamente in modo casuale.
CONTROL_PLANE_NODE_SHARING: specifica se i carichi di lavoro delle applicazioni possono essere eseguiti sui nodi che eseguono i carichi di lavoro del control plane locale. I valori validi sono DISALLOWED e ALLOWED. Se omesso, il valore predefinito è DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES: specifica un elenco delimitato da virgole di indirizzi IPv4, intervalli di indirizzi o subnet per il traffico in entrata per i servizi eseguiti dietro il bilanciatore del carico Distributed Cloud su un cluster del piano di controllo locale. Non si applica ai cluster del control plane di Cloud.
SOFTWARE_VERSION: specifica la versione del software Distributed Cloud che vuoi che questo cluster esegua nel formato 1.X.Y, dove X è la versione secondaria e Y è la versione della patch, ad esempio 1.5.1. Se omessa, viene utilizzata la versione software predefinita del server, che in genere è l'ultima versione disponibile di Distributed Cloud Connected. Per ottenere le versioni software disponibili per la creazione di cluster, inclusa la versione predefinita del server, consulta Ottenere le versioni software disponibili per un cluster. Devi impostare il campo RELEASE_CHANNEL su NONE per specificare una versione del software del cluster.
REBOOT_TIMEOUT: (richiede v1alpha1) specifica una finestra temporale in secondi durante la quale un nodo del cluster può rientrare in un cluster dopo il riavvio mentre il cluster è in esecuzione in modalità di sopravvivenza. Se omesso, il valore predefinito è 0, che non consente ai nodi riavviati di ricongiungersi al cluster finché la connessione a Google Cloud non è stata ristabilita. Questa è una funzionalità a livello di anteprima.

ATTENZIONE: se specifichi una finestra di timeout per il riavvio, i nodi che sono andati offline possono riavviarsi e ricongiungersi al cluster anche se disattivi o elimini la chiave di archiviazione per il periodo di tempo specificato.

Elenca i cluster in una regione

Per elencare i cluster connessi a Distributed Cloud di cui è stato eseguito il provisioning in una regioneGoogle Cloud , completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Visualizzatore container edge (roles/edgecontainer.viewer) nel tuo progetto Google Cloud .

Console

Nella console Google Cloud , vai alla pagina Cluster.

Vai a Cluster
Esamina l'elenco dei cluster.

gcloud

Utilizza il comando gcloud edge-cloud container clusters list:

gcloud edge-cloud container clusters list \
    --project=PROJECT_ID \
    --location=REGION

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui hai creato il cluster Distributed Cloud (connesso).

API

Invia una richiesta GET al metodo projects.locations.clusters.list:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la Google Cloud regione in cui viene creato il cluster Distributed Cloud di destinazione.
CLUSTER_ID: il nome del cluster di destinazione.
FILTER: un'espressione che vincola i risultati restituiti a valori specifici.
PAGE_SIZE: il numero di risultati da restituire per pagina.
SORT_BY: un elenco delimitato da virgole di nomi di campi in base ai quali vengono ordinati i risultati restituiti. L'ordinamento predefinito è crescente. Per l'ordinamento decrescente, aggiungi il prefisso ~ al campo desiderato.
PAGE_TOKEN: un token ricevuto nella risposta all'ultima richiesta di elenco nel campo nextPageToken della risposta. Invia questo token per ricevere una pagina di risultati.

Recuperare informazioni su un cluster

Per ottenere informazioni su un cluster connesso a Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Visualizzatore container edge (roles/edgecontainer.viewer) nel tuo progetto Google Cloud .

Console

Nella console Google Cloud , vai alla pagina Cluster.

Vai a Cluster
Seleziona il cluster che ti interessa.

Nel riquadro di destra viene visualizzato un riquadro esteso con informazioni dettagliate sul cluster.

gcloud

Utilizza il comando gcloud edge-cloud container clusters describe:

gcloud edge-cloud container clusters describe CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Sostituisci quanto segue:

CLUSTER_ID: il nome del cluster di destinazione.
PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui hai creato la zona Google Distributed Cloud connessa.

API

Invia una richiesta GET al metodo projects.locations.clusters.get:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.
CLUSTER_ID: il nome del cluster di destinazione.

Recupera le versioni software disponibili per un cluster

Per scoprire quali versioni del software Distributed Cloud connected sono disponibili nella tua zona connessa a Distributed Cloud per creare cluster, completa i passaggi in questa sezione.

Per completare questa attività, devi disporre del ruolo Visualizzatore container edge (roles/edgecontainer.viewer) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud container get-server-config:

gcloud edge-cloud container get-server-config --location=REGION

Sostituisci REGION: con la regione Google Cloud in cui hai creato la zona connessa a Distributed Cloud.

API

Invia una richiesta GET al metodo projects.locations.serverConfig:

GET /v1/projects/PROJECT_ID/locations/REGION/serverConfig

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.

Esegui l'upgrade della versione software di un cluster del control plane locale

Per eseguire l'upgrade della versione software di un cluster del control plane locale connesso a Distributed Cloud, completa i passaggi descritti in questa sezione. Questa funzionalità non è disponibile per i cluster del piano di controllo Cloud.

A seconda del tipo di deployment, gli upgrade del software Distributed Cloud connesso vengono eseguiti come segue:

Per i deployment di server Distributed Cloud connected e i deployment di rack Distributed Cloud connected che utilizzano un rack per zona, i nodi di una zona vengono aggiornati e riavviati uno alla volta.
Per le implementazioni di rack Distributed Cloud connected che utilizzano più rack per zona, tutti i nodi della zona vengono aggiornati contemporaneamente.

Per completare questa attività, devi disporre del ruolo Amministratore container edge (roles/edgecontainer.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud container clusters upgrade:

gcloud edge-cloud container clusters upgrade CLUSTER_ID \
   --location=REGION \
   --project=PROJECT_ID \
   --schedule=UPGRADE_SCHEDULE \
   --version=SOFTWARE_VERSION

Sostituisci quanto segue:

CLUSTER_ID: il nome del cluster di destinazione.
REGION: la Google Cloud regione in cui è stato creato il cluster Distributed Cloud di destinazione.
PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
UPGRADE_SCHEDULE: specifica quando attivare l'upgrade software. L'unico valore valido è IMMEDIATELY.
SOFTWARE_VERSION: specifica la versione del software Distributed Cloud che vuoi che questo cluster esegua nel formato 1.X.Y, dove X è la versione secondaria e Y è la versione della patch, ad esempio 1.5.1. Per ottenere le versioni del software disponibili per la creazione del cluster, inclusa la versione predefinita del server, consulta Ottenere le versioni del software disponibili per un cluster.

API

Invia una richiesta POST al metodo projects.locations.clusters.upgrade:

POST /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID:upgrade?requestId=REQUEST_ID
{
  "name": "projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID",
  "targetVersion": "SOFTWARE_VERSION",
    "schedule": "UPGRADE_SCHEDULE",
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.
CLUSTER_ID: il nome del cluster di destinazione.
REQUEST_ID: un ID programmatico univoco che identifica questa richiesta.
UPGRADE_SCHEDULE: specifica quando attivare l'upgrade software. L'unico valore valido è IMMEDIATELY.
SOFTWARE_VERSION: specifica la versione del software Distributed Cloud (connesso) che vuoi che questo cluster esegua nel formato 1.X.Y, dove X è la versione secondaria e Y è la versione patch, ad esempio 1.5.1. Per ottenere le versioni del software disponibili per la creazione del cluster, inclusa la versione predefinita del server, consulta Ottenere le versioni del software disponibili per un cluster.

In genere, un upgrade software richiede circa 2 ore per ogni nodo che fa parte del pool di nodi del cluster. Il comando restituisce un'operazione che consente di monitorare l'avanzamento dell'upgrade software. Mentre l'upgrade del software è in corso, lo stato del cluster è impostato su Reconciling e torna a Running al termine dell'upgrade. Lo stato del cluster Error indica che l'upgrade del software non è riuscito. In questi casi, esegui di nuovo la procedura di upgrade. Per informazioni su come controllare lo stato del cluster, consulta Ottenere informazioni su un cluster.

Ottenere le credenziali per un cluster

Per ottenere le credenziali per un cluster connesso Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Visualizzatore container edge (roles/edgecontainer.viewer) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud container clusters get-credentials:

gcloud edge-cloud container clusters get-credentials CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Sostituisci quanto segue:

CLUSTER_ID: il nome del cluster di destinazione.
PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.

API

Invia una richiesta GET al metodo projects.locations.clusters:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui viene creata la zona Distributed Cloud di destinazione.
CLUSTER_ID: il nome del cluster di destinazione.

Configura un periodo di manutenzione per un cluster

Questa sezione descrive come specificare una periodo di manutenzione e come cancellarla per un cluster connesso Distributed Cloud.

Specifica un periodo di manutenzione per un cluster

Per specificare una periodo di manutenzione per un cluster connesso a Distributed Cloud, completa i passaggi descritti in questa sezione. Per maggiori informazioni sulla manutenzione del cluster, vedi Informazioni su aggiornamenti software e periodi di manutenzione.

Per i formati di data e ora, utilizza RFC 5545.

Per completare questa attività, devi disporre del ruolo Amministratore container edge (roles/edgecontainer.admin) nel tuo progetto Google Cloud .

Console

Se utilizzi la console Google Cloud , puoi specificare una periodo di manutenzione solo quando crei un cluster. Per specificare una periodo di manutenzione su un cluster esistente, devi utilizzare la Google Cloud CLI o l'API Distributed Cloud Edge Container connessa.

gcloud

Utilizza il comando gcloud edge-cloud container clusters update:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --maintenance-window-start=MAINTENANCE_START \
    --maintenance-window-end=MAINTENANCE_END \
    --maintenance-window-recurrence=MAINTENANCE_FREQUENCY

Sostituisci quanto segue:

CLUSTER_ID: il nome del cluster di destinazione.
PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la Google Cloud regione in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.
MAINTENANCE_START: l'ora di inizio del periodo di manutenzione nel formato YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END: l'ora di fine del periodo di manutenzione nel formato YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY: la frequenza della finestra di manutenzione nel formato FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
- BYDAY: un elenco delimitato da virgole dei giorni durante i quali può verificarsi la manutenzione se FREQ è impostato su WEEKLY. Se ometti il parametro BYDAY, Google sceglie il giorno della settimana per te.
- Se imposti FREQ su giornaliero, i periodi di manutenzione si verificano ogni giorno durante le ore specificate.

API

Invia una richiesta PATCH al metodo projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": {
   "window": {
     "recurring_window": {
       "window": {
         "start_time": "MAINTENANCE_START",
         "end_time": "MAINTENANCE_END"
         },
       "recurrence": "MAINTENANCE_FREQUENCY"
     }
   }
 }
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la Google Cloud regione in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.
CLUSTER_ID: il nome del cluster di destinazione.
UPDATE_MASK: un elenco separato da virgole di nomi di campi completi da aggiornare in questa richiesta nel formato FieldMask.
REQUEST_ID: un ID programmatico univoco che identifica questa richiesta.
CLUSTER_ID: il nome del cluster di destinazione.
USERNAME: il nome dell'account utente all'interno del progetto Google Cloud di destinazione autorizzato a modificare le risorse del cluster.
MAINTENANCE_START: l'ora di inizio del periodo di manutenzione nel formato YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END: l'ora di fine del periodo di manutenzione nel formato YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY: la frequenza della finestra di manutenzione nel formato FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
- FREQ può essere DAILY o WEEKLY.
- BYDAY: un elenco delimitato da virgole dei giorni durante i quali può verificarsi la manutenzione se FREQ è impostato su WEEKLY. Se ometti il parametro BYDAY, Google sceglie il giorno della settimana per te.
- Se imposti FREQ su giornaliero, i periodi di manutenzione si verificano ogni giorno durante le ore specificate.

Per saperne di più, consulta Risorsa: cluster.

Cancella il periodo di manutenzione per un cluster

Per cancellare la periodo di manutenzione per un cluster connesso a Distributed Cloud, completa i passaggi descritti in questa sezione. Per maggiori informazioni sulla manutenzione del cluster, vedi Informazioni su aggiornamenti software e periodi di manutenzione.

Per completare questa attività, devi disporre del ruolo Amministratore container edge (roles/edgecontainer.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud container clusters update:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --clear-maintenance-window

Sostituisci quanto segue:

CLUSTER_ID: il nome del cluster di destinazione.
PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui viene creato il cluster Distributed Cloud di destinazione.

API

Invia una richiesta PATCH al metodo projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": null
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la Google Cloud regione in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.
CLUSTER_ID: il nome del cluster di destinazione.
UPDATE_MASK: un elenco separato da virgole di nomi di campi completi da aggiornare in questa richiesta nel formato FieldMask.
REQUEST_ID: un ID programmatico univoco che identifica questa richiesta.
USERNAME: il nome dell'account utente all'interno del progetto Google Cloud di destinazione autorizzato a modificare le risorse del cluster.

Per saperne di più, consulta Risorsa: cluster.

Elimina un cluster

Per eliminare un cluster connesso a Distributed Cloud, completa i passaggi in questa sezione. Prima di poter eliminare un cluster, devi prima eseguire le seguenti operazioni:

Per completare questa attività, devi disporre del ruolo Amministratore container edge (roles/edgecontainer.admin) nel tuo progetto Google Cloud .

gcloud

Utilizza il comando gcloud edge-cloud container clusters delete:

gcloud edge-cloud container clusters delete CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Sostituisci quanto segue:

CLUSTER_ID: il nome del cluster di destinazione.
PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.

API

Invia una richiesta DELETE al metodo projects.locations.clusters.delete:

DELETE /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?requestId=REQUEST_ID

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto Google Cloud di destinazione.
REGION: la regione Google Cloud in cui viene creato il cluster Google Distributed Cloud connesso di destinazione.
CLUSTER_ID: il nome del cluster di destinazione.
REQUEST_ID: un ID programmatico univoco che identifica questa richiesta.

Crea e gestisci i cluster Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Crea un cluster

Console

gcloud

API

Elenca i cluster in una regione

Console

gcloud

API

Recuperare informazioni su un cluster

Console

gcloud

API

Recupera le versioni software disponibili per un cluster

gcloud

API

Esegui l'upgrade della versione software di un cluster del control plane locale

gcloud

API

Ottenere le credenziali per un cluster

gcloud

API

Configura un periodo di manutenzione per un cluster

Specifica un periodo di manutenzione per un cluster

Console

gcloud

API

Cancella il periodo di manutenzione per un cluster

gcloud

API

Elimina un cluster

gcloud

API

Passaggi successivi

Crea e gestisci i cluster