Vista geral da API Cluster

A API Cluster usa recursos personalizados do Kubernetes e baseia-se no modelo de recursos do Kubernetes (KRM). Gere o ciclo de vida dos clusters numa determinada organização, como a instalação, a atualização e a desinstalação.

Para usar a API Cluster, recomendamos que use a consola GDC. Se a sua aplicação precisar de usar as suas próprias bibliotecas para chamar esta API, use o exemplo seguinte e a definição completa da API para criar os seus pedidos.

Ponto final do serviço e documento de descoberta

O ponto final da API para a API Cluster é https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.gdc.goog/v1, onde MANAGEMENT_API_SERVER_ENDPOINT é o ponto final do servidor da API Management.

Com o comando kubectl proxy, pode aceder a esse URL no seu navegador ou com uma ferramenta como curl para obter o documento de descoberta da API Cluster. O comando kubectl proxy abre um proxy para o servidor da API Kubernetes na sua máquina local. Assim que esse comando estiver em execução, pode aceder ao documento no seguinte URL: http://127.0.0.1:8001/apis/cluster.gdc.goog/v1.

Recurso de cluster de exemplo

Segue-se um exemplo de um objeto Cluster configurado como um cluster de utilizadores:

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