Esta página foi traduzida pela API Cloud Translation.

Crie um cluster para executar cargas de trabalho de contentores

Crie um cluster de utilizadores para permitir a implementação da carga de trabalho do contentor.

Antes de começar

Para receber as autorizações necessárias para criar um cluster de utilizadores, peça ao administrador do IAM da sua organização para lhe conceder a função de administrador do cluster de utilizadores (função user-cluster-admin).

Crie um cluster de utilizadores

Para receber as autorizações necessárias para criar um cluster de utilizadores, peça ao seu administrador do IAM para lhe conceder a função de administrador do cluster de utilizadores (função user-cluster-admin).

Conclua os passos seguintes para criar um cluster de utilizadores:

Consola

No menu de navegação, selecione Clusters.
Clique em Criar cluster.
No campo Nome, especifique um nome para o cluster de utilizadores.

Importante: o nome do cluster não pode terminar com -system. O sufixo -system está reservado para clusters criados pelo GDC.
Selecione a versão do cluster do GDC. Cada versão é mapeada para uma versão distinta do Kubernetes.
Clicar em Seguinte.
Configure as definições de rede do cluster. Não pode alterar estas definições de rede depois de criar o cluster. O protocolo de Internet predefinido e único suportado para clusters de utilizadores é a versão 4 do protocolo de Internet (IPv4).
1. Se quiser criar nós do balanceador de carga dedicados, introduza o número de nós a criar. Por predefinição, recebe zero nós e o tráfego do equilibrador de carga é executado através dos nós de controlo.
2. Selecione o CIDR de serviço (Classless Inter-Domain Routing) a usar. Os seus serviços implementados, como equilibradores de carga, têm endereços IP atribuídos a partir deste intervalo.
  
  Importante: o intervalo pode ser qualquer intervalo RFC 1918 que não entre em conflito com outros intervalos de endereços IP nos recursos do cluster e do conjunto de nós. Consulte o documento RFC 1918 para mais informações, mas tenha em atenção que tem de se ligar à Internet para aceder ao URL. Este URL permite o acesso fora do seu ambiente isolado.
3. Selecione o CIDR do agrupamento a usar. O cluster atribui endereços IP deste intervalo aos seus pods e VMs.
4. Clicar em Seguinte.
Reveja os detalhes do conjunto de nós predefinido gerado automaticamente para o cluster de utilizadores. Clique em Editar para modificar o conjunto de nós predefinido.

Importante: se pretender que o cluster de utilizadores execute cargas de trabalho da unidade de processamento de gráficos (GPU), tem de aprovisionar um tipo de máquina de GPU no cluster de utilizadores. Para mais informações, consulte o artigo Suporte cargas de trabalho de GPU num cluster de utilizadores.
Para criar node pools adicionais, selecione Adicionar node pool. Quando edita o node pool predefinido ou adiciona um novo node pool, personaliza-o com as seguintes opções:
1. Atribua um nome ao conjunto de nós. Não pode modificar o nome depois de criar o conjunto de nós.
2. Especifique o número de nós de trabalho a criar no node pool.
3. Selecione a classe de máquinas mais adequada aos requisitos da sua carga de trabalho. Veja a lista das seguintes definições:
  - Tipo de máquina
  - CPU
  - Memória
4. Clique em Guardar.
Clique em Criar para criar o cluster de utilizadores.

API

Para criar um novo cluster de utilizadores diretamente através da API, aplique um recurso personalizado à sua instância do GDC:

Crie um recurso personalizado Cluster e guarde-o como um ficheiro YAML, como cluster.yaml:
```
apiVersion: cluster.gdc.goog/v1
kind: Cluster
metadata:
  name: CLUSTER_NAME
  namespace: platform
spec:
  clusterNetwork:
    podCIDRSize: POD_CIDR
    serviceCIDRSize: SERVICE_CIDR
  initialVersion:
    kubernetesVersion: KUBERNETES_VERSION
  loadBalancer:
    ingressServiceIPSize: LOAD_BALANCER_POOL_SIZE
  nodePools:
  - machineTypeName: MACHINE_TYPE
    name: NODE_POOL_NAME
    nodeCount: NUMBER_OF_WORKER_NODES
    taints: TAINTS
    labels: LABELS
  releaseChannel:
    channel: UNSPECIFIED
```
Substitua o seguinte:
- CLUSTER_NAME: o nome do cluster. O nome do cluster não pode terminar com -system. O sufixo -system está reservado para clusters criados pelo GDC.
- POD_CIDR: o tamanho dos intervalos de rede a partir dos quais os endereços IP virtuais do pod são atribuídos. Se não estiver definida, é usado um valor predefinido de 21.
- SERVICE_CIDR: o tamanho dos intervalos de rede a partir dos quais são atribuídos endereços IP virtuais de serviço. Se não estiver definida, é usado um valor predefinido de 23.
- KUBERNETES_VERSION: a versão do Kubernetes do cluster, como 1.26.5-gke.2100. Para listar as versões do Kubernetes disponíveis para configurar, consulte o artigo Liste as versões do Kubernetes disponíveis para um cluster.
- LOAD_BALANCER_POOL_SIZE: o tamanho dos conjuntos de endereços IP não sobrepostos usados pelos serviços de balanceamento de carga. Se não for definida, é usado um valor predefinido de 20.
- MACHINE_TYPE: o tipo de máquina dos nós de trabalho do node pool. Veja os tipos de máquinas disponíveis para o que está disponível para configuração.
- NODE_POOL_NAME: o nome do node pool.
- NUMBER_OF_WORKER_NODES: o número de nós de trabalho a aprovisionar no conjunto de nós.
- TAINTS: as contaminações a aplicar aos nós deste node pool. Este é um campo opcional.
- LABELS: As etiquetas a aplicar aos nós deste node pool. Contém uma lista de pares de chave-valor. Este é um campo opcional.
Aplique o recurso personalizado à sua instância do GDC:
```
kubectl apply -f cluster.yaml --kubeconfig ADMIN_CLUSTER_KUBECONFIG
```
Substitua ADMIN_CLUSTER_KUBECONFIG pelo caminho do ficheiro kubeconfig do cluster de administrador da organização.

Liste as versões do Kubernetes disponíveis para um cluster

Pode listar as versões do Kubernetes disponíveis na sua instância do GDC usando a CLI kubectl:

kubectl get userclustermetadata.upgrade.private.gdc.goog \
    -o=custom-columns=K8S-VERSION:.spec.kubernetesVersion \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

Substitua ADMIN_CLUSTER_KUBECONFIG pelo caminho do ficheiro kubeconfig do cluster de administrador.

O resultado tem um aspeto semelhante ao seguinte:

K8S-VERSION
1.25.10-gke.2100
1.26.5-gke.2100
1.27.4-gke.500

Suporte recursos de GPU num cluster de utilizadores

O GDC oferece suporte da unidade de processamento gráfico (GPU) da NVIDIA para clusters de utilizadores e executa os seus dispositivos GPU como cargas de trabalho do utilizador. O suporte de GPU está ativado por predefinição para clusters que têm máquinas com GPU aprovisionadas. Certifique-se de que o cluster de utilizadores suporta dispositivos de GPU antes de tirar partido dos contentores de aprendizagem profunda. Por exemplo, se pretender executar contentores de aprendizagem profunda, certifique-se de que cria um cluster de utilizadores com, pelo menos, um nó de GPU.

Os clusters de utilizadores podem ser criados diretamente através da consola ou da API do GDC. Certifique-se de que aprovisiona máquinas de GPU para o cluster de utilizadores de modo a suportar cargas de trabalho de GPU nos respetivos contentores associados. Para mais informações, consulte o artigo Crie um cluster de utilizadores.

Cartões de GPU NVIDIA suportados

Os clusters GDC suportam a GPU NVIDIA A100 PCIe de 80 GB. Para ativar este suporte, aprovisione o tipo de máquina a2-ultragpu-1g-gdc num cluster de utilizador.