Upgrade API 概览

升级 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