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

Pré-requisitos

Antes de começar:

O plano de controle do cluster ACK Edge deve estar atualizado. Consulte Atualizar um cluster ACK Edge.
Identifique o modo de interconexão do nó de borda: basic (rede pública) ou private (circuitos Express Connect).

Limitações

Restrição	Detalhes
Intervalos de versão compatíveis	Versões 1,18 a 1,24: siga estas etapas. Versões 1,26 a 1,30: envie um ticket para entrar em contato com a equipe do Container Service. Outras versões: sem suporte.
Atualizações sequenciais de versão secundária	Cada atualização avança apenas uma versão secundária. Para migrar da 1,18 para a 1,22, atualize em duas etapas: 1,18 → 1,20 e, em seguida, 1,20 → 1,22.
Diferença de versão entre o plano de controle e os nós de borda	A diferença máxima permitida entre o plano de controle e os nós de borda é de duas versões secundárias. Por exemplo, se o plano de controle estiver na versão 1,22, os nós de borda devem estar pelo menos na 1,20. Mantenha as versões sincronizadas sempre que possível.
Tamanho do lote	Atualize no máximo 20 nós por lote para limitar o impacto operacional.
Nós na nuvem	Consulte Atualizar um pool de nós na nuvem.

Atualizar nós de borda

Siga as etapas correspondentes ao seu runtime de contêiner.

Se o runtime for Docker (atualização para 1,24)

O Kubernetes 1,24 removeu o suporte ao runtime Docker. Migre do Docker para o containerd antes de atualizar para a versão 1,24.

Opção 1 (recomendada): Migração gradual para um novo pool de nós

Crie um pool de nós com containerd. Consulte Gerenciamento de pool de nós de borda.
Migre as cargas de trabalho para o novo pool de nós:
- Defina o pool de nós antigo como não agendável. Consulte Drenagem de nó e status de agendamento.
- Atualize os seletores de nó das cargas de trabalho para usar os rótulos do novo pool.
Desative o pool de nós antigo após migrar todas as cargas de trabalho.

Opção 2: Atualização local

Esta opção reinicia todos os contêineres no nó.

Altere o runtime de contêiner de Docker para containerd.
Drene o nó antes de iniciar a atualização. Consulte Drenagem de nó e status de agendamento.

Atualize cada nó individualmente:

Parâmetro	Descrição	Exemplo
`TARGET_CLUSTER_VERSION`	Versão do Kubernetes do plano de controle atualizado	`1.24.6-aliyunedge.1` — consulte Notas de lançamento das versões suportadas do Kubernetes
`REGION`	ID da região do cluster	`cn-hangzhou` — consulte Regiões suportadas
`INTERCONNECT_MODE`	Tipo de rede: `basic` para rede pública, `private` para circuitos Express Connect	`basic`

export REGION="" INTERCONNECT_MODE="" TARGET_CLUSTER_VERSION=""; export ARCH=$(uname -m | awk '{print ($1 == "x86_64") ? "amd64" : (($1 == "aarch64") ? "arm64" : "amd64")}') INTERNAL=$( [ "$INTERCONNECT_MODE" = "private" ] && echo "-internal" || echo "" ); wget http://aliacs-k8s-${REGION}.oss-${REGION}${INTERNAL}.aliyuncs.com/public/pkg/run/attach/${TARGET_CLUSTER_VERSION}/${ARCH}/edgeadm -O edgeadm; chmod u+x edgeadm;./edgeadm upgrade --interconnect-mode=${INTERCONNECT_MODE} --region=${REGION}

Defina estes parâmetros antes de executar o comando:

Verifique se a atualização foi concluída com êxito. A saída exibirá:
```
This node has been upgraded successfully
```

Se o runtime não for Docker

Atualize cada nó individualmente:

export REGION="" INTERCONNECT_MODE="" TARGET_CLUSTER_VERSION=""; export ARCH=$(uname -m | awk '{print ($1 == "x86_64") ? "amd64" : (($1 == "aarch64") ? "arm64" : "amd64")}') INTERNAL=$( [ "$INTERCONNECT_MODE" = "private" ] && echo "-internal" || echo "" ); wget http://aliacs-k8s-${REGION}.oss-${REGION}${INTERNAL}.aliyuncs.com/public/pkg/run/attach/${TARGET_CLUSTER_VERSION}/${ARCH}/edgeadm -O edgeadm; chmod u+x edgeadm;./edgeadm upgrade --interconnect-mode=${INTERCONNECT_MODE} --region=${REGION}

Defina estes parâmetros antes de executar o comando:

Parâmetro	Descrição	Exemplo
`TARGET_CLUSTER_VERSION`	Versão do Kubernetes do plano de controle atualizado	`1.24.6-aliyunedge.1` — consulte Notas de lançamento das versões suportadas do Kubernetes
`REGION`	ID da região do cluster	`cn-hangzhou` — consulte Regiões suportadas
`INTERCONNECT_MODE`	Tipo de rede: `basic` para rede pública, `private` para circuitos Express Connect	`basic`

Verifique se a atualização foi concluída com êxito. A saída exibirá:

This node has been upgraded successfully

Upgrade success output

Perguntas frequentes

O que fazer se a atualização de um nó de borda falhar?

Se a saída não incluir a mensagem This node has been upgraded successfully, consulte O que fazer se um nó de borda falhar ao ser atualizado durante a atualização de um cluster ACK Edge?.

Próximas etapas

Remover nós de borda se não forem mais necessários.
Configurar autonomia do nó de borda para manter a continuidade dos serviços durante desconexões entre a nuvem e a borda.