L'API Upgrade utilizza le risorse personalizzate di Kubernetes e si basa su Kubernetes Resource Model (KRM). Gestisce la pianificazione degli upgrade dell'organizzazione tenant.
Per utilizzare l'API Upgrade, ti consigliamo di utilizzare la console GDC o l'interfaccia a riga di comando kubectl. Se la tua applicazione deve utilizzare le tue librerie per chiamare questa
API, utilizza l'esempio seguente e la
definizione completa dell'API per creare
le richieste.
Endpoint del servizio e documento di rilevamento
L'endpoint API per l'API Upgrade è
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/upgrade.gdc.goog/v1,
dove MANAGEMENT_API_SERVER_ENDPOINT è l'endpoint del
server dell'API di gestione.
Utilizzando il comando kubectl proxy, puoi accedere a questo URL nel browser o con uno strumento come curl per ottenere il documento di rilevamento per l'API Upgrade.
Il comando kubectl proxy apre un proxy al server dell'API Kubernetes sulla tua macchina locale. Dopo aver eseguito il comando, puoi accedere al documento al seguente URL: http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1.
Esempio di risorsa MaintenanceWindow di upgrade
Puoi interagire con i periodi di manutenzione utilizzando la console GDC e l'interfaccia a riga di comando kubectl in GDC. Esistono due periodi di manutenzione per ogni organizzazione tenant, uno per gli upgrade delle patch e l'altro per gli upgrade secondari.
Di seguito è riportato un esempio di oggetto MaintenanceWindow configurato per definire un periodo di manutenzione per gli upgrade secondari di 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