Descripción general de la API Upgrade

La API Upgrade usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes (KRM). Gestiona la programación de las actualizaciones de la organización de inquilinos.

Para usar la API Upgrade, te recomendamos que utilices la consola de GDC o la CLI de kubectl. Si tu aplicación necesita usar tus propias bibliotecas para llamar a esta API, utiliza el siguiente ejemplo y la definición completa de la API para crear tus solicitudes.

Endpoint de servicio y documento de descubrimiento

El endpoint de API para la API Upgrade es https://MANAGEMENT_API_SERVER_ENDPOINT/apis/upgrade.gdc.goog/v1, donde MANAGEMENT_API_SERVER_ENDPOINT es el endpoint del servidor de la API 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 Upgrade. El comando kubectl proxy abre un proxy para el servidor de la API de Kubernetes en tu máquina local. Una vez que se esté ejecutando ese comando, podrás acceder al documento en la siguiente URL: http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1.

Ejemplo de actualización del recurso MaintenanceWindow

Puedes interactuar con las ventanas de mantenimiento mediante la consola de GDC y la CLI de kubectl en GDC. Hay dos ventanas de mantenimiento para cada organización de cliente: una para las actualizaciones de parches y otra para las actualizaciones menores.

A continuación se muestra un ejemplo de un objeto MaintenanceWindow configurado para definir una ventana de mantenimiento para las actualizaciones menores 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