Pré-Disponibilidade Geral (Pré-GA): 26-02-2026

B Estabelecer Conexão com o Oracle Kubernetes Engine

Você pode usar a CLI (interface de linha de comando) do OCI para acessar um cluster do Oracle Kubernetes Engine (OKE).

As instruções a seguir pressupõem que um arquivo kubeconfig já esteja disponível.

1. Instale a CLI do OCI.
   • Em Linux ou macOS, informe o seguinte comando:

     bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh

   • No Microsoft Windows, use o instalador .msi vinculado a Instalando a CLI.
   Para obter mais informações sobre a CLI do OCI, consulte Como Trabalhar com a CLI.
2. Instale o kubectl.
   • Em macOS, informe o comando homebrew a seguir.

     brew install kubectl

   • No Linux, digite o seguinte comando curl:

     VERSION=(curl−L−shttps://dl.k8s.io/release/stable.txt)curl−LO"https://dl.k8s.io/release/{VERSION}/bin/linux/amd64/kubectl"; chmod +x kubectl && sudo mv kubectl /usr/local/bin/

   • No Microsoft Windows, use o seguinte comando Chocolatey.

     choco install kubernetes-cli

   Para obter mais informações sobre como instalar o kubectl, consulte Instalar Ferramentas na documentação do Kubernetes.
3. Digite o comando a seguir para configurar suas credenciais da CLI do OCI.

   oci setup config

   Forneça as seguintes informações ao comando.

   • O OCID da tenancy
   • Seu OCID de usuário
   • A região (por exemplo, ap-mumbai-1)
   • Sua chave de API (caminho de impressão digital/chave privada)

   Para obter uma nova chave de API, digite o comando a seguir e selecione Identidade e Segurança e, em seguida, Usuários, Your User Account e, em seguida, Chaves de API para fazer upload da chave pública no console.

   oci setup keys

4. Adicione o arquivo kubeconfig ao caminho padrão, para que ele seja acessível pelo kubectl.
   • No macOS e no Linux, adicione o arquivo kubeconfig ao diretório a seguir.

     ~/.kube/config

   • No Microsoft Windows, adicione o arquivo kubeconfig ao diretório a seguir.

     %USERPROFILE%.kube\config

5. Gere o arquivo kubeconfig para o cluster do Kubernetes.
   1. Na página de cluster no OCI, selecione Ações e Acessar cluster. A janela Acessar cluster é exibida.
   2. Selecione Acesso local.
   3. Selecione Copiar para Comando de acesso ao ponto final público.
   4. Execute o comando copiado para gerar o arquivo kubeconfig.
6. Execute os comandos a seguir para validar a conectividade com o cluster.

   kubectl cluster-info
   kubectl get nodes -o wide
   kubectl get ns

   Os clusters de ponto final privado exigem acesso de rede à rede virtual na nuvem (VCN). Os clusters de pontos finais públicos exigem conectividade com a internet com o ponto final do servidor de API.
7. Se você usar vários perfis do OCI, defina a variável de ambiente a seguir.
   • Linux e macOS: export OCI_CLI_PROFILE=
   • Microsoft Windows: $env:OCI_CLI_PROFILE=""

Se o kubectl retornar um erro 401 ou 403, verifique se as suas políticas de gerenciamento de identidade e acesso (IAM) permitem que você use e gerencie uma família de clusters no compartimento e se seu arquivo kubeconfig foi gerado para o cluster e a região corretos.

Para dimensionar o cluster do OKE, execute as etapas a seguir.

1. Na console do OCI, selecione seu cluster do OKE e, em seguida, selecione Pools de nós.
2. Selecione o pool de nós que deseja dimensionar.
3. No menu Ações, selecione Editar. A página Editar pool de nós é exibida.
4. Faça alterações conforme necessário na contagem de nós ou na forma do nó. Para alterar a forma do nó (que afeta o número de OCPUs e a quantidade de memória), selecione Alterar forma.
5. Selecione Atualizar para confirmar suas alterações.
6. No menu Ações, selecione Nós do ciclo para aplicar a configuração atualizada. A página Nós do ciclo é exibida.
7. Em Opções de ciclismo, selecione Substituir nós. Informe números para Aumento máximo e Aumento máximo indisponível e selecione Nós do ciclo. Quando o estado do pool de nós é atualizado para Ativo, o dimensionamento é concluído.

Como alternativa, se você tiver instalado implantando uma pilha, poderá clicar em Destruir para excluir sua pilha atual na console do OCI. Em seguida, selecione Editar e, em seguida, Editar pilha para editar a definição da pilha e alterar a contagem de nós ou a forma do nó conforme necessário. Selecione Executar aplicação e Salvar alterações para criar uma pilha que use os novos parâmetros.