La API de Upgrade usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes (KRM). Administra la programación de las actualizaciones de la organización de arrendatarios.
Para usar la API de Upgrade, te recomendamos que uses la consola de GDC o la CLI de kubectl. Si tu aplicación necesita usar tus propias bibliotecas para llamar a esta
API, usa el siguiente ejemplo y la
definición completa de la API para compilar
tus solicitudes.
Extremo del servicio y documento de descubrimiento
El extremo de API de Upgrade es
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/upgrade.gdc.goog/v1,
en el que MANAGEMENT_API_SERVER_ENDPOINT es el endpoint del
servidor de la API de Management.
Con el comando kubectl proxy, puedes acceder a esa URL en tu navegador o con una herramienta como curl para obtener el documento de descubrimiento de la API de Upgrade.
El comando kubectl proxy abre un proxy al servidor de la API de Kubernetes en tu máquina local. Una vez que se ejecuta ese comando, puedes acceder al documento en la siguiente URL: http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1.
Ejemplo de recurso MaintenanceWindow de actualización
Puedes interactuar con los períodos de mantenimiento mediante la consola de GDC y la CLI de kubectl en GDC. Hay dos períodos de mantenimiento para cada organización de arrendatarios, uno para las actualizaciones de parches y el otro para las actualizaciones secundarias.
A continuación, se muestra un ejemplo de un objeto MaintenanceWindow configurado para definir un período de mantenimiento para las actualizaciones secundarias 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