Descripción general de la API de Resource Manager

La API de Resource Manager usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes (KRM) para el aprovisionamiento y la administración de recursos de la organización y del proyecto. Se usa para administrar 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 de Resource Manager, te recomendamos que uses la consola de GDC, la CLI de gdcloud o que llames a la API directamente con la CLI de kubectl. Si tu aplicación necesita usar tus propias bibliotecas para llamar a esta API, usa los siguientes ejemplos y las definiciones completas de la API para compilar tus solicitudes:

Extremo de servicio y documento de descubrimiento

Las APIs de Resource Manager se proporcionan en dos paquetes según la implementación zonal o global.

Los extremos de API para 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 extremo de API de Resource Manager View es el siguiente:

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

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

Con el comando kubectl proxy, puedes acceder a las URLs de extremo de API en tu navegador o con una herramienta como curl para obtener el documento de descubrimiento de la API de Resource Manager. El comando kubectl proxy abre un proxy para el servidor de la API de Kubernetes en tu máquina local. Después de que se ejecute 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 un recurso del proyecto de GDC. Como usuario de la API de Resource Manager, cuando creas un proyecto a través de la consola de GDC, se genera el objeto Project de forma predeterminada. Solo debes modificarlo para que refleje el estado del proyecto que deseas.

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