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 de organização e projeto. Ela é usada para gerenciar o ciclo de vida de organizações e projetos do Google Distributed Cloud (GDC) com isolamento físico, 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 as
solicitações:
Endpoint de serviço e documento de descoberta
As APIs do Resource Manager são fornecidas em dois pacotes, dependendo da implantação zonal ou global.
Os endpoints de API zonais e globais da API Resource Manager são os seguintes, respectivamente:
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1https://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 de API Kubernetes na 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/v1http://127.0.0.1:8001/apis/resourcemanager.global.gdc.goog/v1http://127.0.0.1:8001/apis/resourcemanagerview.gdc.goog/v1
Exemplo de recurso de projeto
Veja a seguir um exemplo de objeto Project configurado como um
recurso de projeto do GDC. Como usuário da API Resource Manager, criar um projeto pelo console do GDC gera o objeto
Project por padrão. Você só precisa modificá-lo para refletir o estado
do projeto que quer.
apiVersion: resourcemanager.global.gdc.goog/v1
kind: Project
metadata:
namespace: platform
name: test-project