Pour en savoir plus sur les versions, consultez les notes de version de Distributed Cloud connecté.

Créer et gérer des clusters

Cette page explique comment créer et gérer des ressources de cluster connecté Google Distributed Cloud.

Pour en savoir plus sur les clusters connectés Distributed Cloud, consultez Fonctionnement de Distributed Cloud connected.

Les serveurs connectés Distributed Cloud et les déploiements multiracks de Distributed Cloud connecté, dans lesquels un rack de base agrège les ressources d'un ou de plusieurs racks autonomes, ne sont compatibles qu'avec les clusters de plan de contrôle local. Vous ne pouvez pas créer de clusters de plan de contrôle Cloud sur ces types de déploiement.

Créer un cluster

Pour créer un cluster connecté Distributed Cloud, suivez les étapes décrites dans cette section. La création d'un cluster est l'une des nombreuses étapes requises pour déployer une charge de travail sur Distributed Cloud Connected.

Pour créer un cluster avec un plan de contrôle local capable d'exécuter des charges de travail lorsqu'il est temporairement déconnecté de Google Cloud, commencez par lire Mode de survie.

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

Console

Dans la console Google Cloud , accédez à la page Clusters.

accéder aux clusters
Cliquez sur Créer un cluster.
Sur la page Créer un cluster, cliquez sur l'onglet Sur site.
À côté de l'option Distributed Cloud Edge, cliquez sur Configurer.
Sur la page Paramètres de base du cluster, fournissez les informations suivantes :
- Name (Nom) : nom unique qui identifie ce cluster. 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.
- Emplacement : région Google Cloud dans laquelle vous souhaitez créer ce cluster.
- Nombre maximal de pods par nœud par défaut : nombre maximal de pods Kubernetes à exécuter sur chaque nœud de ce cluster.
- Libellés : vous permet d'ajouter un ou plusieurs libellés à ce cluster en cliquant sur Ajouter un libellé.
Dans le volet de navigation de gauche, cliquez sur Mise en réseau.
Sur la page Mise en réseau, fournissez les informations suivantes :
- Plage d'adresses de pods par défaut du cluster : bloc CIDR IPv4 souhaité pour les pods Kubernetes exécutés sur ce cluster.
- Plage d'adresses de service : bloc CIDR IPv4 souhaité pour les services Kubernetes exécutés sur ce cluster.
Pour en savoir plus, consultez Allocation d'adresses réseau pour les pods et services Distributed Cloud.
Dans le volet de navigation de gauche, cliquez sur Autorisation.
Sur la page Autorisation, indiquez le nom du compte utilisateur dans le projet Google Cloud cible autorisé à modifier les ressources du cluster.
Dans le volet de navigation de gauche, cliquez sur Conditions de maintenance.

Avertissement : Un cluster connecté Distributed Cloud ne dispose pas d'intervalle de maintenance par défaut. Cela signifie qu'une mise à jour logicielle peut potentiellement entraîner l'arrêt d'une charge de travail critique. Pour garantir la haute disponibilité, vous devez configurer des périodes de maintenance échelonnées pour vos clusters Distributed Cloud afin que les mises à jour logicielles se produisent à des moments différents et que vos charges de travail restent disponibles.
Sur la page Règle de maintenance, fournissez les informations suivantes :
- Activer l'intervalle de maintenance : cochez cette case pour configurer un intervalle de maintenance pour le cluster. Pour éviter les temps d'arrêt inattendus causés par les mises à jour logicielles connectées à Distributed Cloud, nous vous recommandons vivement de toujours configurer une période de maintenance pour chaque cluster Distributed Cloud que vous créez. Pour en savoir plus, consultez Comprendre les mises à jour logicielles et les intervalles de maintenance.
- Heure de début : date et heure souhaitées pour le début de l'intervalle de maintenance de ce cluster.
- Heure de fin : date et heure souhaitées auxquelles la période de maintenance de ce cluster se termine.
- RRule : fréquence de l'intervalle de maintenance au format FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU :
  - FREQ peut être DAILY ou WEEKLY.
  - BYDAY : liste des jours pendant lesquels la maintenance peut avoir lieu si FREQ est défini sur WEEKLY. Si vous omettez le paramètre BYDAY, Google choisit le jour de la semaine pour vous.
  - Si vous définissez FREQ sur DAILY, les intervalles de maintenance ont lieu tous les jours pendant les heures spécifiées.
Attribuez un pool de nœuds au cluster en procédant de l'une des manières suivantes :
- Pour attribuer un pool de nœuds existant à ce cluster, dans la section Pools de nœuds du panneau de navigation de gauche, sélectionnez le pool de nœuds existant et vérifiez que sa configuration sur la page Détails du pool de nœuds est correcte.
- Pour créer un pool de nœuds à attribuer à ce cluster, cliquez sur add_boxAjouter un pool de nœuds, puis fournissez les informations suivantes sur la page Détails du pool de nœuds :
  - Nom du pool de nœuds : nom unique qui identifie ce pool de nœuds.
  - Libellés du pool de nœuds : cliquez sur Ajouter un libellé pour ajouter un ou plusieurs libellés à ce pool de nœuds.
  - Préférence pour les nœuds de calcul : sélectionnez les nœuds connectés au cloud distribué à attribuer à ce pool de nœuds.
Pour créer le cluster connecté Distributed Cloud, cliquez sur Créer.

gcloud

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

Remplacez les éléments suivants :

CLUSTER_ID : nom unique qui identifie ce cluster. Ce nom doit être conforme à la norme RFC 1213 et ne comporter que des caractères alphanumériques minuscules et des tirets (-). 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 est créé et dans laquelle le plan de contrôle Kubernetes du cluster est provisionné.
FLEET_PROJECT_ID : ID du projet hôte du parc dans lequel le cluster est enregistré. Si cette option est ignorée, le projet de cluster connecté Distributed Cloud est utilisé comme projet hôte du parc.
CLUSTER_IPV4_CIDR_BLOCK : bloc CIDR IPv4 souhaité pour les pods Kubernetes qui s'exécutent sur ce cluster.
SERVICE_IPV4_CIDR_BLOCK : bloc CIDR IPv4 souhaité pour les services Kubernetes qui s'exécutent sur ce cluster.
MAX_PODS_PER_NODE (facultatif) : nombre maximal souhaité de pods Kubernetes à exécuter sur chaque nœud de ce cluster.
RELEASE_CHANNEL : (facultatif) spécifie le version disponible pour la version du logiciel Distributed Cloud que vous souhaitez que ce cluster exécute. Les valeurs valides sont REGULAR (activer les mises à niveau automatiques du cluster) et NONE (désactiver les mises à niveau automatiques du cluster). Si aucune valeur n'est spécifiée, la valeur par défaut est REGULAR.
CONTROL_PLANE_KMS_KEY (facultatif) : chemin d'accès complet à la clé Cloud KMS que vous souhaitez utiliser avec le nœud du plan de contrôle de ce cluster. 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.

Si vous créez un cluster avec un plan de contrôle local, en plus de remplacer les variables précédentes, remplacez également les suivantes :

CONTROL_PLANE_LOCATION : indique à Distributed Cloud de déployer localement les charges de travail du plan de contrôle pour ce cluster. La valeur correspond au nom de la zone Distributed Cloud connectée cible.
CONTROL_PLANE_NODE_COUNT (facultatif) : spécifie le nombre de nœuds sur lesquels exécuter les charges de travail du plan de contrôle local. Les valeurs valides sont 3 pour la haute disponibilité et 1 pour le fonctionnement standard. Si aucune valeur n'est spécifiée, la valeur par défaut est 3.
CONTROL_PLANE_NODE_FILTER (facultatif) : spécifie une liste de nœuds au format regex qui exécutent les charges de travail du plan de contrôle local. Si elle est omise, Distributed Cloud sélectionne automatiquement les nœuds de manière aléatoire.
CONTROL_PLANE_NODE_SHARING : (facultatif) indique si les charges de travail des applications peuvent s'exécuter sur les nœuds qui exécutent les charges de travail du plan de contrôle local. Les valeurs valides sont DISALLOWED et ALLOWED. Si aucune valeur n'est spécifiée, la valeur par défaut est DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES : spécifie une liste d'adresses IPv4, de plages d'adresses ou de sous-réseaux pour le trafic entrant des services qui s'exécutent derrière l'équilibreur de charge Distributed Cloud lorsque le cluster est en mode de continuité d'activité.
SOFTWARE_VERSION : spécifie la version du logiciel Distributed Cloud Connected que vous souhaitez que ce cluster exécute au format 1.X.Y, où X est la version mineure et Y la version du correctif (par exemple, 1.5.1). Si elle est omise, la version logicielle par défaut du serveur est utilisée. Il s'agit généralement de la dernière version disponible de Distributed Cloud connected. Pour obtenir les versions logicielles disponibles pour la création de clusters, y compris la version par défaut du serveur, consultez Obtenir les versions logicielles disponibles pour un cluster. Vous devez définir l'option RELEASE_CHANNEL sur NONE pour spécifier une version du logiciel du cluster.
REBOOT_TIMEOUT : (nécessite gcloud alpha) spécifie une période en secondes pendant laquelle un nœud de cluster peut rejoindre un cluster après le redémarrage, tandis que le cluster est en mode de capacité de survie. Si aucune valeur n'est spécifiée, la valeur par défaut est 0, ce qui ne permet pas aux nœuds redémarrés de rejoindre le cluster tant que la connexion à Google Cloud n'a pas été rétablie. Il s'agit d'une fonctionnalité en preview.

ATTENTION : Si vous spécifiez une période de délai avant redémarrage, les nœuds hors connexion peuvent redémarrer et rejoindre le cluster même si vous désactivez ou supprimez la clé de stockage pendant la période spécifiée.

API

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet Google Cloud cible.
REGION : Google Cloud région dans laquelle le cluster Distributed Cloud connecté cible est créé.
CLUSTER_ID : nom unique qui identifie ce cluster. Ce nom doit être conforme à la norme RFC 1213 et ne comporter que des caractères alphanumériques minuscules et des tirets (-). Il doit commencer et se terminer par un caractère alphanumérique.
REQUEST_ID : ID programmatique unique qui identifie cette requête.
FLEET_PROJECT_ID : ID du projet hôte du parc dans lequel le cluster est enregistré. Il peut s'agir d'un projet distinct ou du projet Distributed Cloud associé auquel appartient ce cluster (PROJECT_ID). L'enregistrement du parc est obligatoire.
LABELS : liste des libellés à appliquer à cette ressource de cluster.
USERNAME : nom du compte utilisateur dans le projet Google Cloud cible autorisé à modifier les ressources du cluster.
CLUSTER_IPV4_CIDR_BLOCK : bloc CIDR IPv4 souhaité pour les pods Kubernetes qui s'exécutent sur ce cluster.
SERVICE_IPV4_CIDR_BLOCK : bloc CIDR IPv4 souhaité pour les services Kubernetes qui s'exécutent sur ce cluster.
MAX_PODS_PER_NODE : nombre maximal souhaité de pods Kubernetes à exécuter sur chaque nœud de ce cluster.
RELEASE_CHANNEL : (facultatif) spécifie le version disponible pour la version du logiciel Distributed Cloud Connected que vous souhaitez que ce cluster exécute. Les valeurs valides sont REGULAR (activer les mises à niveau automatiques du cluster) et NONE (désactiver les mises à niveau automatiques du cluster). Si aucune valeur n'est spécifiée, la valeur par défaut est REGULAR.
CONTROL_PLANE_KMS_KEY (facultatif) : chemin d'accès complet à la clé Cloud KMS que vous souhaitez utiliser avec le nœud du plan de contrôle de ce cluster. 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.

Si vous créez un cluster avec un plan de contrôle local, en plus de remplacer les variables précédentes, remplacez également les éléments suivants :

CONTROL_PLANE_LOCATION : indique à Distributed Cloud de déployer localement les charges de travail du plan de contrôle pour ce cluster. La valeur correspond au nom de la zone Distributed Cloud cible.
CONTROL_PLANE_NODE_COUNT : spécifie le nombre de nœuds sur lesquels exécuter les charges de travail du plan de contrôle local. Les valeurs valides sont 3 pour la haute disponibilité et 1 pour le fonctionnement standard.
CONTROL_PLANE_NODE_FILTER (facultatif) : spécifie une liste de nœuds au format regex qui exécutent les charges de travail du plan de contrôle local. Si elle est omise, Distributed Cloud sélectionne automatiquement les nœuds de manière aléatoire.
CONTROL_PLANE_NODE_SHARING : indique si les charges de travail des applications peuvent s'exécuter sur les nœuds qui exécutent les charges de travail du plan de contrôle local. Les valeurs valides sont DISALLOWED et ALLOWED. Si aucune valeur n'est spécifiée, la valeur par défaut est DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES : spécifie une liste d'adresses IPv4, de plages d'adresses ou de sous-réseaux séparés par une virgule pour le trafic entrant des services qui s'exécutent derrière l'équilibreur de charge Distributed Cloud sur un cluster de plan de contrôle local. Ne s'applique pas aux clusters du plan de contrôle Cloud.
SOFTWARE_VERSION : spécifie la version du logiciel Distributed Cloud que vous souhaitez exécuter sur ce cluster au format 1.X.Y, où X est la version mineure et Y la version du correctif (par exemple, 1.5.1). Si elle est omise, la version logicielle par défaut du serveur est utilisée. Il s'agit généralement de la dernière version disponible de Distributed Cloud connected. Pour obtenir les versions logicielles disponibles pour la création de clusters, y compris la version par défaut du serveur, consultez Obtenir les versions logicielles disponibles pour un cluster. Vous devez définir le champ RELEASE_CHANNEL sur NONE pour spécifier une version du logiciel du cluster.
REBOOT_TIMEOUT : (nécessite v1alpha1) spécifie une période en secondes pendant laquelle un nœud de cluster peut rejoindre un cluster après le redémarrage, tandis que le cluster est en mode de capacité de survie. Si aucune valeur n'est spécifiée, la valeur par défaut est 0, ce qui ne permet pas aux nœuds redémarrés de rejoindre le cluster tant que la connexion à Google Cloud n'a pas été rétablie. Il s'agit d'une fonctionnalité en preview.

ATTENTION : Si vous spécifiez une période de délai avant redémarrage, les nœuds hors connexion peuvent redémarrer et rejoindre le cluster même si vous désactivez ou supprimez la clé de stockage pendant la période spécifiée.

Lister les clusters d'une région

Pour lister les clusters connectés Distributed Cloud provisionnés dans une régionGoogle 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 .

Console

Dans la console Google Cloud , accédez à la page Clusters.

accéder aux clusters
Examinez la liste des clusters.

gcloud

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

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet Google Cloud cible.
REGION : région Google Cloud dans laquelle vous avez créé votre cluster Distributed Cloud connecté.

API

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet Google Cloud cible.
REGION : région Google Cloud dans laquelle le cluster Distributed Cloud cible est créé.
CLUSTER_ID : nom du cluster 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 cluster

Pour obtenir des informations sur un cluster connecté 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 .

Console

Dans la console Google Cloud , accédez à la page Clusters.

accéder aux clusters
Sélectionnez le cluster souhaité.

Un panneau dépliant contenant des informations détaillées sur le cluster s'affiche dans le volet de droite.

gcloud

Exécutez la commande gcloud edge-cloud container clusters describe :

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

Remplacez les éléments suivants :

CLUSTER_ID : nom du cluster cible.
PROJECT_ID : ID du projet Google Cloud cible.
REGION : région Google Cloud dans laquelle vous avez créé votre zone Distributed Cloud Connected.

API

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

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

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 est créé.
CLUSTER_ID : nom du cluster cible.

Obtenir les versions logicielles disponibles pour un cluster

Pour savoir quelles versions logicielles Distributed Cloud connecté sont disponibles dans votre zone Distributed Cloud connecté pour créer des clusters, 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 get-server-config :

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

Remplacez REGION par la région Google Cloud dans laquelle vous avez créé votre zone Distributed Cloud connected.

API

Envoyez une requête GET à la méthode projects.locations.serverConfig :

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

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 est créé.

Mettre à niveau la version logicielle d'un cluster de plan de contrôle local

Pour mettre à niveau la version logicielle d'un cluster de plan de contrôle local connecté à Distributed Cloud, suivez les étapes décrites dans cette section. Cette fonctionnalité n'est pas disponible pour les clusters de plan de contrôle Cloud.

Selon votre type de déploiement, les mises à niveau du logiciel Distributed Cloud connecté se déroulent comme suit :

Pour les déploiements de serveurs connectés Distributed Cloud et les déploiements de racks connectés Distributed Cloud utilisant un rack par zone, les nœuds d'une zone sont mis à niveau et redémarrés un par un.
Pour les déploiements de racks connectés Distributed Cloud utilisant plusieurs racks par zone, tous les nœuds de la zone sont mis à niveau simultanément.

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 upgrade :

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

Remplacez les éléments suivants :

CLUSTER_ID : nom du cluster cible.
REGION : région Google Cloud dans laquelle le cluster Distributed Cloud cible a été créé.
PROJECT_ID : ID du projet Google Cloud cible.
UPGRADE_SCHEDULE : spécifie le moment où la mise à niveau logicielle doit être déclenchée. La seule valeur valide est IMMEDIATELY.
SOFTWARE_VERSION : spécifie la version du logiciel Distributed Cloud que vous souhaitez exécuter sur ce cluster au format 1.X.Y, où X est la version mineure et Y la version du correctif (par exemple, 1.5.1). Pour obtenir les versions logicielles disponibles pour la création de clusters, y compris la version par défaut du serveur, consultez Obtenir les versions logicielles disponibles pour un cluster.

API

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

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 est créé.
CLUSTER_ID : nom du cluster cible.
REQUEST_ID : ID programmatique unique qui identifie cette requête.
UPGRADE_SCHEDULE : spécifie le moment où la mise à niveau logicielle doit être déclenchée. La seule valeur valide est IMMEDIATELY.
SOFTWARE_VERSION : spécifie la version du logiciel Distributed Cloud Connected que vous souhaitez que ce cluster exécute au format 1.X.Y, où X est la version mineure et Y la version du correctif (par exemple, 1.5.1). Pour obtenir les versions logicielles disponibles pour la création de clusters, y compris la version par défaut du serveur, consultez Obtenir les versions logicielles disponibles pour un cluster.

Une mise à niveau logicielle prend généralement environ deux heures par nœud faisant partie du pool de nœuds du cluster. La commande renvoie une opération qui vous permet de suivre la progression de la mise à niveau logicielle. Pendant la mise à niveau du logiciel, l'état du cluster est défini sur Reconciling et revient à Running une fois la mise à niveau terminée. L'état Error d'un cluster indique que la mise à niveau du logiciel a échoué. Dans ce cas, exécutez à nouveau la procédure de mise à niveau. Pour savoir comment vérifier l'état d'un cluster, consultez Obtenir des informations sur un cluster.

Obtenir les identifiants d'un cluster

Pour obtenir des identifiants pour un cluster connecté 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 get-credentials :

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

Remplacez les éléments suivants :

CLUSTER_ID : nom du cluster cible.
PROJECT_ID : ID du projet Google Cloud cible.
REGION : région Google Cloud dans laquelle le cluster connecté Distributed Cloud cible est créé.

API

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

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet Google Cloud cible.
REGION : région Google Cloud dans laquelle la zone Distributed Cloud cible est créée.
CLUSTER_ID : nom du cluster cible.

Configurer un intervalle de maintenance pour un cluster

Cette section explique comment spécifier et effacer un intervalle de maintenance pour un cluster connecté Distributed Cloud.

Spécifier un intervalle de maintenance pour un cluster

Pour spécifier une période de maintenance pour un cluster Distributed Cloud connecté, suivez les étapes décrites dans cette section. Pour en savoir plus sur la maintenance des clusters, consultez Comprendre les mises à jour logicielles et les intervalles de maintenance.

Pour les formats de date et d'heure, utilisez RFC 5545.

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

Console

Si vous utilisez la console Google Cloud , vous ne pouvez spécifier une période de maintenance que lorsque vous créez un cluster. Pour spécifier une période de maintenance sur un cluster existant, vous devez utiliser la Google Cloud CLI ou l'API Distributed Cloud Edge Containers.

gcloud

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

Remplacez les éléments suivants :

CLUSTER_ID : nom du cluster cible.
PROJECT_ID : ID du projet Google Cloud cible.
REGION : région Google Cloud dans laquelle le cluster Distributed Cloud connecté cible est créé.
MAINTENANCE_START : heure de début de l'intervalle de maintenance au format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END : heure de fin de l'intervalle de maintenance au format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY : fréquence de l'intervalle de maintenance au format FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU :
- BYDAY : liste de jours séparés par une virgule pendant lesquels la maintenance peut avoir lieu si FREQ est défini sur WEEKLY. Si vous omettez le paramètre BYDAY, Google choisit le jour de la semaine pour vous.
- Si vous définissez FREQ sur "Tous les jours", les intervalles de maintenance ont lieu tous les jours pendant les heures spécifiées.

API

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet Google Cloud cible.
REGION : Google Cloud région dans laquelle le cluster Distributed Cloud connecté cible est créé.
CLUSTER_ID : nom du cluster cible.
UPDATE_MASK : liste de noms de champs complets à mettre à jour dans cette requête au format FieldMask, séparés par une virgule.
REQUEST_ID : ID programmatique unique qui identifie cette requête.
CLUSTER_ID : nom du cluster cible.
USERNAME : nom du compte utilisateur dans le projet Google Cloud cible autorisé à modifier les ressources du cluster.
MAINTENANCE_START : heure de début de l'intervalle de maintenance au format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END : heure de fin de l'intervalle de maintenance au format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY : fréquence de l'intervalle de maintenance au format FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU :
- FREQ peut être DAILY ou WEEKLY.
- BYDAY : liste de jours séparés par une virgule pendant lesquels la maintenance peut avoir lieu si FREQ est défini sur WEEKLY. Si vous omettez le paramètre BYDAY, Google choisit le jour de la semaine pour vous.
- Si vous définissez FREQ sur "Tous les jours", les intervalles de maintenance ont lieu tous les jours pendant les heures spécifiées.

Pour en savoir plus, consultez Ressource : cluster.

Effacer l'intervalle de maintenance d'un cluster

Pour effacer la période de maintenance d'un cluster Distributed Cloud connecté, suivez les étapes décrites dans cette section. Pour en savoir plus sur la maintenance des clusters, consultez Comprendre les mises à jour logicielles et les intervalles de maintenance.

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 update :

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

Remplacez les éléments suivants :

CLUSTER_ID : nom du cluster cible.
PROJECT_ID : ID du projet Google Cloud cible.
REGION : région Google Cloud dans laquelle le cluster Distributed Cloud cible est créé.

API

Envoyez une requête PATCH à la méthode projects.locations.clusters.update :

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet Google Cloud cible.
REGION : Google Cloud région dans laquelle le cluster Distributed Cloud connecté cible est créé.
CLUSTER_ID : nom du cluster cible.
UPDATE_MASK : liste de noms de champs complets à mettre à jour dans cette requête au format FieldMask, séparés par une virgule.
REQUEST_ID : ID programmatique unique qui identifie cette requête.
USERNAME : nom du compte utilisateur dans le projet Google Cloud cible autorisé à modifier les ressources du cluster.

Pour en savoir plus, consultez Ressource : cluster.

Supprimer un cluster

Pour supprimer un cluster connecté Distributed Cloud, suivez les étapes décrites dans cette section. Avant de pouvoir supprimer un cluster, vous devez d'abord effectuer les opérations suivantes :

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 delete :

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

Remplacez les éléments suivants :

CLUSTER_ID : nom du cluster cible.
PROJECT_ID : ID du projet Google Cloud cible.
REGION : région Google Cloud dans laquelle le cluster connecté Distributed Cloud cible est créé.

API

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

DELETE /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?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 connecté Distributed Cloud cible est créé.
CLUSTER_ID : nom du cluster cible.
REQUEST_ID : ID programmatique unique qui identifie cette requête.

Créer et gérer des clusters Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Créer un cluster

Console

gcloud

API

Lister les clusters d'une région

Console

gcloud

API

Obtenir des informations sur un cluster

Console

gcloud

API

Obtenir les versions logicielles disponibles pour un cluster

gcloud

API

Mettre à niveau la version logicielle d'un cluster de plan de contrôle local

gcloud

API

Obtenir les identifiants d'un cluster

gcloud

API

Configurer un intervalle de maintenance pour un cluster

Spécifier un intervalle de maintenance pour un cluster

Console

gcloud

API

Effacer l'intervalle de maintenance d'un cluster

gcloud

API

Supprimer un cluster

gcloud

API

Étapes suivantes

Créer et gérer des clusters