Serveurs d'API mondiaux et zonaux

Google Distributed Cloud (GDC) sous air gap fonctionne comme un univers multizone. Cela signifie qu'il existe des ressources zonales et des ressources globales déployées sur différents serveurs d'API, qui sont gérées indépendamment par le système. Un serveur d'API fournit un point de terminaison unique pour créer, gérer et supprimer des ressources d'API avec un backend de stockage fortement cohérent.

Serveurs de l'API Management

Il existe deux types de serveurs d'API de gestion :

  • Serveur d'API mondial
  • Serveur(s) d'API zonaux

Il n'existe qu'un seul serveur d'API global pour votre univers. De même, il existe un serveur d'API zonal pour chaque zone dans laquelle vous opérez. Même si vous travaillez dans un environnement à zone unique, il existe un serveur d'API global et un serveur d'API zonal pour la zone unique.

Les ressources zonales sont déployées sur un serveur d'API zonal et fonctionnent de manière indépendante dans une seule zone. Une panne zonale peut affecter tout ou partie des ressources de cette zone. Les ressources mondiales sont déployées dans le serveur d'API mondial et fonctionnent avec une redondance dans plusieurs zones pour la tolérance aux pannes.

Un univers gère un serveur d'API global qui couvre toutes les zones, ainsi que des serveurs d'API zonaux dédiés à chaque zone.

Vous devez comprendre cette architecture pour déployer correctement vos ressources pour la haute disponibilité. Si certaines ressources peuvent être déployées à l'échelle mondiale ou fonctionner de manière indépendante dans une seule zone, d'autres ne sont disponibles qu'à l'échelle mondiale ou zonale. Pour en savoir plus, consultez la documentation appropriée d'un type de ressource.

Chaque surface, qu'il s'agisse de la console GDC, de gdcloud CLI, des API ou de Terraform, fournit des mécanismes permettant de déployer correctement votre ressource sur un serveur d'API de gestion désigné.

Console GDC

La console GDC fournit un sélecteur de portée de zone sur de nombreuses pages.

Sélectionnez une zone pour afficher les ressources qui y sont présentes.

Le sélecteur de champ d'application de zone vous permet de cibler des zones spécifiques pour les tâches de gestion des ressources.

Si une ressource peut s'étendre sur une ou plusieurs zones, vous avez la possibilité de la créer et de la gérer en fonction de votre choix de déploiement zonal ou mondial.

La console GDC vous permet de choisir dynamiquement la zone et offre une vue complète de toutes les ressources et services GDC disponibles pour cet emplacement.

La zone ou le contexte global sélectionnés sont affichés en accédant à l'URL globale ou zonale. Les URL correspondent aux serveurs d'API hébergés pour le contexte zonal ou global spécifique. Par exemple, si vous sélectionnez le contexte global, vous êtes redirigé vers l'URL globale :

https://console.ORG_NAME.SUFFIX

De même, si vous sélectionnez une zone spécifique dans la console, vous êtes redirigé vers l'URL zonale :

https://console.ORG_NAME.ZONE.SUFFIX

gdcloud CLI

La CLI gdcloud permet d'interagir avec l'API zonale ou globale pour gérer vos ressources et leur déploiement, y compris :

  • Se connecter à l'URL de la console zonale ou globale à l'aide de la CLI
  • Utiliser un indicateur CLI zonal pour des actions spécifiques à une zone

L'URL globale est celle qui est configurée par défaut lors de l'initialisation de la CLI gdcloud. Vous pouvez mettre à jour votre configuration gdcloud pour définir des URL zonales et vous y connecter afin d'effectuer des tâches spécifiques à une zone.

De même, la CLI gdcloud propose un indicateur --zone que vous pouvez définir pour de nombreuses tâches de gestion des ressources dans les groupes de commandes. Lorsque vous êtes connecté à la configuration d'URL globale, vos actions CLI sur les ressources globales sont appliquées à toutes les zones pour lesquelles elles sont dans le champ d'application.

Pour en savoir plus sur l'utilisation de la gcloud CLI pour les services zonaux et globaux, consultez Gérer les ressources dans les zones.

API et Terraform

Vous pouvez utiliser les API KRM, et par extension Terraform, pour cibler le serveur d'API zonal ou mondial et interagir avec les ressources qui y sont hébergées. GDC vous permet de définir le contexte de votre serveur d'API à l'aide de kubectl, ce qui vous permet de configurer le fichier kubeconfig pour le serveur d'API approprié. Une fois le contexte défini, vous pouvez appliquer et manipuler vos ressources personnalisées hébergées dans la zone ou, si elles sont déployées à l'échelle mondiale, dans plusieurs zones.

Pour en savoir plus sur le changement de contexte du serveur d'API à l'aide de kubectl, consultez Se connecter.

Étapes suivantes