Criar clusters de usuários

Esta página é destinada a administradores da plataforma.

É possível criar clusters de usuário com o console do Centro de gerenciamento Anthos ou com kubectl.

Antes de começar

Verifique se a máquina e os recursos VIP necessários estão registrados pelo operador de infraestrutura antes de criar um cluster.

Centro de gerenciamento

  1. No console do Centro de gerenciamento, abra o menu Clusters.

  2. Na página Clusters, clique em Criar cluster para criar um novo cluster de usuário do Anthos.

  3. Configure o novo cluster de usuário usando a página de Configuração do cluster:

    Adicionar um cluster

  4. Use o botão Adicionar pool de nós para adicionar pools de nós ao cluster. Use o formulário de pool de nós para nomear os pools de nós e atribuí-los a pools de nós.

Depois que o cluster é criado, ele é registrado automaticamente na central de gerenciamento e aparece no painel do cluster imediatamente.

kubectl

Crie os recursos Cluster e NodePool a serem registrados no cluster do administrador com o seguinte comando:

kubectl apply -f USER_CLUSTER_YAML --kubeconfig=ADMIN_KUBECONFIG

Substitua:

  • USER_CLUSTER_YAML: o manifesto YAML para o cluster de usuário e os pools de nós. Veja os exemplos de arquivos de configuração Cluster de usuário e NodePool.
  • ADMIN_KUBECONFIG: o arquivo kubeconfig do cluster de administrador.

Se você estiver usando os arquivos de configuração do cluster de administrador como base para a configuração do cluster de usuário, modifique os seguintes campos no campo de configuração de cluster de usuário:

  • Remova os campos principais sshPrivateKeyPath, privateRegistry, privateRegistryConfigPath e privateRegistryTLSCertPath.
  • Garanta que <cluster-name> sejam consistentes nas configurações.
  • O Cluster.spec.type precisa ser user, diferente do tipo de cluster de um cluster de administrador.
  • Cluster.metadata.namespace precisa ser cluster-<cluster-name>, em que <cluster-name> é o nome do cluster do usuário que está sendo criado.
  • Certifique-se de que Cluster.spec.loadBalancer.vips.controlPlaneVIP e Cluster.spec.loadBalancer.addressPools não se sobreponham à configuração de outros clusters.
  • Cluster.spec.loadBalancer.addressPools contém o intervalo de endereços IP atribuídos a serviços do tipo LoadBalancer. Ele aceita mais de um pool de endereços. Ao criar vários pools de endereços com nomes diferentes, é possível criar serviços e atribuir pools de endereços específicos posteriormente para cada serviço. É necessário adicionar metallb.universe.tf/address-pool: <address-pool-name> à anotação do serviço ao criá-lo. Se, em um estágio posterior, você precisar estender o intervalo usado pelos serviços, adicione outros pools de endereços editando o cluster de usuário: kubectl edit cluster user-cluster-name --kubeconfig admin_kubeconfig -n user-cluster-name. Não é possível alterar addressPools atuais. Veja um exemplo.
  • O Nodepool.metadata.name precisa ter o formato: <cluster-name>-worker-node-pool.
  • Nodepool.metadata.namespace precisa ser cluster-<cluster-name> e metadata.name corresponde ao nome do cluster no cluster.
  loadBalancer:
    addressPools:
    - addresses:
      - 10.200.0.112-10.200.0.119
      name: pool1
    - addresses:
      - 10.200.0.120-10.200.0.121
      name: pool2

Verificar o status do cluster

Pode levar até 15 minutos para que o cluster seja inicializado e esteja pronto. Enquanto aguarda, verifique o status do cluster de usuário com o seguinte comando:

kubectl get Cluster -n cluster-USER_CLUSTER_NAME --kubeconfig=ADMIN_KUBECONFIG

Substitua USER_CLUSTER_NAME pelo nome do cluster que você criou.

Quando o status do cluster é ready, o cluster de usuário é criado e registrado com sucesso no cluster de administrador.

Fazer o download do arquivo kubeconfig

Depois que o cluster de usuário for criado, será possível fazer o download do arquivo kubeconfig no centro de gerenciamento.

  1. No console do Centro de gerenciamento, abra o menu Clusters.
  2. Na página Clusters, clique no nome do cluster.
  3. Na página Configuração do cluster, faça o download do arquivo kubeconfig:
    • Operadores de infraestrutura e administradores de plataforma podem clicar em Fazer download do kubeconfig raiz.
    • Usuários com acesso somente leitura podem clicar em Fazer download do kubeconfig somente leitura.

O download do arquivo kubeconfig é feito no seu sistema.

A seguir