升級 API 會使用 Kubernetes 自訂資源,並依賴 Kubernetes 資源模型 (KRM)。負責管理租戶機構升級時間表。
如要使用 Upgrade 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 伺服器的 Proxy。執行該指令後,您可以在下列網址存取文件:http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1。
升級 MaintenanceWindow 資源的範例
您可以使用 GDC 控制台和 GDC 中的 kubectl CLI 與維護時段互動。每個租戶機構都有兩個維護期,分別用於修補程式升級和微幅升級。
以下範例說明如何設定 MaintenanceWindow 物件,定義 GDC 次要升級的維護期間:
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