Visão geral da API Upgrade

A API Upgrade usa recursos personalizados do Kubernetes e depende do modelo de recursos do Kubernetes (KRM). Ele gerencia a programação de upgrades da organização do locatário.

Para usar a API Upgrade, recomendamos que você use o console do GDC ou a CLI kubectl. Se o aplicativo precisar usar suas próprias bibliotecas para chamar essa API, use o exemplo a seguir e a definição completa da API para criar suas solicitações.

Endpoint de serviço e documento de descoberta

O endpoint de API da API Upgrade é https://MANAGEMENT_API_SERVER_ENDPOINT/apis/upgrade.gdc.goog/v1, em que MANAGEMENT_API_SERVER_ENDPOINT é o endpoint do servidor da API Management.

Usando o comando kubectl proxy, você pode acessar esse URL no navegador ou com uma ferramenta como curl para receber o documento de descoberta da API Upgrade. O comando kubectl proxy abre um proxy para o servidor da API Kubernetes na máquina local. Depois que esse comando estiver em execução, acesse o documento no seguinte URL: http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1.

Exemplo de recurso MaintenanceWindow de upgrade

É possível interagir com as janelas de manutenção usando o console do GDC e a CLI kubectl no GDC. Há duas janelas de manutenção para cada organização locatária: uma para upgrades de patch e outra para upgrades secundários.

Confira a seguir um exemplo de um objeto MaintenanceWindow configurado para definir uma janela de manutenção para upgrades secundários do 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