Présentation de l'API Resource Manager

L'API Resource Manager utilise des ressources personnalisées Kubernetes et s'appuie sur le modèle de ressources Kubernetes (KRM) pour le provisionnement et l'administration des ressources d'organisation et de projet. Elle permet de gérer le cycle de vie des organisations et des projets Google Distributed Cloud (GDC) isolés, par exemple pour l'installation, la mise à niveau et la désinstallation.

Pour utiliser l'API Resource Manager, nous vous recommandons d'utiliser la console GDC, l'CLI gdcloud ou d'appeler directement l'API à l'aide de l'CLI kubectl. Si votre application doit utiliser ses propres bibliothèques pour appeler cette API, utilisez les exemples suivants et les définitions complètes de l'API pour créer vos requêtes :

Point de terminaison de service et document de découverte

Les API Resource Manager sont fournies dans deux packages, selon le déploiement zonal ou le déploiement mondial.

Les points de terminaison d'API pour les API Resource Manager zonales et mondiales sont les suivants, respectivement :

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.global.gdc.goog/v1

Le point de terminaison de l'API pour l'API Resource Manager View est le suivant :

https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1

La variable MANAGEMENT_API_SERVER_ENDPOINT est le point de terminaison du serveur de l'API Management.

À l'aide de la commande kubectl proxy, vous pouvez accéder aux URL des points de terminaison d'API dans votre navigateur ou avec un outil tel que curl pour obtenir le document de découverte de l'API Resource Manager. La commande kubectl proxy ouvre un proxy vers le serveur d'API Kubernetes sur votre machine locale. Une fois cette commande exécutée, vous pouvez accéder aux documents aux URL suivantes :

  • http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1
  • http://127.0.0.1:8001/apis/resourcemanager.global.gdc.goog/v1
  • http://127.0.0.1:8001/apis/resourcemanagerview.gdc.goog/v1

Exemple de ressource de projet

Voici un exemple d'objet Project configuré en tant que ressource de projet GDC. En tant qu'utilisateur de l'API Resource Manager, la création d'un projet via la console GDC génère l'objet Project par défaut. Vous ne devez le modifier que pour refléter l'état du projet souhaité.

apiVersion: resourcemanager.global.gdc.goog/v1
kind: Project
metadata:
  namespace: platform
  name: test-project