Todos os produtos
Search

Este produto

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

    Central de documentação

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

    Última atualização: Aug 20, 2026

    Resolva problemas de acesso ao cluster no console, como erros de requisição ao API server, falhas ao acessar logs de pods e ausência de permissões RBAC no cluster.

    Erros de requisição ao API server do cluster: ErrorQueryClusterNamespace ou APIServer.500

    Sintoma

    Ao acessar recursos do cluster no console, a mensagem de erro 'An exception occurred with the request to the cluster's API server' é exibida com o código de erro ErrorQueryClusterNamespace ou APIServer.500. O console de gerenciamento do cluster apresenta uma caixa de diálogo de erro com a mensagem An exception occurred with the request to the cluster's API server, código de erro ErrorQueryClusterNamespace, detalhes failed to query access namespace for user, URL da requisição https://192.168.xxx:10885/api/v1/namespaces?limit=300 e erro context deadline exceeded (Client.Timeout exceeded while awaiting headers).

    Causa

    Uma configuração anormal ou um problema no status do balanceador de carga do API server interrompe a conectividade entre o plano de controle do Container Service e o API server do cluster.

    Solução

    1. Faça login no console do ACK. No painel de navegação à esquerda, clique em Clusters.

    2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Cluster Information.

    3. Na aba Basic Information, clique no ID da instância SLB do API server para abrir o console do SLB.

      • Se a interface indicar que the load balancer ID does not exist, o balanceador de carga do API server foi excluído ou liberado, e não é possível recuperar o cluster. Consulte Create an ACK managed cluster para recriá-lo.

      • Caso a instância exista, prossiga para a próxima etapa.

    4. Verifique se o Status do balanceador de carga está como Running.

      • Se não estiver, verifique se a instância está vencida ou expirada. Nesse caso, renove-a e ative-a. Consulte Overdue payments para obter detalhes sobre o faturamento do SLB.

      • Se estiver correto, continue para a próxima etapa.

    5. Clique em Listeners e verifique se existem listeners de frontend e backend na porta TCP:6443 e se o Status está como Running.

      • Caso contrário, o listener do balanceador de carga do API server foi modificado.

        • Se o listener estiver no estado Disable, selecione-o e clique em Enable.

        • Se o listener não existir, siga o procedimento abaixo.

          Certifique-se de que todos os nós mestre do cluster estejam adicionados ao grupo de servidores padrão e crie um listener com frontend e backend definidos como TCP:6443. Defina o backend como Default Server Group e ative o listener. Para mais detalhes sobre como adicionar um listener, consulte add a TCP listener.

      • Se estiver tudo correto, prossiga para a próxima etapa.

    6. Confira se o Health Check Status do listener está como Healthy.

      • Se não estiver, o backend do balanceador de carga do API server apresenta anomalias. Realize a solução de problemas conforme descrito a seguir.

        • No console do ACK, acesse Nodes > Nodes. Para cada nó mestre, clique no ID da instância ECS correspondente para abrir o console do ECS e verifique o status Running.

        • No console do ECS, faça login remoto em cada nó mestre e verifique se o contêiner do API Server está em execução.

          1. Para fazer login em um nó mestre, consulte Connection methods.

          2. Verifique o status do contêiner do API server com base no runtime de contêiner utilizado.

            • Runtime docker: Execute docker ps | grep kube-apiserver e use docker inspect para verificar o status do contêiner na saída do comando.

            • Runtime containerd: Execute crictl ps | grep kube-apiserver e use crictl inspect para verificar o status do contêiner na saída do comando.

      • Se estiver saudável, continue para a próxima etapa.

    7. Verifique se o controle de acesso está ativado para o listener. Se estiver ativado, a lista de permissões de access control do listener do balanceador de carga do API server está configurada incorretamente. Adicione o bloco de endereços 100.104.0.0/16 à lista de permissões. Esse bloco corresponde ao intervalo de endereços de source que o plano de controle do ACK utiliza para acessar internamente o API server.

    **Erros de requisição ao API server ao acessar logs de pods**

    Se outros recursos do cluster estiverem acessíveis, mas os logs dos pods falharem, siga estas etapas.

    1. Verifique se o status do pod está como Running. Caso contrário, consulte Troubleshoot pod issues.

    2. Na página Nodes > Nodes, localize o nó que hospeda o pod e clique no ID da instância ECS correspondente. No console do ECS, clique em Security Group.

    3. Revise as regras do grupo de segurança e garanta o acesso de entrada via VPC na porta TCP 10250. Se não estiver configurado, consulte add a security group rule.

    A conta não possui permissões RBAC do cluster para a operação: ForbiddenQueryClusterNamespace ou APISERVER.403

    Sintoma

    Ao acessar o console, a mensagem de erro "The current account has not been granted the required cluster RBAC permissions for this operation" é exibida com o código de erro ForbiddenQueryClusterNamespace ou APISERVER.403. Ao consultar namespaces, uma caixa de diálogo de Error exibe "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". A mensagem de erro em inglês é Forbidden query namespaces com o código de erro ForbiddenQueryClusterNamespace.

    Causa

    Sua conta não possui as permissões RBAC necessárias no cluster.

    Solução

    1. Faça login no console do ACK com uma conta Alibaba Cloud ou de administrador. No painel de navegação à esquerda, escolha Authorizations.

    2. Na aba RAM Users, localize o usuário afetado e clique em Modify Permissions ao lado do nome de usuário.

    3. Clique em Add Permissions, selecione o cluster, o namespace e as permissões desejadas e clique em Submit.

    A conta não possui permissões RAM para a operação StatusForbidden

    Sintoma

    Ao acessar o console, o erro "The current account is not granted the required RAM permissions for this operation" aparece com o código StatusForbidden. No console do ACK, uma caixa de diálogo de Error mostra "The current account is not granted the required RAM permissions for this operation. Please contact the master account or a RAM administrator for authorization." A mensagem de erro é RAM policy Forbidden for action cs:DescribeKubernetesVersionMetadata com o código de erro StatusForbidden.

    Causa

    Sua conta não possui as permissões RAM necessárias.

    Solução

    1. Faça login no RAM Access Control com uma conta Alibaba Cloud ou uma conta com permissões RAM.

    2. No RAM Access Control, clique em Create Authorization e adicione a permissão necessária, como cs:DescribeKubernetesVersionMetadata, com base nas informações do CS apresentadas na página de erro. Consulte Grant permissions on clusters and cloud resources by using RAM.