Creazione e gestione dei pool di nodi

Questa pagina descrive come creare e gestire le risorse del pool di nodi di Google Distributed Cloud in una zona Distributed Cloud connected.

Sui server Distributed Cloud connected, i pool di nodi vengono creati e popolati automaticamente quando crei un cluster. Hai anche la possibilità di configurare pool di nodi aggiuntivi dopo aver creato il cluster.

Per saperne di più sui pool di nodi Distributed Cloud, consulta Come funziona Distributed Cloud connected.

Crea un pool di nodi

Per creare un pool di nodi Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre dei seguenti ruoli nel tuo Google Cloud progetto:

  • Ruolo Edge Container Admin (roles/edgecontainer.admin)

  • Ruolo Edge Container Machine User (roles/edgecontainer.machineUser)

    Devi disporre di questo ruolo anche nel Google Cloud progetto che contiene le macchine Distributed Cloud connected che verranno assegnate a questo pool di nodi, se il progetto è diverso da quello in cui stai creando il Google Cloud pool di nodi.

Console

Se utilizzi la Google Cloud console, puoi creare un pool di nodi solo quando crei un cluster. Per creare un pool di nodi autonomo, devi utilizzare Google Cloud CLI o l'API Edge Container di Distributed Cloud.

gcloud

Utilizza il comando gcloud edge-cloud container clusters node-pools create:

gcloud edge-cloud container clusters node-pools create POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-location=ZONE_NAME \
    --node-count=NODE_COUNT \
    --node-labels=NODE_LABELS \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY \
    --node-storage-schema=WORKER_NODE_STORAGE_SCHEMA

Sostituisci quanto segue:

  • POOL_NAME: un nome descrittivo che identifica in modo univoco questo pool di nodi. 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 di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected di destinazione per questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud connected di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione. Questa zona deve trovarsi nella regione specificata in REGION.
  • NODE_COUNT: il numero di nodi contenuti in questo pool di nodi.
  • NODE_LABELS: un elenco delimitato da virgole di coppie chiave-valore che comprendono le etichette per i singoli nodi nel pool di nodi.
  • MACHINE_FILTER (facoltativo): specifica i criteri di filtro per la selezione della macchina. Per visualizzare i campi in base ai quali puoi filtrare, consulta Visualizza informazioni su una macchina. Solo le macchine che corrispondono a questo filtro possono unirsi a questo pool di nodi. Per i cluster multi-rack, utilizza questo flag per specificare i rack Distributed Cloud connected i cui nodi comprendono questo pool di nodi. Se omesso, tutti i nodi disponibili nella zona vengono aggiunti a questo pool di nodi.

  • POOL_KMS_KEY (facoltativo): il percorso completo della chiave Cloud KMS che vuoi utilizzare con questo pool di nodi. Ad esempio:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    Questo flag si applica solo se hai integrato Distributed Cloud connected con Cloud Key Management Service come descritto in Abilita il supporto per le chiavi di crittografia gestite dal cliente (CMEK) per l'archiviazione locale.

  • WORKER_NODE_STORAGE_SCHEMA (facoltativo): specifica lo schema di archiviazione locale per i nodi worker inclusi in questo pool di nodi. Per saperne di più, consulta Configura gli schemi di archiviazione locale.

API

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

POST /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,
 "nodeLabels": NODE_LABELS,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": POOL_KMS_KEY,
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected di destinazione per questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud connected di destinazione.
  • NODEPOOL_ID: un ID programmatico univoco che identifica questa risorsa del pool di nodi.
  • REQUEST_ID: un ID programmatico univoco che identifica questa richiesta.
  • POOL_NAME: un nome descrittivo che identifica in modo univoco questo pool di nodi.
  • LABELS: un elenco di etichette da applicare a questa risorsa del pool di nodi.
  • ZONE_NAME: il nome della zona Distributed Cloud connected di destinazione. Questa zona deve trovarsi nella regione specificata in REGION.
  • NODE_COUNT: il numero di nodi contenuti in questo pool di nodi.
  • NODE_LABELS: un elenco delimitato da virgole di coppie chiave-valore che comprendono le etichette per i singoli nodi nel pool di nodi.
  • MACHINE_FILTER (facoltativo): specifica i criteri di filtro per la selezione della macchina. Solo le macchine che corrispondono a questo filtro possono unirsi a questo pool di nodi. Per i cluster multi-rack, utilizza questo flag per specificare i rack Distributed Cloud connected i cui nodi comprendono questo pool di nodi. Se omesso, tutti i nodi disponibili nella zona vengono aggiunti a questo pool di nodi.

  • POOL_KMS_KEY (facoltativo): il percorso completo della chiave Cloud KMS che vuoi utilizzare con questo pool di nodi. Ad esempio:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    Questo parametro si applica solo se hai integrato Distributed Cloud connected con Cloud Key Management Service come descritto in Abilita il supporto per le chiavi di crittografia gestite dal cliente (CMEK) per l'archiviazione locale.

Elenca node pool

Per elencare i pool di nodi Distributed Cloud disponibili in una zona Distributed Cloud connected, completa i passaggi descritti in questa sezione.

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

gcloud

Utilizza il comando gcloud edge-cloud container clusters node-pools list:

gcloud edge-cloud container clusters node-pools list \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è stato creato il cluster Distributed Cloud connected di destinazione.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud connected di destinazione.

API

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

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è stato creato il cluster Distributed Cloud connected di destinazione.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud 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, anteponi il campo desiderato con ~.
  • 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.

Visualizza informazioni su un pool di nodi

Per visualizzare informazioni su un pool di nodi Distributed Cloud, completa i passaggi descritti in questa sezione.

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

gcloud

Utilizza il comando gcloud edge-cloud container clusters node-pools describe:

gcloud edge-cloud container clusters node-pools describe POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Sostituisci quanto segue:

  • POOL_NAME: il nome del pool di nodi di destinazione.
  • PROJECT_ID: l'ID del progetto di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud connected di destinazione.

API

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

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud connected di destinazione.
  • POOL_NAME: il nome del pool di nodi di destinazione.

Modifica un pool di nodi

Per modificare un pool di nodi Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Edge Container Admin (roles/edgecontainer.admin) nel tuo Google Cloud progetto.

gcloud

Utilizza il comando gcloud edge-cloud container clusters node-pools update:

gcloud edge-cloud container clusters node-pools update POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-count=NODE_COUNT \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY

Sostituisci quanto segue:

  • POOL_NAME: il nome del pool di nodi di destinazione.
  • PROJECT_ID: l'ID del progetto di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud connected di destinazione.
  • NODE_COUNT: il numero di nodi contenuti in questo pool di nodi.
  • MACHINE_FILTER (facoltativo): specifica i criteri di filtro per la selezione della macchina. Per visualizzare i campi in base ai quali puoi filtrare, consulta Visualizza informazioni su una macchina. Per i cluster multi-rack, utilizza questo flag per specificare i rack Distributed Cloud connected i cui nodi comprendono questo pool di nodi.

  • POOL_KMS_KEY (facoltativo): il percorso completo della chiave Cloud KMS che vuoi utilizzare con questo pool di nodi. Ad esempio:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    Questo flag si applica solo se hai integrato Distributed Cloud connected con Cloud Key Management Service come descritto in Abilita il supporto per le chiavi di crittografia gestite dal cliente (CMEK) per l'archiviazione locale.

    Per ripristinare l'utilizzo di una chiave di crittografia gestita da Google per un pool di nodi, utilizza il Google-owned and Google-managed encryption keyflag.--use-google-managed-key

API

Invia una richiesta PATCH al metodo projects.locations.clusters.nodePools.patch:

PATCH /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": KMS_KEY,
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud connected di destinazione.
  • NODEPOOL_ID: un ID programmatico univoco che identifica questo pool di nodi.
  • REQUEST_ID: un ID programmatico univoco che identifica questa richiesta.
  • POOL_NAME: un nome descrittivo che identifica in modo univoco questo pool di nodi.
  • LABELS: un elenco di etichette da applicare a questa risorsa del pool di nodi.
  • ZONE_NAME: il nome della zona Distributed Cloud connected di destinazione. Questa zona deve trovarsi nella regione specificata in REGION.
  • NODE_COUNT: il numero di nodi contenuti in questo pool di nodi.
  • MACHINE_FILTER (facoltativo): specifica i criteri di filtro per la selezione della macchina. Solo le macchine che corrispondono a questo filtro possono unirsi a questo pool di nodi. Per i cluster multi-rack, utilizza questo flag per specificare i rack Distributed Cloud connected i cui nodi comprendono questo pool di nodi.

  • KMS_KEY (facoltativo): il percorso completo della chiave Cloud KMS che vuoi utilizzare con questo pool di nodi. Ad esempio:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    Questo parametro si applica solo se hai integrato Distributed Cloud connected con Cloud Key Management Service come descritto in Abilita il supporto per le chiavi di crittografia gestite dal cliente (CMEK) per l'archiviazione locale.

Elimina un pool di nodi

Per eliminare un pool di nodi Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Edge Container Admin (roles/edgecontainer.admin) nel tuo Google Cloud progetto.

gcloud

Utilizza il comando gcloud edge-cloud container clusters node-pools delete:

gcloud edge-cloud container clusters node-pools delete POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Sostituisci quanto segue:

  • POOL_NAME: il nome del pool di nodi di destinazione.
  • PROJECT_ID: l'ID del progetto di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud connected di destinazione.

API

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

DELETE /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME?requestId=REQUEST_ID

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione. Google Cloud
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Distributed Cloud connected di destinazione.
  • POOL_NAME: il nome del pool di nodi di destinazione.
  • REQUEST_ID: un ID programmatico univoco che identifica questa richiesta.

Passaggi successivi