Como instalar o Migrate for Anthos and GKE

Este tópico descreve como instalar o Migrate for Anthos and GKE em um cluster de processamento.

Um cluster de processamento é um cluster do Google Kubernetes Engine (GKE) ou do Anthos com os componentes do Migrate for Anthos and GKE instalados que é usado para migrar as VMs antes de implantá-las no cluster de produção.

Ao seguir as etapas deste tópico, use a ferramenta de linha de comando migctl ou o Console do Google Cloud para instalar os componentes necessários do Migrate for Anthos and GKE em um cluster do GKE já criado.

Depois de implantar as VMs migradas como imagens em um cluster de produção (presumindo que o cluster de processamento não seja mais necessário para realizar novas migrações), exclua o cluster de processamento.

Sobre o migctl

Além do suporte no Console do Google Cloud, o Migrate for Anthos and GKE inclui a ferramenta de linha de comando migctl, que pode ser usada para executar todas as partes de uma migração:

Antes de começar

Como instalar o Migrate for Anthos and GKE

migctl no Google Cloud

Use comandos migctl para instalar o Migrate for Anthos and GKE e configurar nele os recursos básicos necessários para a migração.

  1. Verifique se você criou uma conta de serviço para acessar o Container Registry e o Cloud Storage e faça o download do arquivo de chave JSON, conforme descrito em Como configurar uma conta de serviço.

  2. Acesse o menu do GKE no Console do Cloud.

    Acesse o menu do GKE

  3. Na lista de clusters, localize o cluster que você usará como um cluster de processamento e clique no botão Conectar.

  4. Na caixa de diálogo Conectar ao cluster em Acesso à linha de comando, clique em Executar no Cloud Shell para executar o comando de conexão no Cloud Shell.

    gcloud container clusters get-credentials my-cluster --zone us-central1-c --project my-project

  5. Configure os componentes do Migrate for Anthos and GKE no cluster de processamento executando o comando migctl setup install no Cloud Shell e especificando a conta de serviço de instalação:

    migctl setup install --json-key=m4a-install.json

  6. Valide a instalação do Migrate for Anthos and GKE executando o comando migctl doctor.

    Antes de concluir a instalação, poderá ser exibida uma mensagem como a seguinte. Neste caso, aguarde alguns minutos para que a instalação seja concluída antes de executar migctl doctor.

    migctl doctor
[!] Deployment
    Validation checks failed.

    Neste exemplo de saída, a marca de seleção indica que o Migrate for Anthos and GKE foi implantado com sucesso e que os repositórios de dados necessários foram configurados.

    migctl doctor
[✓] Deployment
[✓] Docker registry
[✓] Artifacts repo
[!] Source Status

    Consulte Como definir repositórios de dados se houver um erro associado ao registro do Docker ou ao repositório de artefatos.

migctl no VMware

  1. Defina o ID do projeto padrão: 
    gcloud config set project project-id
  2. Implante o migctl na estação de trabalho de administrador: 
    wget https://anthos-migrate-release.storage.googleapis.com/v1.8.0/linux/amd64/migctl
sudo cp migctl /usr/local/bin/
sudo chmod +x /usr/local/bin/migctl
. <(migctl completion bash)
  3. Para configurar os componentes do Migrate for Anthos and GKE no cluster de processamento, execute o comando migctl setup install: 
    migctl setup install --gkeop
  4. Valide a instalação do Migrate for Anthos and GKE executando o comando migctl doctor. Antes de concluir a instalação, poderá ser exibida uma mensagem como a seguinte. Neste caso, aguarde alguns minutos para que a instalação seja concluída antes de executar migctl doctor. 
    migctl doctor
  [!] Deployment
      Validation checks failed.
    Neste exemplo de saída, a marca de seleção indica que o Migrate for Anthos and GKE foi implantado com sucesso, mas você ainda não configurou os repositórios de dados necessários: 
    migctl doctor
  [✓] Deployment
  [!] Docker registry
  [!] Artifacts repo
  [!] Source Status
  5. Configure os repositórios de dados exigidos pelo cluster, conforme descrito em Como definir repositórios de dados.
  6. Se necessário, configure um proxy HTTPS para acesso de saída à Internet, conforme descrito em Como configurar um proxy HTTPS.

migctl no AWS

Para este procedimento, é necessário executar migctl no cluster. Dependendo da conectividade da sua estação de trabalho com o cluster, talvez seja necessário abrir um túnel para o host bastion. Consulte Como se conectar ao serviço de gerenciamento para saber mais.

  1. Defina o ID do projeto padrão: 
    gcloud config set project project-id
  2. Implante o migctl na estação de trabalho de administrador: 
    wget https://anthos-migrate-release.storage.googleapis.com/v1.8.0/linux/amd64/migctl
sudo cp migctl /usr/local/bin/
sudo chmod +x /usr/local/bin/migctl
. <(migctl completion bash)
  3. Para configurar os componentes do Migrate for Anthos and GKE no cluster de processamento, execute o comando migctl setup install: 
    migctl setup install --gke-on-aws
  4. Valide a instalação do Migrate for Anthos and GKE executando o comando migctl doctor. Antes de concluir a instalação, poderá ser exibida uma mensagem como a seguinte. Neste caso, aguarde alguns minutos para que a instalação seja concluída antes de executar migctl doctor. 
    migctl doctor
  [!] Deployment
      Validation checks failed.
    Neste exemplo de saída, a marca de seleção indica que o Migrate for Anthos and GKE foi implantado com sucesso, mas você ainda não configurou os repositórios de dados necessários: 
    migctl doctor
  [✓] Deployment
  [!] Docker registry
  [!] Artifacts repo
  [!] Source Status
  5. Configure os repositórios de dados exigidos pelo cluster, conforme descrito em Como definir repositórios de dados.
  6. Se necessário, configure um proxy HTTPS para acesso de saída à Internet, conforme descrito em Como configurar um proxy HTTPS.

Console

O Console do Google Cloud pode ajudar no processo de instalação, gerando os comandos de instalação necessários e executando-os no Cloud Shell.

  1. Abra a página do Migrate for Anthos and GKE no Console do Cloud.

    Acesse a página do Migrate for Anthos and GKE.

  2. Clique na guia Processamento de clusters para exibir uma tabela com os clusters disponíveis.

  3. Clique em Adicionar cluster de processamento.

  4. Selecione o tipo de carga de trabalho a ser migrada como Linux ou Windows e selecione Avançar.

  5. Selecione o cluster na lista suspensa e clique em Avançar.

  6. Execute cada um dos comandos no Cloud Shell para criar uma conta de serviço para acessar o Container Registry e o Cloud Storage e instalar os componentes do Migrate for Anthos and GKE.

  7. Use o último comando do Cloud Shell para monitorar o status da instalação.

    Antes de concluir a instalação, poderá ser exibida uma mensagem como a seguinte. Em caso afirmativo, aguarde alguns minutos até que a instalação seja concluída antes de executar o migctl doctor novamente.

    migctl doctor
[!] Deployment
   Validation checks failed.

    Neste exemplo de saída, a marca de seleção indica que o Migrate for Anthos and GKE foi implantado com sucesso.

    migctl doctor
[✓] Deployment
[✓] Docker registry
[✓] Artifacts repo
[!] Source Status

  8. Selecione Concluído após a instalação.

Opções de instalação

É possível criar clusters de vários tamanhos e configurações. Por exemplo, é possível ter um cluster com vários pools de nós. Em seguida, você usará um pool de nós para processar migrações, um pool de nós para executar cargas de trabalho e outro pool para outras operações.

Por padrão, o Migrate for Anthos and GKE é instalado em todos os nós do cluster. Para controlar quais nós são usados pelo Migrate for Anthos and GKE, é possível usar as opções --node-selectors e --tolerations para o comando migctl setup install:

  • --node-selectors LABEL1=VALUE1,LABEL2=VALUE2,...

    Especifica uma lista separada por vírgulas de pares de rótulo e valor que determinam os nós usados pelo Migrate for Anthos and GKE. Consulte Como criar e gerenciar rótulos para mais informações sobre como usar rótulos.

  • --tolerations KEY1=VALUE1:EFFECT1,KEY2=VALUE2:EFFECT2,...

    Especifica pares de chave-valor da lista separadas por vírgula associados a um efeito que, juntos, especificam um taint de nó. Uma tolerância significa que os pods podem ser executados no taint do nó especificado pelo valor-chave e efeito.

    Se você omitir EFFECT e/ou VALUE, as tolerâncias correspondem aos taints com KEY,VALUE (para qualquer EFFECT) e/ou KEY (para qualquer VALUE:EFFECT).

    Consulte Como controlar a programação com taints de nó para mais informações sobre taints de nó.

Próximas etapas