Panoramica dell'API Resource Manager

L'API Resource Manager utilizza le risorse personalizzate di Kubernetes e si basa sul modello di risorse Kubernetes (KRM) per il provisioning e l'amministrazione delle risorse di organizzazione e progetto. Viene utilizzata per gestire il ciclo di vita delle organizzazioni e dei progetti air-gapped di Google Distributed Cloud (GDC), ad esempio l'installazione, l'upgrade e la disinstallazione.

Per utilizzare l'API Resource Manager, ti consigliamo di utilizzare la console GDC, CLI gdcloud o di chiamare l'API direttamente utilizzando l'interfaccia a riga di comando kubectl. Se la tua applicazione deve utilizzare le tue librerie per chiamare questa API, utilizza gli esempi seguenti e le definizioni complete dell'API per creare le richieste:

Endpoint di servizio e documento di rilevamento

Le API Resource Manager sono fornite in due pacchetti a seconda del deployment zonale o globale.

Di seguito sono riportati gli endpoint API per le API Resource Manager zonali e globali, rispettivamente:

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

Di seguito è riportato l'endpoint API per l'API Resource Manager View:

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

La variabile MANAGEMENT_API_SERVER_ENDPOINT è l'endpoint del server API di gestione.

Utilizzando il comando kubectl proxy, puoi accedere agli URL degli endpoint API nel browser o con uno strumento come curl per ottenere il documento di rilevamento per l'API Resource Manager. Il comando kubectl proxy apre un proxy al server API Kubernetes sulla tua macchina locale. Dopo l'esecuzione del comando, puoi accedere ai documenti ai seguenti URL:

  • 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

Esempio di risorsa Project

Di seguito è riportato un esempio di oggetto Project configurato come risorsa del progetto GDC. Come utente dell'API Resource Manager, la creazione di un progetto tramite la console GDC genera l'oggetto Project per impostazione predefinita. Devi modificarlo solo per riflettere lo stato del progetto che vuoi.

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