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 del cliente.

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

Punto de conexión de servicio y documento de descubrimiento

El endpoint de 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 al servidor de la API de Kubernetes en tu máquina local. Una vez que se haya ejecutado el 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 de un recurso MaintenanceWindow

Puedes interactuar con las ventanas de mantenimiento mediante la consola de GDC y la kubectlCLI de GDC. Hay dos ventanas de mantenimiento para cada organización de inquilino: 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