Présentation de l'API Upgrade

L'API de mise à niveau utilise des ressources personnalisées Kubernetes et s'appuie sur le modèle de ressource Kubernetes (KRM). Elle gère la planification des mises à niveau des organisations locataires.

Pour utiliser l'API de mise à niveau, nous vous recommandons d'utiliser la console GDC ou l'CLI kubectl. Si votre application doit utiliser vos propres bibliothèques pour appeler cette API, utilisez l'exemple suivant et la définition complète de l'API pour créer vos requêtes.

Point de terminaison du service et document de découverte

Le point de terminaison de l'API de mise à niveau est https://MANAGEMENT_API_SERVER_ENDPOINT/apis/upgrade.gdc.goog/v1, où MANAGEMENT_API_SERVER_ENDPOINT est le point de terminaison du serveur de l'API Management.

À l'aide de la commande kubectl proxy, vous pouvez accéder à cette URL dans votre navigateur ou avec un outil tel que curl pour obtenir le document de découverte de l'API de mise à niveau. La commande kubectl proxy ouvre un proxy vers le serveur d'API Kubernetes sur votre machine locale. Une fois cette commande exécutée, vous pouvez accéder au document à l'URL suivante : http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1.

Exemple de ressource MaintenanceWindow de mise à niveau

Vous pouvez interagir avec les intervalles de maintenance à l'aide de la console GDC et de l'CLI kubectl dans GDC. Il existe deux intervalles de maintenance pour chaque organisation locataire : l'un pour les mises à niveau de correctifs et l'autre pour les mises à niveau mineures.

Voici un exemple d'objet MaintenanceWindow configuré pour définir un intervalle de maintenance pour les mises à niveau mineures de 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