Creazione e gestione dei pool di nodi

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

Sui server connessi a Distributed Cloud, i pool di nodi vengono creati e compilati automaticamente quando crei un cluster. Hai anche la possibilità di configurare altri node pool dopo aver creato il cluster.

Per saperne di più sui node pool Distributed Cloud, consulta la pagina Come funziona Distributed Cloud connesso.

Crea un node pool

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

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

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

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

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

Console

Se utilizzi la console Google Cloud , 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 questopool di nodil. 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 è ospitato il cluster Distributed Cloud connesso di destinazione per questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Google Distributed Cloud (connesso) 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, vedi Ottenere informazioni su una macchina. Solo le macchine che corrispondono a questo filtro possono unirsi a questo pool di nodi. Per i cluster multirack, utilizza questo flag per specificare i rack Distributed Cloud connessi i cui nodi compongono 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 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.

  • 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 Google Cloud di destinazione.
  • REGION: la regione Google Cloud in cui è ospitato il cluster Distributed Cloud connesso di destinazione per questo pool di nodi.
  • CLUSTER_NAME: il nome del cluster Google Distributed Cloud (connesso) 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 questopool di nodil.
  • LABELS: un elenco di etichette da applicare a questa risorsa delpool di nodil.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa 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 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.

Elenca node pool

Per elencare i node pool Distributed Cloud disponibili in una zona connessa 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 .

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 Google Cloud di destinazione.
  • REGION: la regione Google Cloud in cui è stato creato il cluster Distributed Cloud connesso di destinazione.
  • CLUSTER_NAME: il nome del cluster Google Distributed Cloud (connesso) 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 Google Cloud di destinazione.
  • REGION: la regione Google Cloud in cui è stato creato il cluster Google Distributed Cloud connesso 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, 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 pool di nodi

Per ottenere informazioni su un pool di nodi 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 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 Google Cloud di destinazione.
  • REGION: la Google Cloud regione in cui è ospitato il cluster Google Distributed Cloud connesso associato a questo node pool.
  • CLUSTER_NAME: il nome del cluster Google Distributed Cloud (connesso) 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 Google Cloud di destinazione.
  • REGION: la Google Cloud regione in cui è ospitato il cluster Google Distributed Cloud connesso associato a questo node pool.
  • CLUSTER_NAME: il nome del cluster Google Distributed Cloud (connesso) 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 in questa sezione.

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 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 Google Cloud di destinazione.
  • REGION: la Google Cloud regione in cui è ospitato il cluster Google Distributed Cloud connesso associato a questo node pool.
  • CLUSTER_NAME: il nome del cluster Google Distributed Cloud (connesso) 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 Ottenere informazioni su una macchina. Per i cluster multirack, utilizza questo flag per specificare i rack connessi di Distributed Cloud 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 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.

    Per ripristinare l'utilizzo di una chiave gestita da Google per un pool di nodi, utilizza il flag --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 Google Cloud di destinazione.
  • REGION: la Google Cloud regione in cui è ospitato il cluster Google Distributed Cloud connesso associato a questo node pool.
  • CLUSTER_NAME: il nome del cluster Google Distributed Cloud (connesso) 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 questopool di nodil.
  • LABELS: un elenco di etichette da applicare a questa risorsa delpool di nodil.
  • ZONE_NAME: il nome della zona Distributed Cloud connessa 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 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.

Elimina un node pool

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

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 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 Google Cloud di destinazione.
  • REGION: la Google Cloud regione in cui è ospitato il cluster Google Distributed Cloud connesso associato a questo node pool.
  • CLUSTER_NAME: il nome del cluster Google Distributed Cloud (connesso) 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 Google Cloud di destinazione.
  • REGION: la Google Cloud regione in cui è ospitato il cluster Google Distributed Cloud connesso associato a questo node pool.
  • CLUSTER_NAME: il nome del cluster Google Distributed Cloud (connesso) di destinazione.
  • POOL_NAME: il nome del pool di nodi di destinazione.
  • REQUEST_ID: un ID programmatico univoco che identifica questa richiesta.

Passaggi successivi