升级 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
等工具访问该网址,以获取 Upgrade API 的发现文档。kubectl proxy
命令会在本地机器上打开一个指向 Kubernetes API 服务器的代理。该命令运行后,您可以通过以下网址访问文档:http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1
。
升级维护期资源示例
您可以在 GDC 中使用 GDC 控制台和 kubectl
CLI 与维护期进行交互。每个租户组织都有两个维护窗口,一个用于补丁升级,另一个用于次要升级。
以下示例展示了配置为定义 GDC 次要升级维护窗口的 MaintenanceWindow
对象:
apiVersion: upgrade.gdc.goog/v1
kind: MaintenanceWindow
metadata:
name: minor-upgrade
namespace: gpc-system
spec:
recurrence: FREQ=MONTHLY;BYSETPOS=1;BYDAY=SU
timeWindow:
end: "2022-04-03T06:00:00Z"
start: "2022-04-03T00:00:00Z"
upgradeType: MinorUpgrade