업그레이드 API는 Kubernetes 커스텀 리소스를 사용하고 Kubernetes 리소스 모델 (KRM)을 기반으로 합니다. 테넌트 조직 업그레이드 일정을 관리합니다.
업그레이드 API를 사용하려면 GDC 콘솔 또는 kubectl CLI를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 API를 호출해야 한다면 다음 예시와 전체 API 정의를 사용하여 요청을 빌드하세요.
서비스 엔드포인트 및 검색 문서
업그레이드 API의 API 엔드포인트는 https://MANAGEMENT_API_SERVER_ENDPOINT/apis/upgrade.gdc.goog/v1입니다. 여기서 MANAGEMENT_API_SERVER_ENDPOINT은 관리 API 서버의 엔드포인트입니다.
kubectl proxy 명령어를 사용하여 브라우저에서 또는 curl과 같은 도구로 해당 URL에 액세스하여 업그레이드 API의 검색 문서를 가져올 수 있습니다.
kubectl proxy 명령어를 사용하면 로컬 머신에서 Kubernetes API 서버로의 프록시가 열립니다. 이 명령어가 실행되면 http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1 URL에서 문서에 액세스할 수 있습니다.
업그레이드 MaintenanceWindow 리소스의 예
GDC에서 GDC 콘솔과 kubectl CLI를 사용하여 유지보수 기간과 상호작용할 수 있습니다. 모든 테넌트 조직에는 패치 업그레이드용과 마이너 업그레이드용의 두 가지 유지보수 기간이 있습니다.
다음은 GDC 부 버전 업그레이드의 유지보수 기간을 정의하도록 구성된 MaintenanceWindow 객체의 예시입니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eThe Upgrade API utilizes Kubernetes custom resources and the Kubernetes Resource Model (KRM) to manage tenant organization upgrade scheduling.\u003c/p\u003e\n"],["\u003cp\u003eThe GDC console or \u003ccode\u003ekubectl\u003c/code\u003e CLI are the recommended tools for interacting with the Upgrade API, but custom libraries can be used by referencing the API definition.\u003c/p\u003e\n"],["\u003cp\u003eThe Upgrade API endpoint is accessible via a specific URL structure, with the Management API server endpoint variable.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ekubectl proxy\u003c/code\u003e can be used to access the Upgrade API's discovery document, which is located at a local URL after running the command.\u003c/p\u003e\n"],["\u003cp\u003eEach tenant organization has two maintenance windows, one for patch upgrades and one for minor upgrades, which can be managed through the GDC console and \u003ccode\u003ekubectl\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Overview of Upgrade API\n\nThe Upgrade API uses Kubernetes custom resources and relies on the Kubernetes\nResource Model (KRM). It manages the schedule for tenant organization upgrades.\n\nTo use the Upgrade API, we recommend that you use the GDC console or\n`kubectl` CLI. If your application needs to use your own libraries to call this\nAPI, use the following example and the\n[full API definition](/distributed-cloud/hosted/docs/latest/gdch/apis/service/upgrade/v1/upgrade-v1) to build\nyour requests.\n\nService endpoint and discovery document\n---------------------------------------\n\nThe API endpoint for the Upgrade API is\n`https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/upgrade.gdc.goog/v1`,\nwhere \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e is the endpoint of the\nManagement API server.\n\nUsing the `kubectl proxy` command, you can access that URL in your browser or\nwith a tool such as `curl` to get the discovery document for the Upgrade API.\nThe `kubectl proxy` command opens up a proxy to the Kubernetes API server on\nyour local machine. After that command is running, you can access the document at\nthe following URL: `http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1`.\n\nExample upgrade MaintenanceWindow resource\n------------------------------------------\n\nYou can interact with maintenance windows using the GDC console and\n`kubectl` CLI in GDC. There are two maintenance windows\nfor every tenant organization, one for patch upgrades and the other for minor\nupgrades.\n\nThe following is an example of a `MaintenanceWindow` object configured to define\na maintenance window for GDC minor upgrades: \n\n apiVersion: upgrade.gdc.goog/v1\n kind: MaintenanceWindow\n metadata:\n name: minor-upgrade\n namespace: gpc-system\n spec:\n recurrence: FREQ=MONTHLY;BYSETPOS=1;BYDAY=SU\n timeWindow:\n end: \"2022-04-03T06:00:00Z\"\n start: \"2022-04-03T00:00:00Z\"\n upgradeType: MinorUpgrade"]]
