Resource Manager API 개요

Resource Manager API는 Kubernetes 커스텀 리소스를 사용하며 조직 및 프로젝트 리소스의 프로비저닝 및 관리를 위해 Kubernetes 리소스 모델 (KRM)을 사용합니다. 설치, 업그레이드, 제거와 같은 Google Distributed Cloud (GDC) 오프라인 조직 및 프로젝트의 수명 주기를 관리하는 데 사용됩니다.

Resource Manager API를 사용하려면 GDC 콘솔, gdcloud CLI를 사용하거나 kubectl CLI를 사용하여 API를 직접 호출하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 API를 호출해야 한다면 다음 예와 전체 API 정의를 사용하여 요청을 빌드하세요.

서비스 엔드포인트 및 검색 문서

Resource Manager API는 영역 배포 또는 전역 배포에 따라 두 패키지로 제공됩니다.

영역별 및 전역 Resource Manager API의 API 엔드포인트는 각각 다음과 같습니다.

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

Resource Manager View API의 API 엔드포인트는 다음과 같습니다.

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

MANAGEMENT_API_SERVER_ENDPOINT 변수는 Management API 서버의 엔드포인트입니다.

kubectl proxy 명령어를 사용하면 브라우저에서 또는 curl과 같은 도구를 사용하여 API 엔드포인트 URL에 액세스하여 Resource Manager API의 검색 문서를 가져올 수 있습니다. kubectl proxy 명령어는 로컬 머신에서 Kubernetes API 서버로의 프록시를 엽니다. 이 명령어가 실행되면 다음 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

프로젝트 리소스 예시

다음은 GDC 프로젝트 리소스로 구성된 Project 객체의 예입니다. Resource Manager API 사용자는 GDC 콘솔을 통해 프로젝트를 만들면 기본적으로 Project 객체가 생성됩니다. 원하는 프로젝트 상태를 반영하도록만 수정해야 합니다.

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