Migrando para Clusters Nativos de VCN

Para migrar um cluster existente para integrar seu ponto final da API do Kubernetes à sua própria VCN:

1. Abra o menu de navegação e selecione Serviços ao Desenvolvedor. Em Contêineres e Artefatos, selecione Clusters do Kubernetes (OKE).

2. Escolha um Compartimento no qual você tem permissão para trabalhar.

   Os labels de Migração obrigatória aparecem na página Lista de Clusters ao lado dos nomes de clusters com pontos finais da API do Kubernetes que não estão integrados à sua VCN.

3. Na página Lista de clusters, selecione o nome do cluster que você deseja migrar.

   Quando você seleciona um cluster que pode migrar, o botão Migrar Cluster é exibido na parte superior da página Detalhes do Cluster.

4. Se você quiser que o ponto final da API do Kubernetes do cluster seja acessível publicamente pela internet e hospedado em uma nova sub-rede pública na mesma VCN do cluster (criando e configurando novos recursos de rede conforme necessário), execute uma Migração Automática da seguinte forma:
   1. Na parte superior da página Detalhes do Cluster, selecione Migrar Cluster para integrar o ponto final da API do Kubernetes do cluster à sua própria VCN.
   2. Na caixa de diálogo Migrar para Cluster Nativo da VCN, selecione Migração Automática para criar uma nova sub-rede regional na VCN do cluster com um bloco CIDR 10.0.0.0/28, juntamente com listas de segurança e tabelas de roteamento.
   3. Selecione Iniciar Workflow e revise o resumo da migração na caixa de diálogo Migração de Cluster de Pontos Finais Nativos da VCN.
   4. Selecione Migrar para criar novos recursos de rede e migrar o cluster.

      O Kubernetes Engine começa a migrar o cluster, conforme mostrado na caixa de diálogo Migrando Cluster.

   5. Selecione Fechar para fechar a caixa Migrando Cluster.
5. Se você quiser que o ponto final da API do Kubernetes do cluster seja acessível de forma privada dentro da sua VCN ou acessível publicamente pela internet e hospedado em uma sub-rede pública ou privada regional existente na mesma VCN do cluster, execute uma Migração Personalizada da seguinte forma:
   1. Confirme se os seguintes recursos de rede já existem na VCN e estão configurados corretamente para hospedar o ponto final da API do Kubernetes (caso contrário, crie-os e configure-os adequadamente):
      • uma sub-rede pública ou privada regional (consulte Configuração da Sub-rede do Ponto Final da API do Kubernetes)
      • se a sub-rede for pública, um gateway de internet (consulte Configuração do Gateway de Internet)
      • se a sub-rede for privada, um gateway NAT (consulte Configuração do Gateway NAT) e um gateway de serviço (consulte Configuração do Gateway de Serviço)
      • uma tabela de roteamento com as regras de roteamento necessárias (consulte Tabela de Roteamento para Sub-redes de Ponto Final da API do Kubernetes)
      • um grupo de segurança de rede (recomendado) e/ou uma lista de segurança com as regras de entrada e saída necessárias (consulte Regras de Segurança para o Ponto Final da API do Kubernetes)

      Por exemplo, configurações, consulte Exemplo de Configurações de Recursos de Rede.

   2. Na parte superior da página Detalhes do Cluster, selecione Migrar Cluster para integrar o ponto final da API do Kubernetes do cluster à sua própria VCN.
   3. Na caixa de diálogo Migrar para Cluster Nativo da VCN, selecione Migração Personalizada.
   4. Selecione Iniciar Workflow e especifique:
      • Sub-rede de Ponto Final da API do Kubernetes: Uma sub-rede regional para hospedar o ponto final da API do Kubernetes do cluster. A sub-rede especificada pode ser pública ou privada. O ponto final de API do Kubernetes sempre recebe um endereço IP privado. Se você especificar uma sub-rede pública, poderá opcionalmente expor o ponto final da API do Kubernetes à internet designando um endereço IP público ao ponto final (bem como o endereço IP privado). Para simplificar o gerenciamento de acesso, a Oracle recomenda que o ponto final da API do Kubernetes esteja em outra sub-rede para nós de trabalho e balanceadores de carga. Para obter mais informações, consulte Plano de Controle de Cluster do Kubernetes e API do Kubernetes.
      • Usar grupos do serviço network security para controlar tráfego: Opcionalmente, restrinja o acesso ao ponto de extremidade da API do Kubernetes do cluster usando um ou mais grupos do serviço network security (NSGs) que você especificar. Para obter mais informações sobre as regras de segurança que devem ser especificadas para o NSG, consulte Regras de Segurança do Ponto Final da API do Kubernetes.
      • Designar um endereço IP público ao ponto de extremidade da API: Se você tiver selecionado uma sub-rede pública para o ponto de extremidade da API do Kubernetes, poderá, opcionalmente, expor o ponto de extremidade à internet designando um endereço IP público ao ponto de extremidade (assim como o endereço IP privado) Se você não designar um endereço IP público, atualize as regras de roteamento e as regras de segurança para permitir o acesso ao ponto final usando um gateway de serviço e um gateway NAT (consulte Configuração da Sub-rede de Ponto Final da API do Kubernetes).
   5. Selecione Migrar para criar novos recursos de rede e migrar o cluster.

      O Kubernetes Engine começa a migrar o cluster.

A migração geralmente leva cerca de 15 minutos para ser concluída. Durante esse tempo, a API do Kubernetes continua acessível por meio do ponto final público que não está integrado à sua própria VCN. No entanto, as operações do ciclo de vida do cluster (como atualizações do cluster, criação e exclusão do pool de nós) não estão disponíveis.

Quando a migração é concluída, a página Detalhes do Cluster mostra o nome da Sub-rede de Ponto Final da API do Kubernetes, o endereço IP do Ponto Final Privado da API do Kubernetes e (se você tiver designado um endereço IP público ao ponto final da API do Kubernetes) o endereço IP do Ponto Final Público da API do Kubernetes.

A página Detalhes do Cluster também indica que você tem 30 dias para atualizar a configuração do seu kubectl, ferramentas e pipelines CI/CD para acessar o novo ponto final da API do Kubernetes (consulte Configurando o Acesso a um Cluster Migrado). Durante esse período de desativação, o cluster recém-migrado pode ser acessado por meio do novo ponto final da API do Kubernetes na sua VCN e por meio do ponto final público da API do Kubernetes que não está integrado à sua própria VCN.

Depois de migrar um cluster para integrar seu ponto final da API do Kubernetes à sua própria VCN, você precisa atualizar a configuração de seus pipelines de kubectl, ferramentas e CI/CD para usar o novo ponto final da API do Kubernetes. No mínimo, você desejará atualizar o arquivo de configuração do Kubernetes do cluster (comumente conhecido como o arquivo 'kubeconfig') para permitir o acesso ao cluster migrado usando o kubectl, conforme descrito neste tópico. Você também precisa atualizar quaisquer arquivos de manifesto que incluam referências ao endereço IP do ponto final da API do Kubernetes do cluster.

Siga as instruções deste tópico para gerar um novo arquivo kubeconfig. Essas instruções pressupõem que o arquivo kubeconfig do cluster seja salvo no local padrão ($HOME/.kube) e com o nome padrão (config). Se não for esse o caso, adapte as instruções em conformidade.

1. Na janela do terminal em que você normalmente executa comandos da CLI do Oracle Cloud Infrastructure, execute o seguinte comando para atualizar o arquivo kubeconfig existente do cluster:

   oci ce cluster create-kubeconfig --cluster-id <cluster-ocid> --file <kubeconfig-file-location> --region <region-name> --token-version 2.0.0 --kube-endpoint PRIVATE_ENDPOINT|PUBLIC_ENDPOINT

   em que:

   • --cluster-id <cluster-ocid> é o OCID do cluster existente que você deseja tornar nativo da VCN.
   • --file <kubeconfig-file-location> é o local do arquivo kubeconfig do cluster.
   • --region <region-name> é a região na qual o cluster está localizado.
   • --kube-endpoint PRIVATE_ENDPOINT|PUBLIC_ENDPOINT especifica se o endereço IP privado ou o endereço IP público do ponto final da API do Kubernetes do cluster será adicionado ao arquivo kubeconfig. Para obter mais informações, consulte Plano de Controle de Cluster do Kubernetes e API do Kubernetes.

   Por exemplo:

   oci ce cluster create-kubeconfig --cluster-id ocid1.cluster.oc1.phx.aaaaaaaaae... --file $HOME/.kube/config --region us-phoenix-1 --token-version 2.0.0 --kube-endpoint PUBLIC_ENDPOINT

   Supondo que o arquivo kubeconfig já exista no local especificado, os detalhes do cluster serão adicionados como um novo contexto ao arquivo kubeconfig existente, incluindo o novo ponto final da API do Kubernetes do cluster na sua própria VCN. O elemento current-context: no arquivo kubeconfig é definido para apontar para o contexto adicionado recentemente.

   Para obter mais informações sobre a configuração do arquivo kubeconfig, consulte Configurando o Acesso ao Cluster.

2. Verifique se o kubectl pode estabelecer conexão com o cluster usando o ponto final da API do Kubernetes em sua própria VCN digitando o seguinte comando:

   kubectl get nodes

   São mostradas informações sobre os nós do cluster.

   Agora você pode usar o kubectl para executar operações no cluster usando o ponto final da API do Kubernetes na sua própria VCN.