Panoramica dell'API Upgrade

L'API Upgrade utilizza risorse personalizzate Kubernetes e si basa sul modello di risorse Kubernetes (KRM). Gestisce la pianificazione degli upgrade dell'organizzazione tenant.

Per utilizzare l'API Upgrade, ti consigliamo di utilizzare la console GDC o kubectl CLI. 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 tue richieste.

Endpoint di 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 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 API Kubernetes sulla tua macchina locale. Una volta 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 le finestre 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