Créer et gérer des pools de nœuds

Cette page explique comment créer et gérer des ressources de pool de nœuds Google Distributed Cloud dans une zone connectée Distributed Cloud.

Sur les serveurs connectés Distributed Cloud, les pools de nœuds sont créés et remplis automatiquement lorsque vous créez un cluster. Vous pouvez également configurer des pools de nœuds supplémentaires après avoir créé le cluster.

Pour en savoir plus sur les pools de nœuds Distributed Cloud, consultez Fonctionnement de Distributed Cloud connected.

Remarque : Les instructions Google Cloud CLI de cette page supposent que vous utilisez Cloud Shell ou un autre environnement avec bash installé.

Créer un pool de nœuds

Pour créer un pool de nœuds Distributed Cloud, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer des rôles suivants dans votre projetGoogle Cloud  :

• Rôle "Administrateur Edge Container" (roles/edgecontainer.admin)

• Rôle Utilisateur de machine Edge Container (roles/edgecontainer.machineUser)

  Vous devez également disposer de ce rôle dans le projet Google Cloud qui contient les machines connectées Distributed Cloud qui seront attribuées à ce pool de nœuds si ce projet est différent du projetGoogle Cloud dans lequel vous créez le pool de nœuds.

Console

Si vous utilisez la console Google Cloud , vous ne pouvez créer un pool de nœuds que lorsque vous créez un cluster. Pour créer un pool de nœuds autonome, vous devez utiliser Google Cloud CLI ou l'API Distributed Cloud Edge Container.

gcloud

Exécutez la commande 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

Remplacez les éléments suivants :

• POOL_NAME : nom descriptif qui identifie de manière unique ce pool de nœuds. Ce nom doit être conforme à la norme RFC 1213 et ne contenir que des caractères alphanumériques minuscules et des traits d'union (-). Il doit commencer et se terminer par un caractère alphanumérique.
• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster Distributed Cloud connecté cible pour ce pool de nœuds est hébergé.
• CLUSTER_NAME : nom du cluster connecté Distributed Cloud cible.
• ZONE_NAME : nom de la zone Distributed Cloud cible. Cette zone doit se trouver dans la région spécifiée dans REGION.
• NODE_COUNT : nombre de nœuds que contient ce pool de nœuds.
• NODE_LABELS : liste de paires clé/valeur séparées par une virgule qui constituent les libellés des nœuds individuels du pool de nœuds.
• MACHINE_FILTER (facultatif) : spécifie les critères de filtrage pour la sélection de la machine. Pour afficher les champs selon lesquels vous pouvez filtrer, consultez Obtenir des informations sur une machine. Seules les machines correspondant à ce filtre peuvent rejoindre ce pool de nœuds. Pour les clusters multiracks, utilisez cet indicateur pour spécifier les racks Distributed Cloud connectés dont les nœuds composent ce pool de nœuds. Si cette option est omise, tous les nœuds disponibles dans la zone sont ajoutés à ce pool de nœuds.

• POOL_KMS_KEY (facultatif) : chemin d'accès complet à la clé Cloud KMS que vous souhaitez utiliser avec ce pool de nœuds. Exemple :

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

  Cet indicateur ne s'applique que si vous avez intégré Distributed Cloud connecté à Cloud Key Management Service, comme décrit dans Activer la compatibilité avec les clés de chiffrement gérées par le client (CMEK) pour le stockage local.

• WORKER_NODE_STORAGE_SCHEMA (facultatif) : spécifie le schéma de stockage local pour les nœuds de calcul inclus dans ce pool de nœuds. Pour en savoir plus, consultez Configurer des schémas de stockage local.

API

Envoyez une requête POST à la méthode 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,
  }
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster Distributed Cloud connecté cible pour ce pool de nœuds est hébergé.
• CLUSTER_NAME : nom du cluster connecté Distributed Cloud cible.
• NODEPOOL_ID : ID programmatique unique qui identifie cette ressource de pool de nœuds.
• REQUEST_ID : ID programmatique unique qui identifie cette requête.
• POOL_NAME : nom descriptif qui identifie de manière unique ce pool de nœuds.
• LABELS : liste des libellés à appliquer à cette ressource de pool de nœuds.
• ZONE_NAME : nom de la zone connectée Distributed Cloud cible. Cette zone doit se trouver dans la région spécifiée dans REGION.
• NODE_COUNT : nombre de nœuds que contient ce pool de nœuds.
• NODE_LABELS : liste de paires clé/valeur séparées par une virgule qui constituent les libellés des nœuds individuels du pool de nœuds.
• MACHINE_FILTER (facultatif) : spécifie les critères de filtrage pour la sélection de la machine. Seules les machines correspondant à ce filtre peuvent rejoindre ce pool de nœuds. Pour les clusters multiracks, utilisez cet indicateur pour spécifier les racks connectés Distributed Cloud dont les nœuds composent ce pool de nœuds. Si cette option est omise, tous les nœuds disponibles dans la zone sont ajoutés à ce pool de nœuds.

• POOL_KMS_KEY (facultatif) : chemin d'accès complet à la clé Cloud KMS que vous souhaitez utiliser avec ce pool de nœuds. Exemple :

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

  Ce paramètre ne s'applique que si vous avez intégré Distributed Cloud connecté à Cloud Key Management Service, comme décrit dans Activer la compatibilité avec les clés de chiffrement gérées par le client (CMEK) pour le stockage local.

Répertorier les pools de nœuds

Pour lister les pools de nœuds Distributed Cloud disponibles dans une zone connectée Distributed Cloud, suivez les étapes de cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Lecteur Edge Container (roles/edgecontainer.viewer) dans votre projet Google Cloud .

gcloud

Exécutez la commande gcloud edge-cloud container clusters node-pools list :

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

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster Distributed Cloud connecté cible a été créé.
• CLUSTER_NAME : nom du cluster connecté Distributed Cloud cible.

API

Envoyez une requête GET à la méthode 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

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster connecté Distributed Cloud cible a été créé.
• CLUSTER_NAME : nom du cluster Distributed Cloud cible.
• FILTER : expression qui limite les résultats renvoyés à des valeurs spécifiques.
• PAGE_SIZE : nombre de résultats à renvoyer par page.
• SORT_BY : liste de noms de champs séparés par une virgule selon lesquels les résultats renvoyés sont triés. L'ordre de tri par défaut est croissant. Pour un ordre décroissant, ajoutez le préfixe ~ au champ souhaité.
• PAGE_TOKEN : jeton reçu en réponse à la dernière requête de liste dans le champ nextPageToken de la réponse. Envoyez ce jeton pour recevoir une page de résultats.

Obtenir des informations sur un pool de nœuds

Pour obtenir des informations sur un pool de nœuds Distributed Cloud, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Lecteur Edge Container (roles/edgecontainer.viewer) dans votre projet Google Cloud .

gcloud

Exécutez la commande 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

Remplacez les éléments suivants :

• POOL_NAME : nom du pool de nœuds cible.
• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster Cloud distribué connecté associé à ce pool de nœuds est hébergé.
• CLUSTER_NAME : nom du cluster connecté Distributed Cloud cible.

API

Envoyez une requête GET à la méthode projects.locations.clusters.nodePools.get :

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

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster Cloud distribué connecté associé à ce pool de nœuds est hébergé.
• CLUSTER_NAME : nom du cluster connecté Distributed Cloud cible.
• POOL_NAME : nom du pool de nœuds cible.

Modifier un pool de nœuds

Pour modifier un pool de nœuds Distributed Cloud, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle d'administrateur de conteneurs Edge (roles/edgecontainer.admin) dans votre projet Google Cloud .

gcloud

Exécutez la commande 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

Remplacez les éléments suivants :

• POOL_NAME : nom du pool de nœuds cible.
• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster Cloud distribué connecté associé à ce pool de nœuds est hébergé.
• CLUSTER_NAME : nom du cluster connecté Distributed Cloud cible.
• NODE_COUNT : nombre de nœuds que contient ce pool de nœuds.
• MACHINE_FILTER (facultatif) : spécifie les critères de filtrage pour la sélection de la machine. Pour afficher les champs selon lesquels vous pouvez filtrer, consultez Obtenir des informations sur une machine. Pour les clusters multiracks, utilisez cet indicateur pour spécifier les racks connectés Distributed Cloud dont les nœuds composent ce pool de nœuds.

• POOL_KMS_KEY (facultatif) : chemin d'accès complet à la clé Cloud KMS que vous souhaitez utiliser avec ce pool de nœuds. Exemple :

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

  Cet indicateur ne s'applique que si vous avez intégré Distributed Cloud connecté à Cloud Key Management Service, comme décrit dans Activer la compatibilité avec les clés de chiffrement gérées par le client (CMEK) pour le stockage local.

  Pour rétablir un pool de nœuds afin qu'il utilise un Google-owned and Google-managed encryption key, utilisez l'option --use-google-managed-key.

API

Envoyez une requête PATCH à la méthode 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,
  }
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster Cloud distribué connecté associé à ce pool de nœuds est hébergé.
• CLUSTER_NAME : nom du cluster connecté Distributed Cloud cible.
• NODEPOOL_ID : ID programmatique unique qui identifie ce pool de nœuds.
• REQUEST_ID : ID programmatique unique qui identifie cette requête.
• POOL_NAME : nom descriptif qui identifie de manière unique ce pool de nœuds.
• LABELS : liste des libellés à appliquer à cette ressource de pool de nœuds.
• ZONE_NAME : nom de la zone connectée Distributed Cloud cible. Cette zone doit se trouver dans la région spécifiée dans REGION.
• NODE_COUNT : nombre de nœuds que contient ce pool de nœuds.
• MACHINE_FILTER (facultatif) : spécifie les critères de filtrage pour la sélection de la machine. Seules les machines correspondant à ce filtre peuvent rejoindre ce pool de nœuds. Pour les clusters multiracks, utilisez cet indicateur pour spécifier les racks connectés Distributed Cloud dont les nœuds composent ce pool de nœuds.

• KMS_KEY (facultatif) : chemin d'accès complet à la clé Cloud KMS que vous souhaitez utiliser avec ce pool de nœuds. Exemple :

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

  Ce paramètre ne s'applique que si vous avez intégré Distributed Cloud connecté à Cloud Key Management Service, comme décrit dans Activer la compatibilité avec les clés de chiffrement gérées par le client (CMEK) pour le stockage local.

Supprimer un pool de nœuds

Pour supprimer un pool de nœuds Distributed Cloud, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle d'administrateur de conteneurs Edge (roles/edgecontainer.admin) dans votre projet Google Cloud .

gcloud

Exécutez la commande 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

Remplacez les éléments suivants :

• POOL_NAME : nom du pool de nœuds cible.
• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster Cloud distribué connecté associé à ce pool de nœuds est hébergé.
• CLUSTER_NAME : nom du cluster connecté Distributed Cloud cible.

API

Envoyez une requête DELETE à la méthode projects.locations.clusters.nodePools.delete :

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

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet Google Cloud cible.
• REGION : région Google Cloud dans laquelle le cluster Cloud distribué connecté associé à ce pool de nœuds est hébergé.
• CLUSTER_NAME : nom du cluster connecté Distributed Cloud cible.
• POOL_NAME : nom du pool de nœuds cible.
• REQUEST_ID : ID programmatique unique qui identifie cette requête.

Étapes suivantes

• Déployer des charges de travail sur Distributed Cloud connecté
• Gérer les zones
• Gérer les machines
• Créer et gérer des clusters
• Créer et gérer des connexions VPN
• Gérer les machines virtuelles
• Gérer les charges de travail GPU