Información general sobre la API Resource Manager

La API Resource Manager usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes (KRM) para aprovisionar y administrar recursos de organizaciones y proyectos. Se usa para gestionar el ciclo de vida de las organizaciones y los proyectos aislados de Google Distributed Cloud (GDC), como la instalación, la actualización y la desinstalación.

Para usar la API Resource Manager, te recomendamos que utilices la consola de GDC, la CLI de gdcloud o que llames a la API directamente mediante la CLI de kubectl. Si tu aplicación necesita usar tus propias bibliotecas para llamar a esta API, utiliza los siguientes ejemplos y las definiciones completas de la API para crear tus solicitudes:

Punto de conexión de servicio y documento de descubrimiento

Las APIs de Resource Manager se proporcionan en dos paquetes, en función del despliegue zonal o global.

Los endpoints de las APIs de Resource Manager zonales y globales son los siguientes, respectivamente:

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

El endpoint de la API Resource Manager View es el siguiente:

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

La variable MANAGEMENT_API_SERVER_ENDPOINT es el endpoint del servidor de la API Management.

Con el comando kubectl proxy, puedes acceder a las URLs de los endpoints de la API en tu navegador o con una herramienta como curl para obtener el documento de descubrimiento de la API Resource Manager. El comando kubectl proxy abre un proxy al servidor de la API de Kubernetes en tu máquina local. Una vez que se haya ejecutado ese comando, podrás acceder a los documentos en las siguientes URLs:

  • 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

Recurso de proyecto de ejemplo

A continuación, se muestra un ejemplo de un objeto Project configurado como recurso de proyecto de GDC. Si usas la API Resource Manager, al crear un proyecto a través de la consola de GDC, se genera el objeto Project de forma predeterminada. Solo debes modificarlo para reflejar el estado del proyecto que quieras.

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