A API Resource Manager usa recursos personalizados do Kubernetes e baseia-se no modelo de recursos do Kubernetes (KRM) para o aprovisionamento e a administração de recursos da organização e do projeto. É usado para gerir o ciclo de vida de organizações e projetos isolados do Google Distributed Cloud (GDC), como a instalação, a atualização e a desinstalação.
Para usar a API Resource Manager, recomendamos que use a consola GDC, a CLI gdcloud ou chame a API diretamente através da CLI kubectl
. Se a sua aplicação precisar de usar as suas próprias bibliotecas para chamar esta API, use os seguintes exemplos e as definições completas da API para criar os seus pedidos:
Ponto final do serviço e documento de descoberta
As APIs Resource Manager são fornecidas em dois pacotes, consoante a implementação zonal ou global.
Os pontos finais da API para as APIs do Resource Manager zonais e globais 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 ponto final da API da Resource Manager View API é o seguinte:
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1
A variável MANAGEMENT_API_SERVER_ENDPOINT
é o ponto final do servidor da API Management.
Com o comando kubectl proxy
, pode aceder aos URLs dos pontos finais da API no seu navegador ou com uma ferramenta como curl
para obter 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 de executar esse comando, pode aceder aos 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 do projeto
Segue-se um exemplo de um objeto Project
configurado como um recurso do projeto GDC. Como utilizador da API Resource Manager, a criação de um projeto através da consola GDC gera o objeto Project
por predefinição. Só deve modificá-lo para refletir o estado do projeto que quer.
apiVersion: resourcemanager.global.gdc.goog/v1
kind: Project
metadata:
namespace: platform
name: test-project