Add an edge node - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

Pré-requisitos

Limitações

Verifique se o cluster tem cota de nós suficiente. Para adicionar mais nós, envie uma solicitação de aumento de cota no Quota Center. Consulte Cotas e limites para ver os limites de cota do cluster ACK Edge.
Ao adicionar um nó de borda, configure o grupo de segurança para permitir acesso aos nomes de domínio necessários. Consulte Configuração de acesso à rede pública.

Selecione um sistema operacional compatível para o nó de borda.

Arquitetura do sistema	Versão do sistema	Versão do kernel	Versão do cluster
AMD64/x86_64	Anolis 7.9 e Anolis 8.6	4.19.X	≥ 1.16.9-aliyunedge.1
AMD64/x86_64	Alibaba Cloud Linux 2.1903	4.19.X	≥ 1.20.11-aliyunedge.1
AMD64/x86_64	Alibaba Cloud Linux 3	5.10.X	≥ 1.20.11-aliyunedge.1
AMD64/x86_64	CentOS 7.4, CentOS 7.5, CentOS 7.6, CentOS 7.7, CentOS 7.8 e CentOS 7.9	3.10.X	1.12.6-aliyunedge.1 ≤ versão do cluster ≤ 1.30.7-aliyun.1
AMD64/x86_64	CentOS 8.0 e CentOS 8.2	4.18.X	1.18.8-aliyunedge.1 ≤ versão do cluster ≤ 1.30.7-aliyun.1
AMD64/x86_64	Ubuntu 16.04	4.4.X	1.18.8-aliyunedge.1 ≤ versão do cluster ≤ 1.30.7-aliyun.1
AMD64/x86_64	Ubuntu 18.04	4.15.X	1.12.6-aliyunedge.1 ≤ versão do cluster ≤ 1.30.7-aliyun.1
AMD64/x86_64	Ubuntu 18.04	5.4.X	≥ 1.16.9-aliyunedge.1
AMD64/x86_64	Ubuntu 18.04	5.11.X	≥ 1.18.8-aliyunedge.1
AMD64/x86_64	Ubuntu 20.04	5.4.X	≥ 1.18.8-aliyunedge.1
AMD64/x86_64	Ubuntu 20.04 e Ubuntu 22.04	5.15.X	≥ 1.26.3-aliyun.1
AMD64/x86_64	Ubuntu 24.04	6.8.X	≥ 1.30.7-aliyun.1
AMD64/x86_64	Red Hat Enterprise Linux 8.8 e Red Hat Enterprise Linux 8.10	4.18.X	1.26.3-aliyun.1 ≤ versão do cluster ≤ 1.30.7-aliyun.1
AMD64/x86_64	Kylin V10	4.19.X	≥ 1.26.3-aliyun.1
AMD64/x86_64	UnionTech OS Server 20	4.19.X	≥ 1.26.3-aliyun.1
AMD64/x86_64	Red Hat Enterprise Linux 9.3	5.14.X	≥ 1.30.7-aliyun.1
Arm64	CentOS 8.0	4.19.X	≥ 1.14.8-aliyunedge.1
Arm64	Ubuntu 18.04	4.9.X	1.14.8-aliyunedge.1 ≤ versão do cluster ≤ 1.30.7-aliyun.1
Arm64	Ubuntu 18.04	4.19.X	≥ 1.14.8-aliyunedge.1
Arm64	Ubuntu 20.04	5.10.X	≥ 1.22.15-aliyunedge.1

Para adicionar nós GPU, consulte Adicionar nós GPU.

Adicionar um nó

Kubernetes 1,26 e posteriores

Faça login no console ACK. No painel de navegação à esquerda, clique em Clusters.
Na página Clusters, clique no nome do cluster. No painel de navegação à esquerda, clique em Nodes > Node Pools.
Na página Node Pools, selecione ** > Add Existing Node** na coluna Actions à direita do pool de nós desejado.

Na página Add Existing Edge Node, configure a comunicação nuvem-borda e as opções avançadas.

Nota

Se os parâmetros do console não atenderem aos requisitos, modifique os parâmetros do edgeadm no script gerado. Consulte Lista de parâmetros.

Categoria	Parâmetro	Descrição
Comunicação nuvem-borda	Período de validade do token	Período de validade do script. Padrão: 1 hora. Especifique um período maior para reutilizar o mesmo script na adição de nós em lote.

	Ative modo silencioso	Defina se o modo silencioso será ativado. Durante a adição de um nó de borda, algumas etapas exigem confirmação, como a reinstalação de um runtime existente. Por padrão, todos os prompts são respondidos automaticamente com `yes`.
Avançado	Rótulos de nó	Adiciona rótulos ao novo nó. Se um `rótulo` entrar em conflito com uma `chave de rótulo` do pool de nós, o `rótulo` do pool de nós terá precedência.
	Taints	Adiciona taints ao novo nó.
	Anotações	Adiciona anotaçãoes ao novo nó. Se as `anotações` entrarem em conflito com as `anotações` do pool de nós, as `anotações` do pool de nós terão precedência.
	Sincronização automática de tempo	Quando ativado, o edgeadm executa automaticamente a sincronização de tempo.
	Interface de rede do nó	A interface de rede do host usada para o endereço IP do nó e comunicação da rede de contêineres. Se vazio, usa-se a interface de rede da rota padrão.
	Baixe complementos de	Source para download de imagens de complementos do sistema. Padrão: Rede Pública. Para baixar imagens pela rede interna, adicione o nó a um pool de nós de linha dedicada.
	Diretório de trabalho do runtime	Diretório de trabalho do runtime. Tem efeito apenas quando `manageRuntime` é `true`. Caminho padrão para containerd: /var/lib/containerd.

Após configurar, clique em OK. Na página de resultados, clique em Copy, cole e execute o script no nó de borda.

Depois que o nó de borda ingressar no cluster, o terminal exibirá logs. A última linha de saída confirma a adição bem-sucedida do nó.

I0410 10:54:25.801554    19419 join-node.go:241] [join-node] Config the kubelet service configuration successfully.
I0410 10:54:25.801590    19419 join-node.go:246] [join-node] Adding edge hub static yaml
I0410 10:54:25.801662    19419 join-node.go:279] [join-node] Add edge hub static yaml is ok
I0410 10:54:25.801666    19419 join-node.go:384] [join-node] Start to joining node to cluster.
I0410 10:54:27.338166    19419 join-node.go:393] [join-node] Join node to cluster successfully.
I0410 10:54:27.338214    19419 install.go:151] [install-edgehub] Checking edgehub status
I0410 10:54:37.357405    19419 install.go:156] [install-edgehub] Edgehub is ok
I0410 10:54:37.357421    19419 install.go:86] [install-edgehub] Reconfiguring the kubelet configuration files.
I0410 10:54:37.364387    19419 install.go:103] [install-edgehub] Reconfigure the kubelet configuration files successfully.
I0410 10:54:37.364400    19419 install.go:104] [install-edgehub] Restarting the kubelet.
I0410 10:54:52.626540    19419 install.go:127] [install-edgehub] Restart the kubelet successfully.
I0410 10:54:52.626613    19419 postcheck.go:77] [post-check] Checking docker status
I0410 10:54:52.629194    19419 postcheck.go:86] [post-check] docker is ok
I0410 10:54:52.629208    19419 postcheck.go:92] [post-check] Checking kubelet status
I0410 10:54:52.631661    19419 postcheck.go:100] [post-check] Kubelet is ok
I0410 10:54:52.631671    19419 postcheck.go:106] [post-check] Checking edgehub status
I0410 10:54:52.642345    19419 postcheck.go:113] [post-check] Edgehub is ok
I0410 10:54:52.642356    19419 postcheck.go:129] [post-check] Checking addon kube-proxy status.
I0410 10:54:52.683227    19419 postcheck.go:133] [post-check] kube-proxy is OK.
I0410 10:54:52.683243    19419 postcheck.go:129] [post-check] Checking addon flannel status.
I0410 10:54:52.724501    19419 postcheck.go:133] [post-check] flannel is OK.
I0410 10:54:52.724518    19419 postcheck.go:129] [post-check] Checking addon coredns status.
I0410 10:54:52.764745    19419 postcheck.go:133] [post-check] coredns is OK.
I0410 10:54:52.764763    19419 postcheck.go:165] [post-check] Callback to the OpenAPI.
I0410 10:54:53.014706    19419 postcheck.go:178] [post-check] Callback to the OpenAPI successfully.
I0410 10:54:53.014760    19419 postcheck.go:66] This node joined into the cluster successfully.

Kubernetes anterior à versão 1,26

Faça login no console ACK. No painel de navegação à esquerda, clique em Clusters.
Na página Clusters, clique no nome do cluster. No painel de navegação à esquerda, clique em Nodes > Node Pools.
Na página Node Pools, na coluna Actions do pool de nós desejado, escolha > Add Existing Node.
Na página Add Node, a opção Manual vem selecionada por padrão para adicionar uma instância existente.
Nota
No modo manual, adicione nós ECS na nuvem, nós do Edge Node Service (ENS) e nós on-premises.
1. Clique em Next para configurar os parâmetros de acesso do nó na próxima página. Consulte Lista de parâmetros.
  
  Defina Architecture como AMD64/X86_64 ou ARM64, selecione Use Lightweight Access Mode e defina os parâmetros de acesso no editor JSON. Por exemplo, defina enableIptables, quiet e manageRuntime como true, e especifique kube-proxy, flannel e coredns em allowedClusterAddons.
  
  Nota
  O período de validade do script padrão é de 1 hora. Especifique um período maior para reutilizar o script na adição de nós em lote. Defina o período de validade do script como 0 horas para obter um script sem expiração.
2. Após configurar, clique em Next. Na página Complete, clique em Copy, cole e execute o script no nó de borda.

Lista de parâmetros

Se os parâmetros do console não atenderem aos requisitos, modifique os parâmetros do edgeadm no script gerado conforme descrito abaixo.

Parâmetro	Parâmetro correspondente no console	Descrição	Valor
`quiet`	Ative modo silencioso	Defina se o modo silencioso será ativado. Durante o registro do nó, algumas etapas exigem confirmação, como a reinstalação de um runtime existente.	`true` (padrão): Responde automaticamente `yes` a todos os prompts. `false`: O registro pausa para confirmação e pode ser interrompido.
`manageRuntime`	N/A	Defina se o `edgeadm` detecta e instala o runtime.	`true` (padrão): Detecta e instala o runtime. `false`: Não instale o runtime. Instale o runtime no nó antecipadamente.
`nodeNameOverride`	N/A	O nome do nó.	`""`: Padrão. Usa-se o nome do host. `"XXX"`: O nome do nó será XXX. `""`: Gera uma string aleatória de 6 caracteres. `".XXX"`: Gera uma string aleatória de 6 caracteres com o sufixo XXX.
`allowedClusterAddons`	N/A	Complementos a instalar. Padrão para um nó comum: ["kube-proxy","flannel","coredns"].	Padrão: `["kube-proxy","flannel","coredns"]`.
`gpuVersion`	N/A	Indica se o nó é um nó GPU. Padrão: vazio. Consulte Modelos de GPU para ver as versões de GPU compatíveis.	`""` (padrão): O nó não é adicionado como um nó GPU. Cluster ACK Edges executando Kubernetes 1,26 ou posterior podem adicionar nós GPU NVIDIA sem configurar `gpuVersion`. A ferramenta detecta automaticamente o modelo da GPU e instala os complementos necessários.
`labels`	Rótulos de nó	Rótulo a adicionar quando o nó for registrado. Se esta chave de `rótulo` entrar em conflito com uma `chave de rótulo` do pool de nós, o `rótulo` do pool de nós terá precedência.	`{}`: Nenhum rótulo adicionado.
`annotations`	Anotações	Anotações a adicionar quando o nó for registrado. Se estas `anotações` entrarem em conflito com as `anotações` do pool de nós, as `anotações` do pool de nós terão precedência.	`{}`: Nenhuma anotação adicionada.
`taints`	Taints	Taints a adicionar ao nó.	`[]`
`nodeIface`	N/A	A interface de rede do host, usada para: Obter informações de IP do nó da interface de rede especificada. Interface de rede usada pelo plug-in de rede de contêineres Flannel.	`""`: Se vazio, o kubelet obtém o endereço IP do nó nesta ordem: Pesquisa em /etc/hosts por um registro correspondente ao nome do host. Endereço IP da interface de rede da rota padrão. O Flannel usa a interface de rede da rota padrão.
`runtimeRootDir`	Diretório de trabalho do runtime	Diretório de trabalho do runtime. Tem efeito apenas quando `manageRuntime` é `true`.	`""`: Padrão. Se o runtime for Docker, o caminho padrão é /var/lib/docker. Se o runtime for Containerd, o caminho padrão é /var/lib/containerd.
`imageRepoType`	Baixe componentes de	Source da qual o nó baixa imagens de complementos do sistema.	`""` (padrão): Nós em um pool de nós de linha dedicada baixam imagens da rede interna; nós em um pool de nós comum baixam da rede pública. `public`: Baixa imagens da rede pública. `private`: Baixa imagens da rede interna. O nó deve estar em um pool de nós de linha dedicada.
`selfHostNtpServer`	Sincronização automática de tempo	Indica se a sincronização de tempo foi realizada manualmente.	`false` (padrão): O edgeadm executa automaticamente a sincronização de tempo. `true`: Ignora a sincronização de tempo automática porque ela foi realizada manualmente.
`flannelIface`	Interface de rede do nó	Interface de rede usada pelo Flannel. Use o parâmetro nodeIface em vez deste.	`""` (padrão): O Flannel usa a interface de rede da rota padrão.
`enableIptables`	N/A	Defina se o edgehub ativa a otimização do iptables. Descontinuado na v1.22 e posteriores. Não recomendado.	`false`: A otimização do iptables está desativada.

Referências

Se encontrar problemas ao adicionar um nó de borda, consulte Solucionar problemas de nós de borda.
Para remover um nó de borda não utilizado, consulte Remover um nó de borda.
Consulte Configurar autonomia de nó de borda para ativar a autonomia do nó de borda. As cargas de trabalho nos nós de borda continuam em execução mesmo quando os nós se desconectam da nuvem.