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. Il permet de gérer le cycle de vie des organisations et des projets Google Distributed Cloud (GDC) isolés, comme l'installation, la mise à niveau et la désinstallation.

Pour utiliser l'API Resource Manager, nous vous recommandons d'utiliser la console GDC, gdcloud CLI ou d'appeler l'API directement à l'aide de la CLI kubectl. Si votre application doit utiliser vos 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 du service et document de découverte

Les API Resource Manager sont fournies dans deux packages en fonction du déploiement zonal ou global.

Voici les points de terminaison de l'API Resource Manager zonale et globale :

  • 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 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 de l'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 Project

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