L'API Upgrade utilise des ressources personnalisées Kubernetes et s'appuie sur le modèle de ressources Kubernetes (KRM). Il gère le calendrier des mises à niveau des organisations locataires.
Pour utiliser l'API Upgrade, 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 Upgrade 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 Upgrade.
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 pour la mise à niveau
Vous pouvez interagir avec les intervalles de maintenance à l'aide de la console GDC et de la CLI kubectl dans GDC. Il existe deux périodes de maintenance pour chaque organisation locataire : une pour les mises à niveau correctives 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