Visão geral da API Resource Manager

A API Resource Manager usa recursos personalizados do Kubernetes e depende do modelo de recursos do Kubernetes (KRM, na sigla em inglês) para provisionamento e administração de recursos da organização e do projeto. Ela é usada para gerenciar o ciclo de vida de organizações e projetos isolados do Google Distributed Cloud (GDC), como instalação, upgrade e desinstalação.

Para usar a API Resource Manager, recomendamos que você use o console do GDC, a CLI gdcloud ou chame a API diretamente usando a CLI kubectl. Se o aplicativo precisar usar bibliotecas próprias para chamar essa API, use os exemplos a seguir e as definições completas da API para criar suas solicitações:

Endpoint de serviço e documento de descoberta

As APIs Resource Manager são fornecidas em dois pacotes, dependendo da implantação zonal ou global.

Os endpoints de API para as APIs Resource Manager zonal e global são os seguintes, respectivamente:

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

O endpoint de API para a API Resource Manager View é o seguinte:

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

A variável MANAGEMENT_API_SERVER_ENDPOINT é o endpoint do servidor da API Management.

Usando o comando kubectl proxy, é possível acessar os URLs de endpoint de API no navegador ou com uma ferramenta como curl para receber o documento de descoberta da API Resource Manager. O comando kubectl proxy abre um proxy para o servidor da API Kubernetes na sua máquina local. Depois que esse comando estiver em execução, você poderá acessar os documentos nos seguintes 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

Exemplo de recurso de projeto

Confira a seguir um exemplo de um objeto Project configurado como um recurso de projeto do GDC. Como usuário da API Resource Manager, a criação de um projeto pelo console do GDC gera o objeto Project por padrão. Você só precisa modificá-lo para refletir o estado do projeto desejado.

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