Gérer des zones

Cette page explique comment gérer les ressources de zone Google Distributed Cloud dans un déploiement Distributed Cloud. En raison de la structuration des Google Cloud API, les ressources de zone Distributed Cloud sont appelées emplacements dans l' API Distributed Cloud Edge Container.

Pour en savoir plus sur les zones Distributed Cloud, consultez la page Fonctionnement de Distributed Cloud works.

Répertorier les zones

Pour répertorier la zone Distributed Cloud dans votre Google Cloud projet, 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 Google Cloud projet.

Console

  1. Dans la Google Cloud console, accédez à la page Zones périphériques.

    Accéder aux zones périphériques

  2. Examinez la liste des zones et leurs détails.

gcloud

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

gcloud edge-cloud container zones list \
    --project=PROJECT_ID

Remplacez PROJECT_ID par l'ID du projet cible Google Cloud .

API

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

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet cible. Google Cloud
  • 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 selon lesquels les résultats renvoyés sont triés, séparés par une virgule. L'ordre de tri par défaut est croissant. Pour un ordre décroissant, faites précéder le champ souhaité de ~.
  • PAGE_TOKEN: jeton reçu dans la 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.

Initialiser la configuration réseau d'une zone

Pour initialiser la configuration réseau d'une zone Distributed Cloud, suivez les étapes de cette section.

Avant de pouvoir initialiser la configuration réseau d'une zone, vous devez d'abord activer l'API Distributed Cloud Edge Network.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau périphérique (roles/edgenetwork.admin) dans votre Google Cloud projet.

Vous devez initialiser la configuration réseau de chacune de vos zones Distributed Cloud dans les cas suivants :

  • Immédiatement après l'installation de votre matériel Distributed Cloud dans vos locaux.
  • Vous avez effectué une mise à niveau vers la version 1.3.0 de Distributed Cloud sur un déploiement Distributed Cloud existant, mais vous n'avez pas participé à la préversion privée de l'API Distributed Cloud Edge Network.

L'initialisation de la configuration réseau d'une zone crée un routeur par défaut nommé default. Le routeur default est ensuite configuré pour s'appairer avec toutes les interconnexions que vous avez demandées lors de la commande du matériel Distributed Cloud en créant les pièces jointes d'interconnexion correspondantes. Cela fournit à votre déploiement Distributed Cloud une connectivité de liaison montante de base à votre réseau local.

Il s'agit d'une procédure à exécuter une seule fois. Les exécutions suivantes ne modifient pas vos paramètres réseau Distributed Cloud existants.

gcloud

Exécutez la commande gcloud edge-cloud networking zones init :

gcloud edge-cloud networking zones init ZONE_NAME \
    --project=PROJECT_ID \
    --location=REGION

Remplacez les éléments suivants :

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

API

Envoyez une requête POST à la méthode projects.locations.zones.initialize :

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME:init

Remplacez les éléments suivants :

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

Obtenir des informations sur une zone

Pour obtenir des informations sur une zone 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 Google Cloud projet.

Console

  1. Dans la Google Cloud console, accédez à la page Zones périphériques.

    Accéder aux zones périphériques

  2. Cliquez sur la zone souhaitée.

    La Google Cloud console affiche des informations détaillées sur la zone sélectionnée.

gcloud

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

gcloud edge-cloud container zones describe ZONE_NAME \
    --project=PROJECT_ID

Remplacez les éléments suivants :

  • ZONE_NAME: nom de la zone Distributed Cloud cible.
  • PROJECT_ID : ID du projet cible. Google Cloud

API

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

GET /v1/PROJECT_ID/locations/REGION

Remplacez les éléments suivants :

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

Étape suivante