Todos los productos
Search

Este producto

    Container Service for Kubernetes:Troubleshoot cluster access issues in the ACK console

    Centro de documentos

    Container Service for Kubernetes:Troubleshoot cluster access issues in the ACK console

    Última actualización: Sep 04, 2026

    Resuelva problemas de acceso a clústeres desde la consola, como errores de solicitud del servidor API, fallos al acceder a registros de pods y permisos RBAC de clúster faltantes.

    Errores de solicitud del servidor API del clúster: ErrorQueryClusterNamespace o APIServer.500

    Síntoma

    Al acceder a recursos del clúster en la consola, aparece el mensaje de error "An exception occurred with the request to the cluster's API server" con el código de error ErrorQueryClusterNamespace o APIServer.500. La consola de gestión de clústeres muestra un cuadro de diálogo de error con el mensaje An exception occurred with the request to the cluster's API server, el código de error ErrorQueryClusterNamespace, los detalles failed to query access namespace for user, la URL de solicitud https://192.168.xxx:10885/api/v1/namespaces?limit=300 y el error context deadline exceeded (Client.Timeout exceeded while awaiting headers).

    Causa

    Una configuración o estado anómalo del load balancer del servidor API interrumpe la conectividad entre el plano de control de Container Service y el servidor API del clúster.

    Solución

    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 Cluster Information.

    3. En la pestaña Basic Information, haga clic en el ID de instancia del SLB del servidor API para abrir la consola de SLB.

      • Si la interfaz muestra que the load balancer ID does not exist, significa que el load balancer del servidor API fue eliminado o liberado, y el clúster no se puede recuperar. Consulte Create an ACK managed cluster para volver a crearlo.

      • Si la instancia existe, continúe con el siguiente paso.

    4. Compruebe si el Status del load balancer es Running.

      • De lo contrario, verifique si la instancia está vencida o expirada. Si es así, renuévela y habilítela. Consulte Overdue payments para obtener detalles sobre la facturación de SLB.

      • Si el estado es correcto, continúe con el siguiente paso.

    5. Haga clic en Listeners y compruebe que existan listeners de frontend y backend TCP:6443, y que su Status sea Running.

      • Si no se cumplen estas condiciones, el listener del load balancer del servidor API fue modificado.

        • Si el listener está en estado Disable, selecciónelo y luego haga clic en Enable.

        • Si el listener no existe, siga el procedimiento a continuación.

          Asegúrese de que todos los nodos maestros del clúster estén agregados al grupo de servidores predeterminado; luego cree un listener con frontend y backend configurados en TCP:6443. Establezca el backend en Default Server Group y habilite el listener. Para más detalles sobre cómo agregar un listener, consulte add a TCP listener.

      • Si todo es correcto, continúe con el siguiente paso.

    6. Verifique si el Health Check Status del listener es Healthy.

      • De lo contrario, el backend del load balancer del servidor API presenta anomalías. Realice la solución de problemas como se describe a continuación.

        • En la consola de ACK, vaya a Nodes > Nodes. Para cada nodo maestro, haga clic en su ID de instancia ECS para abrir la consola de ECS y verificar el estado Running.

        • En la consola de ECS, inicie sesión de forma remota en cada nodo maestro y verifique que el contenedor del servidor API se esté ejecutando.

          1. Para iniciar sesión en un nodo maestro, consulte Connection methods.

          2. Compruebe el estado del contenedor del servidor API según el runtime de contenedores.

            • Runtime Docker: Ejecute docker ps | grep kube-apiserver y luego use docker inspect para comprobar el estado del contenedor en la salida.

            • Runtime containerd: Ejecute crictl ps | grep kube-apiserver y luego use crictl inspect para comprobar el estado del contenedor en la salida.

      • Si el estado es correcto, continúe con el siguiente paso.

    7. Verifique si el control de acceso está habilitado para el listener. Si está habilitado, la lista blanca access control del listener del load balancer del servidor API tiene una configuración incorrecta. Agregue el bloque de direcciones 100.104.0.0/16 a la lista blanca. Este bloque corresponde al rango de direcciones de origen que utiliza el plano de control de ACK para acceder internamente al servidor API.

    **Errores de solicitud del servidor API al acceder a registros de pods**

    Si puede acceder a otros recursos del clúster pero falla la obtención de registros de pods, siga estos pasos.

    1. Compruebe si el estado del pod es Running. De lo contrario, consulte Troubleshoot pod issues.

    2. En la página Nodes > Nodes, localice el nodo que aloja el pod y haga clic en su ID de instancia ECS. En la consola de ECS, haga clic en Security Group.

    3. Revise las reglas del security group y asegúrese de que exista acceso entrante desde la VPC por el puerto TCP 10250. Si no es así, consulte add a security group rule.

    La cuenta carece de permisos RBAC de clúster para la operación: ForbiddenQueryClusterNamespace o APISERVER.403

    Síntoma

    Al acceder a la consola, aparece el mensaje de error "The current account has not been granted the required cluster RBAC permissions for this operation" con el código de error ForbiddenQueryClusterNamespace o APISERVER.403. Al consultar namespaces, un cuadro de diálogo de Error muestra "The current account has not been granted the required cluster RBAC permissions for this operation. Please contact the primary account or a permissions administrator for authorization". El mensaje de error en inglés es Forbidden query namespaces con el código de error ForbiddenQueryClusterNamespace.

    Causa

    Su cuenta no tiene los permisos RBAC de clúster necesarios.

    Solución

    1. Inicie sesión en la consola de ACK con una cuenta de Alibaba Cloud o de administrador. En el panel de navegación izquierdo, seleccione Authorizations.

    2. En la pestaña RAM Users, localice al usuario afectado y haga clic en Modify Permissions junto al nombre de usuario.

    3. Haga clic en Add Permissions, seleccione el clúster, el namespace y los permisos correspondientes, y luego haga clic en Submit.

    La cuenta carece de permisos RAM para la operación: StatusForbidden

    Síntoma

    Al acceder a la consola, aparece el error "The current account is not granted the required RAM permissions for this operation" con el código de error StatusForbidden. En la consola de ACK, un cuadro de diálogo de Error muestra "The current account is not granted the required RAM permissions for this operation. Please contact the master account or a RAM administrator for authorization." El mensaje de error es RAM policy Forbidden for action cs:DescribeKubernetesVersionMetadata con el código de error StatusForbidden.

    Causa

    Su cuenta no tiene los permisos RAM necesarios.

    Solución

    1. Inicie sesión en RAM Access Control con una cuenta de Alibaba Cloud o una cuenta con permisos de RAM.

    2. En RAM Access Control, haga clic en Create Authorization y agregue el permiso necesario, como cs:DescribeKubernetesVersionMetadata, según la información de CS que aparece en la página de error. Consulte Grant permissions on clusters and cloud resources by using RAM.