Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Iniciando o Kubernetes em Nós Personalizados Existentes

Quando você cria um cluster personalizado, o Rancher pode usar RKE2/K3s para criar um cluster Kubernetes em servidores bare-metal locais, máquinas virtuais locais ou em qualquer nó hospedado por um provedor de infraestrutura.

Para usar esta opção, você precisa ter acesso aos servidores que farão parte do seu cluster Kubernetes. Provisione cada servidor de acordo com os requisitos. Em seguida, execute o comando fornecido na interface do Rancher em cada servidor para convertê-lo em um nó Kubernetes.

Esta seção descreve como configurar um cluster personalizado.

Criando um Cluster com Nós Personalizados

Deseja usar hosts Windows como worker do Kubernetes?

Veja Configurando Clusters Personalizados para Windows antes de começar.

1. Provisione um Host Linux

Inicie a criação de um cluster personalizado provisionando um host Linux. Seu host pode ser:

  • Uma máquina virtual (VM) hospedada na nuvem

  • Uma VM local

  • Um servidor bare-metal

Se você quiser reutilizar um nó de um cluster personalizado anterior, limpe o nó antes de usá-lo em um cluster novamente. Se você reutilizar um nó que não foi limpo, a provisão do cluster pode falhar.

Provisione o host de acordo com os requisitos de instalação e a lista de verificação para clusters prontos para produção.

Cluster somente IPv6

Para um cluster somente IPv6, certifique-se de que seu sistema operacional configure corretamente o arquivo /etc/hosts.

::1       localhost

2. Crie o Cluster Personalizado

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Na página Clusters, clique em Criar.

  3. Clique em Personalizado.

  4. Digite um Nome do Cluster.

  5. Use a seção Configuração do Cluster para configurar o cluster. Para mais informações, consulte Referência de Configuração do Cluster RKE2 e Referência de Configuração do Cluster K3s.

    Nós Windows

    Para saber mais sobre como usar nós Windows como worker do Kubernetes, consulte Iniciando o Kubernetes em Clusters Windows.

  6. Clique em Criar.

    Resultado: A interface redireciona para a página Registro, onde você pode gerar o comando de registro para seus nós.

  7. Em Função do Nó, selecione as funções que você deseja que um nó do cluster preencha. Você deve provisionar pelo menos um nó para cada função: etcd, worker e plano de controle. Um cluster personalizado requer as três funções para concluir a provisão. Para mais informações sobre funções, consulte Funções para Nós em Clusters Kubernetes.

    Servidor bare metal

    Se você planeja dedicar servidores bare metal a cada função, deve provisionar um servidor bare metal para cada função (ou seja, provisionar vários servidores bare metal).

  8. Opcional: Clique em Mostrar Avançado para configurar configurações adicionais, como especificar o(s) endereço(s) IP, substituir o nome do host do nó ou adicionar rótulos ou taints ao nó.

    • Os campos IP Público do Nó e IP Privado do Nó podem aceitar um único endereço ou uma lista de endereços separados por vírgulas (por exemplo: 10.0.0.5,2001:db8::1).
    Cluster Somente IPv6 ou Dual-stack

    • Em clusters somente IPv6 e dual-stack, você deve especificar o endereço IPv6 do nó como o IP Privado do Nó.

  9. Copie o comando exibido na tela para a sua área de transferência.

  10. Faça login no seu host Linux usando seu shell preferido, como PuTTy ou uma conexão de Terminal remoto. Execute o comando copiado para sua área de transferência.

Repita os passos 7-10 se você quiser dedicar hosts específicos a funções específicas de nó. Repita os passos quantas vezes forem necessárias.

Resultado:

O cluster é criado e transita para o estado Atualizando enquanto o Rancher inicializa e provisiona os componentes do cluster.

Você pode acessar seu cluster após seu estado ser atualizado para Ativo.

Clusters Ativos são atribuídos a dois projetos:

  • Default, contendo o namespace default

  • System, contendo os namespaces cattle-system, traefik, kube-public e kube-system

3. Apenas Amazon: Marcar Recursos

Se você configurou seu cluster para usar a Amazon como Provedor de Nuvem, marque seus recursos da AWS com um ID de cluster.

Documentação da Amazon: Marcação de Seus Recursos Amazon EC2

Você pode usar instâncias Amazon EC2 sem configurar um provedor de nuvem no Kubernetes. Você só precisa configurar o provedor de nuvem se quiser usar funcionalidades específicas do provedor de nuvem do Kubernetes. Para mais informações, veja Provedores de Nuvem do Kubernetes

Os seguintes recursos precisam ser marcados com um ClusterID:

  • Nós: Todos os hosts adicionados no Rancher.

  • Sub-rede: A sub-rede usada para o seu cluster

  • Grupo de Segurança: O grupo de segurança utilizado para o seu cluster.

Não marque múltiplos grupos de segurança. Marcar múltiplos grupos gera um erro ao criar o Elastic Load Balancer.

A tag que deve ser utilizada é:

Key=kubernetes.io/cluster/<CLUSTERID>, Value=owned

<CLUSTERID> pode ser qualquer string que você escolher. No entanto, a mesma string deve ser utilizada em todos os recursos que você marcar. Definir o valor da tag como owned informa ao cluster que todos os recursos marcados com <CLUSTERID> são de propriedade e gerenciados por este cluster.

Se você compartilhar recursos entre clusters, pode alterar a tag para:

Key=kubernetes.io/cluster/CLUSTERID, Value=shared

Próximas etapas opcionais

Após criar seu cluster, você pode acessá-lo através da interface do Rancher. Como uma melhor prática, recomendamos configurar essas maneiras alternativas de acessar seu cluster:

  • Acesse seu cluster com a CLI kubectl: Siga estas etapas para acessar clusters com kubectl em sua estação de trabalho. Neste caso, você será autenticado através do proxy de autenticação do servidor Rancher, e então o Rancher o conectará ao cluster downstream. Este método permite que você gerencie o cluster sem a interface do Rancher.

  • Acesse seu cluster com a CLI kubectl, usando o endpoint autorizado do cluster: Siga estas etapas para acessar seu cluster com kubectl diretamente, sem autenticar através do Rancher. Recomendamos configurar este método alternativo para acessar seu cluster, para que, caso você não consiga se conectar ao Rancher, ainda possa acessar o cluster.