Como instalar o Migrate for Anthos

Neste tópico, descrevemos como instalar o Migrate for Anthos em um cluster de processamento.

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

Ao seguir as etapas neste tópico, você usa a ferramenta de linha de comando migctl ou o Console do Google Cloud para instalar os componentes necessários do Migrate for Anthos 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 inclui a ferramenta de linha de comando migctl, que pode ser usada para executar todas as partes de uma migração:

Ao usar um cluster de processamento do Google Kubernetes Engine (GKE) ou Anthos no Google Cloud, execute migctl no Cloud Shell.
Ao usar um cluster de processamento no GKE local, é possível instalar e executar migctl na estação de trabalho de administrador.

Antes de começar

Cumpra os pré-requisitos de migração.

Descreve os pré-requisitos para migrar para um cluster em execução no Cloud ou no local e a instalação do Migrate for Compute Engine. O Migrate for Compute Engine é necessário somente se você estiver migrando de uma origem da AWS ou do Azure ou de uma origem da VMware para um cluster em execução no Cloud:
Configure seu ambiente conforme descrito em Como ativar serviços do Google e configurar contas de serviço.
Configure um cluster de processamento.

Este é um cluster do Google Kubernetes Engine (GKE) ou Anthos criado especificamente para migrar VMs com o Migrate for Anthos.
Para executar os comandos de instalação ou desinstalação com migctl, é recomendado que você tenha permissões de administrador para o cluster em que você está instalando.

Instale o Migrate for Anthos

migctl no Google Cloud

Use comandos migctl para instalar o Migrate for Anthos e configurá-lo com os princípios básicos necessários para migrar.

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.

Observação: as instruções a seguir presumem que o nome do arquivo de chave JSON seja m4a-install.json.
Acesse o menu do GKE no Console do Cloud.

Acesse o menu do GKE
Na lista de clusters, localize o cluster que você usará como um cluster de processamento e clique no botão Conectar.
Na caixa de diálogo Conectar ao cluster, em Acesso de 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
```
Configure os componentes do Migrate for Anthos 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
```
Valide a instalação do Migrate for Anthos 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.
```
Na saída de exemplo a seguir, a marca de seleção indica que o Migrate for Anthos foi implantado e que os repositórios de dados necessários foram configurados.
```
migctl doctor
[✓] Deployment
[✓] Docker registry
[✓] Artifacts repo
[!] Source Status
```
Observação: Source Status mostra [!] até você definir a primeira origem de migração. Consulte Como adicionar mais uma origem de migração (Linux) ou Como adicionar mais uma fonte de migração (Windows).
Observação: por padrão, o Migrate for Anthos usa o Container Registry (GCR) para o registro do Docker e o Google Cloud Storage para o repositório de artefatos. Se você quiser adicionar mais repositórios, consulte Como definir repositórios de dados.

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

Defina o ID do projeto padrão:
```
gcloud config set project project-id
```
Implante o migctl na estação de trabalho de administrador:
```
wget https://anthos-migrate-release.storage.googleapis.com/v1.7.0/linux/amd64/migctl
sudo cp migctl /usr/local/bin/
sudo chmod +x /usr/local/bin/migctl
. <(migctl completion bash)
```
Observação:
O comando final requer a instalação do pacote de conclusão do bash. Se ainda não tiver feito isso, instale-o para sua versão específica do Linux. Por exemplo, no CentOS, instale-o usando o comando:
```
sudo yum -y install bash-completion
```
Para configurar os componentes do Migrate for Anthos no cluster de processamento, execute o comando migctl setup install:
```
migctl setup install --gkeop
```
Valide a instalação do Migrate for Anthos 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.
```
Na saída de exemplo a seguir, a marca de seleção indica que o Migrate for Anthos foi implantado com êxito, mas você ainda não configurou os repositórios de dados necessários:
```
migctl doctor
  [✓] Deployment
  [!] Docker registry
  [!] Artifacts repo
  [!] Source Status
```
Observação: Source Status mostra [!] até definir a primeira origem de migração. Consulte Como adicionar mais uma fonte de migração (Linux) ou Como adicionar mais uma origem de migração (Windows).
Configure os repositórios de dados exigidos pelo cluster, conforme descrito em Como definir repositórios de dados.
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.

Defina o ID do projeto padrão:
```
gcloud config set project project-id
```
Implante o migctl na estação de trabalho de administrador:
```
wget https://anthos-migrate-release.storage.googleapis.com/v1.7.0/linux/amd64/migctl
sudo cp migctl /usr/local/bin/
sudo chmod +x /usr/local/bin/migctl
. <(migctl completion bash)
```
Observação:
O comando final requer a instalação do pacote de conclusão do bash. Se ainda não tiver feito isso, instale-o para sua versão específica do Linux. Por exemplo, no CentOS, instale-o usando o comando:
```
sudo yum -y install bash-completion
```
Para configurar os componentes do Migrate for Anthos no cluster de processamento, execute o comando migctl setup install:
```
migctl setup install --gke-on-aws
```
Valide a instalação do Migrate for Anthos 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.
```
Na saída de exemplo a seguir, a marca de seleção indica que o Migrate for Anthos foi implantado com êxito, mas você ainda não configurou os repositórios de dados necessários:
```
migctl doctor
  [✓] Deployment
  [!] Docker registry
  [!] Artifacts repo
  [!] Source Status
```
Observação: Source Status mostra [!] até definir a primeira origem de migração. Consulte Como adicionar mais uma fonte de migração (Linux) ou Como adicionar mais uma origem de migração (Windows).
Configure os repositórios de dados exigidos pelo cluster, conforme descrito em Como definir repositórios de dados.
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.

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

Acesse a página do Migrate for Anthos
Clique na guia Processamento de clusters para exibir uma tabela com os clusters disponíveis.
Clique em Adicionar cluster de processamento.
Selecione o tipo de carga de trabalho a ser migrada como Linux ou Windows e selecione Avançar.

Observação: os requisitos do sistema para o cluster são diferentes para a migração das cargas de trabalho do Linux e do Windows e para migrações locais. Consulte Como configurar uma visão geral de cluster para mais informações.
Selecione o cluster na lista suspensa e clique em Avançar.

Observação: se você não tiver um cluster atual, selecione Criar um novo cluster do Kubernetes Engine. Consulte Como configurar uma visão geral de cluster para mais informações.
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.

Observação: você precisa autorizar o Cloud Shell ao executar o primeiro comando.
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.
```
No exemplo de saída a seguir, a marca de seleção indica que o Migrate for Anthos foi implantado com sucesso.
```
migctl doctor
[✓] Deployment
[✓] Docker registry
[✓] Artifacts repo
[!] Source Status
```
Observação: Source Status mostra [!] até você definir a primeira origem de migração. Consulte Como adicionar mais uma origem de migração (Linux) ou Como adicionar mais uma fonte de migração (Windows).
Observação: por padrão, o Migrate for Anthos usa o Container Registry (GCR) para o registro do Docker e o Google Cloud Storage para o repositório de artefatos. Se você quiser adicionar mais repositórios, consulte Como definir repositórios de dados.
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 é instalado em todos os nós do cluster. Para controlar quais nós são usados pelo Migrate for Anthos, é 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. 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ó.