Resource Manager API は Kubernetes カスタム リソースを使用し、組織リソースとプロジェクト リソースのプロビジョニングと管理に Kubernetes Resource Model(KRM)を使用します。これは、インストール、アップグレード、アンインストールなど、Google Distributed Cloud(GDC)エアギャップ アプライアンス プロジェクトのライフサイクルを管理するために使用されます。
Resource Manager API を使用するには、GDC コンソールと gdcloud CLI を使用することをおすすめします。アプリケーションで独自のライブラリを使用してこの API を呼び出す必要がある場合は、次の例と完全な API 定義を使用してリクエストを構築します。
サービス エンドポイントとディスカバリ ドキュメント
Resource Manager API の API エンドポイントは https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1
です。ここで、MANAGEMENT_API_SERVER_ENDPOINT
は Management API サーバーのエンドポイントです。
Resource Manager View API の API エンドポイントも同様の規則に従います(https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1
)。
kubectl proxy
コマンドを使用すると、ブラウザまたは curl
などのツールで API エンドポイント URL にアクセスして、Resource Manager API のディスカバリ ドキュメントを取得できます。kubectl proxy
コマンドは、ローカルマシンの Kubernetes API サーバーへのプロキシを開きます。このコマンドが実行されると、次の URL でドキュメントにアクセスできます。http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1
。
プロジェクト リソースの例
次の例は、GDC プロジェクト リソースとして構成された Project
オブジェクトの例です。Resource Manager API のユーザーとして、GDC コンソールでプロジェクトを作成すると、デフォルトで Project
オブジェクトが生成されます。必要なプロジェクトの状態を反映するためにのみ変更する必要があります。
apiVersion: resourcemanager.gdc.goog/v1
kind: Project
name: test-project
namespace: test-namespace