Die Upgrade API verwendet benutzerdefinierte Kubernetes-Ressourcen und basiert auf dem Kubernetes-Ressourcenmodell (Kubernetes Resource Model, KRM). Sie verwaltet den Zeitplan für Upgrades von Mandantenorganisationen.
Wir empfehlen, die GDC Console oder die kubectl-CLI zu verwenden, um die Upgrade API zu nutzen. Wenn Ihre Anwendung diese
API mit Ihren eigenen Bibliotheken aufrufen muss, verwenden Sie das folgende Beispiel und die
vollständige API-Definition, um
Ihre Anfragen zu erstellen.
Dienstendpunkt und Discovery-Dokument
Der API-Endpunkt für die Upgrade API ist
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/upgrade.gdc.goog/v1,
dabei ist MANAGEMENT_API_SERVER_ENDPOINT der Endpunkt des
Management API-Servers.
Mit dem Befehl kubectl proxy können Sie in Ihrem Browser oder mit einem Tool wie curl auf diese URL zugreifen, um das Discovery-Dokument für die Upgrade API abzurufen.
Der Befehl kubectl proxy öffnet einen Proxy zum Kubernetes API-Server auf Ihrem lokalen Computer. Nachdem der Befehl ausgeführt wurde, können Sie unter der folgenden URL auf das Dokument zugreifen: http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1.
Beispiel für eine `MaintenanceWindow`-Ressource für ein Upgrade
Sie können in GDC über die GDC Console und die kubectl-CLI mit Wartungsfenstern interagieren. Für jede Mandantenorganisation gibt es zwei Wartungsfenster: eines für Patch-Upgrades und eines für kleinere Upgrades.
Das folgende Beispiel zeigt ein MaintenanceWindow-Objekt, das so konfiguriert ist, dass ein Wartungsfenster für kleinere GDC-Upgrades definiert wird:
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