Container Compute Service:Connect to a cluster by using kubectl

kubectl e kubeconfig

O kubectl é a ferramenta padrão de linha de comando para gerenciar o Kubernetes. Use o kubectl para se conectar e gerencie clusters ACS. Um arquivo kubeconfig contém informações sobre clusters, usuários, namespaces e mecanismos de autenticação. O kubectl usa esse arquivo para se conectar ao cluster.

Métodos de conexão

Escolha o método de conexão conforme a localização da máquina cliente do kubectl.

• Conexão via rede pública: use este método quando a máquina cliente estiver na rede pública. O cluster deve ter o acesso público ao API server ativado, o que expõe o API server por meio de um Elastic IP Address (EIP). Para instruções sobre como ativar o acesso público, consulte Control public access to the API server of a cluster.

• Conexão via rede interna: use este método quando apenas o acesso interno for necessário. A máquina cliente do kubectl deve estar na mesma Virtual Private Cloud (VPC) do cluster.

Etapa 1: Instale o kubectl

Instale o kubectl na máquina cliente, de acordo com o sistema operacional e a versão do cluster.

Etapa 2: Configure as credenciais do cluster

Os clusters ACS fornecem dois arquivos kubeconfig com credenciais: um para acesso pela rede pública e outro para a rede interna. Por padrão, o kubectl busca um arquivo chamado config no diretório $HOME/.kube da máquina cliente. Esse arquivo armazena as credenciais de acesso do cluster a ser gerenciado, e o kubectl o utiliza para estabelecer a conexão.

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

2. Na página Clusters, clique em no nome do cluster desejado ou em Details na coluna Actions.

3. Na página Cluster Information, clique em na aba Connection Information. Selecione um kubeconfig temporário ou de longo prazo. Para o temporário, especifique o período de validade.

4. Clique em na aba Internal Access ou Public Access e clique em Copy.

5. Cole o conteúdo no arquivo $HOME/.kube/config do cliente e salve-o.

   Nota: Se o diretório ou o arquivo não existir, crie-o antes de prosseguir.

6. Verifique a conexão listando todos os namespaces:

   kubectl get namespaces

   Saída esperada:

   NAME              STATUS   AGE
   default           Active   4h39m
   kube-node-lease   Active   4h39m
   kube-public       Active   4h39m
   kube-system       Active   4h39m

Perguntas frequentes

Os comandos a seguir usam YOUR_KUBECONFIG_PATH como espaço reservado para o caminho absoluto do arquivo kubeconfig. Por padrão, o kubectl usa o arquivo $HOME/.kube/config para se conectar ao cluster. Para especificar um arquivo kubeconfig diferente, defina a variável de ambiente KUBECONFIG ou use o parâmetro --kubeconfig.

grep client-certificate-data YOUR_KUBECONFIG_PATH |awk '{print $2}' |base64 -d | openssl x509 -noout -text |grep Subject:

        Subject: O=system:users, OU=, CN=1***-1673419473

grep client-certificate-data YOUR_KUBECONFIG_PATH |awk '{print $2}' |base64 -d | openssl x509 -noout -enddate

notAfter=Jan 10 06:44:34 2026 GMT