Visão geral da API Cluster

A API Cluster usa recursos personalizados do Kubernetes e depende do modelo de recursos do Kubernetes (KRM, na sigla em inglês). Ele gerencia o ciclo de vida dos clusters em uma determinada organização, como instalação, upgrade e desinstalação.

Para usar a API Cluster, recomendamos que você use o console do GDC. Se o aplicativo precisar usar bibliotecas próprias 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 do Cluster é https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.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 Cluster. 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/cluster.gdc.goog/v1.

Exemplo de recurso de cluster

Confira a seguir um exemplo de um objeto Cluster configurado como um cluster de usuário:

apiVersion: cluster.gdc.goog/v1
kind: Cluster
metadata:
  name: user-vm-1
  namespace: platform
spec:
  clusterNetwork:
    podCIDRSize: 21
    serviceCIDRSize: 23
  initialVersion:
    kubernetesVersion: 1.27.1-gke.700
  loadBalancer:
    ingressServiceIPSize: 21
  nodePools:
  - machineTypeName: n2-standard-8-gdc
    name: worker-node-pool
    nodeCount: 3
  releaseChannel:
    channel: UNSPECIFIED