Creazione e gestione dei pool di nodi

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

I pool di nodi vengono creati e compilati 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 di Distributed Cloud, vedi Come funziona Distributed Cloud connected.

Crea un pool di nodi

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

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

  • Ruolo Amministratore container Edge (roles/edgecontainer.admin)

  • Ruolo Utente macchina container Edge (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 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 Distributed Cloud Edge Container.

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 delprogetto 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 separato 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, vedi Ottieni 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 Abilitare 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 Configurare 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 delprogetto 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 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 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 separato 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 Abilitare il supporto per le chiavi di crittografia gestite dal cliente (CMEK) per l'archiviazione locale.

Elenca node pool

Per elencare i node pool di 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 container Edge (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 delprogetto 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 delprogetto 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 separato 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.

Ottieni informazioni su un pool di nodi

Per ottenere informazioni su un pool di nodi di 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 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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo node pool.
  • 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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo node pool.
  • 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 di Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Amministratore container Edge (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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo node pool.
  • 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, vedi Ottieni 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 Abilitare il supporto per le chiavi di crittografia gestite dal cliente (CMEK) per l'archiviazione locale.

    Per ripristinare un pool di nodi in modo che utilizzi una Google-owned and Google-managed encryption key, utilizza il --use-google-managed-key flag.

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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo node pool.
  • 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 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 Abilitare 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 di Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi disporre del ruolo Amministratore container Edge (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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo node pool.
  • 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 delprogetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione in cui è ospitato il cluster Distributed Cloud connected associato a questo node pool.
  • 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