Todos los productos
Search
Centro de documentos

Container Service for Kubernetes:Add an edge node

Última actualización: Sep 04, 2026

Agregue un edge node a un edge node pool en un ACK Edge cluster con ECS node s de distintas region es, IDC node s, nodos de otros proveedores de nube o nodos locales en fábricas, tiendas, vehículos y barcos.

Requisitos previos

Se ha creado un ACK Edge cluster.

Límites

  • Asegúrese de que su cluster tenga suficiente quota de nodos. Para agregar más nodos, envíe una solicitud de aumento de cuota en el Quota Center. Consulte Quotas and limits para conocer los límites de quota del ACK Edge cluster.

  • Al agregar un nodo perimetral, configure su security group para permitir el acceso a los nombres de dominio obligatorios. Consulte Public network access configuration.

  • Seleccione una edge node compatible para la edge node.

    Arquitectura del sistema

    Versión del sistema

    Versión del kernel

    Versión del clúster

    AMD64/x86_64

    Anolis 7.9 y 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 y CentOS 7.9

    3.10.X

    1.12.6-aliyunedge.1 ≤ versión del clúster ≤ 1.30.7-aliyun.1

    AMD64/x86_64

    CentOS 8.0 y CentOS 8.2

    4.18.X

    1.18.8-aliyunedge.1 ≤ versión del clúster ≤ 1.30.7-aliyun.1

    AMD64/x86_64

    Ubuntu 16.04

    4.4.X

    1.18.8-aliyunedge.1 ≤ versión del clúster ≤ 1.30.7-aliyun.1

    AMD64/x86_64

    Ubuntu 18.04

    4.15.X

    1.12.6-aliyunedge.1 ≤ versión del clúster ≤ 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 y 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 y Red Hat Enterprise Linux 8.10

    4.18.X

    1.26.3-aliyun.1 ≤ versión del clúster ≤ 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 ≤ versión del clúster ≤ 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 agregar nodos GPU, consulte Add GPU nodes.

Agregar un nodo

Kubernetes 1.26 y versiones posteriores

  1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.

  2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Nodes > Node Pools.

  3. En la página Node Pools, seleccione **Icon > Add Existing Node** en la columna Actions a la derecha del node pool objetivo.

  4. En la página Add Existing Edge Node, configure la comunicación nube-periferia y las opciones avanzadas.

    Nota

    Si los parámetros de la consola no cumplen con sus requisitos, modifique los parámetros de edgeadm en el script generado. Consulte Parameter list.

    Categoría

    Parámetro

    Descripción

    Comunicación nube-periferia

    Periodo de validez del token

    Periodo de validez del script. Valor predeterminado: 1 hora.

    Especifique un periodo de validez más largo para reutilizar el mismo script al agregar nodos por lotes.

    Habilitar modo silencioso

    Indica si se debe habilitar el modo silencioso.

    Al agregar un edge node, algunos pasos requieren confirmación, como decidir si se reinstala un runtime existente.

    De forma predeterminada, todas las solicitudes de confirmación se responden automáticamente con yes.

    Avanzado

    Etiquetas de nodo

    Agrega labels al nuevo nodo.

    Si una label entra en conflicto con una label key del node pool, la label del node pool tiene prioridad.

    Taints

    Agrega taints al nuevo nodo.

    Annotations

    Agrega annotations al nuevo nodo.

    Si las annotations entran en conflicto con las annotations del node pool, las annotations del node pool tienen prioridad.

    Sincronización automática de hora

    Cuando está habilitada, edgeadm realiza automáticamente la sincronización de hora.

    Interfaz de red del nodo

    La interfaz de red del host para la dirección IP del nodo y la comunicación de red de contenedores. Si se deja vacío, se utiliza la interfaz de red de la ruta predeterminada.

    Descargar complementos desde

    Origen para descargar imágenes de complementos del sistema. Valor predeterminado: Public Network.

    Para descargar imágenes a través de la red interna, agregue el nodo a un leased line node pool.

    Directorio de trabajo del runtime

    Directorio de trabajo del runtime. Solo surte efecto cuando manageRuntime es true.

    Ruta predeterminada para containerd: /var/lib/containerd.

  5. Después de configurar, haga clic en OK. En la página de resultados, haga clic en Copy, luego pegue y ejecute el script en el nodo perimetral.

    Una vez que el cluster se une al cluster, la terminal muestra registros. La última línea de salida confirma que el nodo se agregó correctamente.

    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 a la versión 1.26

  1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.

  2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Nodes > Node Pools.

  3. En la página Node Pools, en la columna Actions del node pool objetivo, elija Icon > Add Existing Node.

  4. En la página Add Node, la opción Manual está seleccionada de forma predeterminada para agregar una instance existente.

    Nota

    En el modo manual, agregue ECS node s en la nube, nodos de Edge Node Service (ENS) y nodos locales.

    1. Haga clic en Next para configurar los parámetros de acceso del nodo en la siguiente página. Consulte Parameter list.

      Establezca Architecture en AMD64/X86_64 o ARM64, seleccione Use Lightweight Access Mode y luego configure los parámetros de acceso en el editor JSON. Por ejemplo, establezca enableIptables, quiet y manageRuntime en true, y especifique kube-proxy, flannel y coredns en allowedClusterAddons.

      Nota

      El periodo de validez del script predeterminado es de 1 hora. Especifique un periodo más largo para reutilizar el script al agregar nodos por lotes. Establezca el periodo de validez del script en 0 horas para obtener un script sin caducidad.

    2. Después de configurar, haga clic en Next. En la página Complete, haga clic en Copy, luego pegue y ejecute el script en el nodo perimetral.

Lista de parámetros

Si los parámetros de la consola no cumplen con sus requisitos, modifique los parámetros de edgeadm en el script generado como se describe a continuación.

Parámetro

Parámetro correspondiente en la consola

Descripción

Valor

quiet

Habilitar modo silencioso

Indica si se debe habilitar el modo silencioso. Durante el registro del nodo, algunos pasos requieren confirmación, como decidir si se reinstala un runtime existente.

  • true (predeterminado): Responde automáticamente yes a todas las solicitudes de confirmación.

  • false: El registro se pausa para solicitar confirmación y puede interrumpirse.

manageRuntime

N/A

Indica si edgeadm detecta e instala el runtime.

  • true (predeterminado): Detecta e instala el runtime.

  • false: No instala el runtime. Instale el runtime en el nodo previamente.

nodeNameOverride

N/A

Nombre del nodo.

  • "": Predeterminado. Se utiliza el nombre del host.

  • "XXX": El nombre del nodo es XXX.

  • "*": Se genera una cadena aleatoria de 6 caracteres.

  • "*.XXX": Se genera una cadena aleatoria de 6 caracteres con el sufijo XXX.

allowedClusterAddons

N/A

Complementos a instalar. Valor predeterminado para un nodo estándar: ["kube-proxy","flannel","coredns"].

Valor predeterminado: ["kube-proxy","flannel","coredns"].

gpuVersion

N/A

Indica si el nodo es un GPU node. Valor predeterminado: vacío.

Consulte GPU models para conocer las versiones de GPU compatibles.

"" (predeterminado): El nodo no se agrega como GPU node.

Los ACK Edge clusters que ejecutan Kubernetes 1.26 o versiones posteriores pueden agregar nodos GPU NVIDIA sin configurar gpuVersion. La herramienta detecta automáticamente el modelo de GPU e instala los complementos obligatorios.

labels

Etiquetas de nodo

Etiqueta que se agrega cuando se registra el nodo. Si esta clave de label entra en conflicto con una label key del node pool, la label del node pool tiene prioridad.

{}: No se agregan labels.

annotations

Annotations

Annotations que se agregan cuando se registra el nodo. Si estas annotations entran en conflicto con las annotations del node pool, las annotations del node pool tienen prioridad.

{}: No se agregan annotations.

taints

Taints

Taints que se agregan al nodo.

[]

nodeIface

N/A

La interfaz de red del host, que se utiliza para:

  • Obtener información de la IP del nodo desde la interfaz de red especificada.

  • Interfaz de red utilizada por el complemento de red de contenedores Flannel.

"": Si está vacío, kubelet obtiene la dirección IP del nodo en este orden:

  • Busca en /etc/hosts un registro que coincida con el nombre del host.

  • Dirección IP de la interfaz de red de la ruta predeterminada.

Flannel utiliza la interfaz de red de la ruta predeterminada.

runtimeRootDir

Directorio de trabajo del runtime

Directorio de trabajo del runtime. Solo surte efecto cuando manageRuntime es true.

"": Valor predeterminado.

  • Si el runtime es Docker, la ruta predeterminada es /var/lib/docker.

  • Si el runtime es Containerd, la ruta predeterminada es /var/lib/containerd.

imageRepoType

Descargar componentes desde

Origen desde el cual el nodo descarga las imágenes de complementos del sistema.

  • "" (predeterminado): Los nodos en un leased line node pool descargan imágenes desde la red interna; los nodos en un node pool regular descargan desde la red pública.

  • public: Descarga imágenes desde la red pública.

  • private: Descarga imágenes desde la red interna. El nodo debe estar en un leased line node pool.

selfHostNtpServer

Sincronización automática de hora

Indica si la sincronización de hora se realizó manualmente.

  • false (predeterminado): edgeadm realiza automáticamente la sincronización de hora.

  • true: Omite la sincronización de hora automática porque ya se realizó manualmente.

flannelIface

Interfaz de red del nodo

Interfaz de red utilizada por Flannel. Utilice el parámetro nodeIface en su lugar.

"" (predeterminado): Flannel utiliza la interfaz de red de la ruta predeterminada.

enableIptables

N/A

Indica si edgehub habilita la optimización de iptables. Obsoleto en v1.22 y versiones posteriores. No se recomienda.

false: La optimización de iptables está deshabilitada.

Referencias