Solución de problemas de nodos perimetrales - Container Service for Kubernetes

Resuelva los errores de conexión y actualización en nodos perimetrales al relacionar los mensajes de error con sus causas y soluciones correspondientes.

Si su problema no aparece en la lista, recopile la información de diagnóstico y envíe un ticket.

Gestión de errores de conexión en nodos perimetrales

Si el script de conexión del nodo falla, busque su mensaje de error en la siguiente tabla.

Mensaje de error	Causa	Solución
`The os XXX unsupport`	Versión del sistema operativo no compatible.	Consulte Add an edge node para ver las versiones de sistema operativo compatibles.
`Invalid nodeName`	Nombre de nodo no válido.	Utilice un nombre que contenga solo letras minúsculas, guiones (`-`) y puntos (`.`); tenga entre 1 y 253 caracteres; y no comience con `localhost`.
`Node route overlaps with service cidr`	La ruta del nodo se superpone con el bloque CIDR de pods o el bloque CIDR de servicios.	Vuelva a crear el clúster con bloques CIDR de pods y servicios que no se superpongan con la dirección de NameServer ni con la ruta del nodo.
`response error msg: TOKEN_EXPIRED`	Token de conexión Expired.	Genere un nuevo script de conexión. Compruebe que el reloj del sistema del nodo sea preciso.
`A node named XXX is already exist in the cluster`	Nombre de nodo duplicado en el clúster.	Elimine el nodo duplicado y vuelva a ejecutar el script de conexión.
`error run phase join-node: failed to get cluster info: failed to get cluster-info configmap, Get "https://xx.xxx.xx.xx:6443/api/v1/namespaces/kube-public/configmaps/cluster-info": dial tcp xx.xxx.xx.xx:6443: i/o timeout`	edgeadm no pudo comunicarse con el servidor de API.	edgeadm se conecta al servidor de API mediante dirección IP. Compruebe si las reglas de la lista de control de acceso (ACL) en la instancia de Server Load Balancer (SLB) frente al servidor de API bloquean la dirección IP del nodo.
`error run phase join-node: Install edge-hub failed: Copy file /tmp/edge-hub to /usr/bin/edge-hub fail: open /usr/bin/edge-hub: text file busy \| 40009 \| 40009`	Ya existe un binario de edge-hub en el nodo.	Ejecute `edgeadm reset` y luego vuelva a ejecutar el script de conexión.
`error run phase post-check: timed out waiting for the condition`	Los componentes del sistema no se iniciaron correctamente.	1. Descargue la versión más reciente de edgeadm, ejecute `edgeadm reset` y vuelva a ejecutar el script de conexión. 2. Compruebe que el nodo pueda acceder a todos los endpoints públicos obligatorios; consulte Configure endpoints and IP routing for edge nodes. 3. Si el problema persiste, recopile la información de diagnóstico y envíe un ticket.

Gestión de errores de actualización en nodos perimetrales

Al update an edge node pool, una actualización correcta devuelve This node has been upgraded successfully. De lo contrario, busque su error en la siguiente tabla.

Mensaje de error	Causa	Solución
`edgeadm version xxxx does not match cluster version`	La versión de edgeadm no coincide con la versión del clúster.	1. Compruebe que el plano de control esté actualizado. 2. Verifique que `TARGET_CLUSTER_VERSION` sea correcto.
`node has already been upgraded to xxx`	El nodo ya se encuentra en la versión de destino.	Si algunos componentes no se actualizaron, conserve los registros y envíe un ticket.
`kubelet target version xxxx does not match cluster version xxxx`	La versión de kubelet no coincide con la versión del plano de control.	Si se especificó `kubelet-version`, compruebe que coincida con la versión del plano de control. De lo contrario, envíe un ticket.
`Parameter currentVersion cann't null`	Versión de edgeadm obsoleta.	Descargue la versión más reciente de edgeadm. Rutas de actualización válidas: Kubernetes 1.18 → 1.20 y 1.20 → 1.22.
`upgrade kubelet failed at phase install, recover to previous state.` `error run phase upgrade: xxxx`	La actualización falló, pero la reversión automática se completó correctamente. El estado del nodo no se vio afectado.	Conserve los registros y envíe un ticket.
`upgrade kubelet failed at phase install, recover to previous state` `recover kubelet failed, err: xxx` `error run phase upgrade: xxxx`	Tanto la actualización como la reversión fallaron. El estado del nodo se vio afectado.	Conserve los registros y envíe un ticket.

Recopilación de información de diagnóstico del nodo

Ejecute este script en un nodo perimetral con anomalías para recopilar información de diagnóstico.

Inicie sesión en el nodo perimetral con anomalías.

Descargue el script de diagnóstico.

curl -o /usr/local/bin/diagnose_edge_node.sh https://aliacs-k8s-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/public/diagnose/diagnose_k8s.sh

Otorgue permisos de ejecución al script.

chmod u+x /usr/local/bin/diagnose_edge_node.sh

Vaya al directorio del script.
```
cd /usr/local/bin/
```

Ejecute el script de diagnóstico.

./diagnose_edge_node.sh

Cada ejecución genera un archivo único. Ejemplo de salida:

+ echo 'please get diagnose_1578310147.tar.gz for diagnostics'
please get diagnose_1578310147.tar.gz for diagnostics
+ echo 'Submit the file named diagnose_1578310147.tar.gz to request technical support.'
Submit the file named diagnose_1578310147.tar.gz to request technical support.

Compruebe que el archivo exista.
```
ll
```

Adjunte el archivo .tar.gz cuando envíe un ticket.