Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Manutenção de nós de borda offline com edgeadm

Última atualização: Jun 27, 2026

Use o edgeadm. Em implantações cloud-edge, os nós de borda podem ficar offline quando a rede está instável. Se a autonomia do nó estiver ativada, as cargas de trabalho continuam em execução, mas não é possível gerenciá-las pelo console na nuvem. Utilize o edgeadm para alterar Pods, ConfigMaps e Secrets em nós de borda offline em situações de emergência.

  • Reverter uma imagem com falha após uma implantação problemática

  • Corrigir um ConfigMap mal configurado que cause interrupção de serviço

  • Rotacionar um Secret expirado ou comprometido

Importante

As alterações feitas com o edgeadm são locais no nó. Quando o nó se reconecta, o estado da nuvem substitui as mudanças locais. Para alterações permanentes, atualize o cluster a partir da nuvem.

Pré-requisitos

Verifique os seguintes itens:

Limitações

  • O edgeadm destina-se apenas a uso emergencial, quando os nós de borda estiverem offline.

  • É possível modificar apenas três tipos de recursos: Pod, ConfigMap e Secret.

  • As modificações são locais no nó. Por exemplo, uma alteração no ConfigMap afeta somente aquele nó específico, e não outros que utilizem o mesmo ConfigMap.

  • As mudanças não são sincronizadas com a nuvem. Assim que o nó se reconectar, o estado da nuvem sobrescreverá as alterações locais. Para mudanças definitivas, atualize o cluster pela nuvem.

Baixe o edgeadm

Baixe o edgeadm no nó de borda:

export REGION="" INTERCONNECT_MODE="" 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/${CLUSTER_VERSION}/${ARCH}/edgeadm -O edgeadm; chmod u+x edgeadm;

Substitua os seguintes parâmetros:

Parâmetro

Descrição

Exemplo

CLUSTER_VERSION

Versão do cluster ACK Edge. Consulte Notas de versão para versões suportadas do Kubernetes.

1.26.3-aliyun.1

REGION

ID da região do cluster ACK Edge. Consulte Regiões suportadas.

cn-hangzhou

INTERCONNECT_MODE

Tipo de rede para conexão do nó: basic (modo Internet) ou private (modo Express Connect). Use basic para rede pública ou private para circuitos Express Connect.

basic

O comando detecta a arquitetura do nó (amd64 para x86\_64, arm64 para aarch64) e baixa o binário correspondente.

Operações comuns de O&M

Identifique os seguintes valores para os recursos de destino:

Variável

Descrição

Como obter

{pod-name}

Nome do pod a ser modificado

Execute crictl pods no nó

{namespace}

Namespace ao qual o pod pertence

{pod-id}

ID do pod

{configmap-name}

Nome do ConfigMap a ser modificado

Execute ls /etc/kubernetes/cache/kubelet/configmaps.v1.core/{namespace} no nó

{secret-name}

Nome do Secret a ser modificado

Execute ls /etc/kubernetes/cache/kubelet/secrets.v1.core/{namespace} no nó

Edite um modelo de pod

  1. Abra a especificação do pod para edição:

    edgeadm -n {namespace} edit pod {pod-name}
  2. Modifique o modelo do pod, salve e saia.

  3. O pod reinicia automaticamente. Verifique se as alterações tiveram efeito:

    crictl inspectp {pod-id}

Edite um ConfigMap

  1. Abra o ConfigMap para edição, no escopo do pod que o utiliza:

    edgeadm -n {namespace} -p {pod-name} edit configmap {configmap-name}
  2. Modifique o ConfigMap, salve e saia.

  3. O pod reinicia com o ConfigMap atualizado. Para outros pods no mesmo nó que usam este ConfigMap, reinicie-os manualmente:

    crictl stopp {pod-id}
    Nota

    O comando crictl stopp interrompe o pod. O kubelet o reinicia automaticamente.

Edite um Secret

  1. Abra o Secret para edição, no escopo do pod que o utiliza:

    edgeadm -n {namespace} -p {pod-name} edit secret {secret-name}
  2. Modifique o Secret, salve e saia.

  3. O pod reinicia com o Secret atualizado. Caso haja outros pods no mesmo nó utilizando este Secret, reinicie-os manualmente:

    crictl stopp {pod-id}
    Nota

    O comando crictl stopp interrompe o pod. O kubelet o reinicia automaticamente.