Como instalar o Migrate to Containers
Neste tópico, descrevemos como instalar o Migrate to Containers em um cluster de processamento.
Um cluster de processamento é um cluster do Google Kubernetes Engine (GKE) ou GKE Enterprise com os componentes do Migrate to Containers 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 to Containers 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 to Containers 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 Google Kubernetes Engine (GKE) ou GKE Enterprise no Google Cloud, execute
migctl
noCloud Shell.Ao usar um cluster de processamento do Google Distributed Cloud Virtual para Bare Metal, é possível instalar e executar o
migctl
na estação de trabalho do administrador.
Para saber como fazer o download do migctl
, consulte Downloads do Migrate to Containers.
Antes de começar
Conclua os pré-requisitos de migração para o ambiente de migração:
- Pré-requisitos para migrar VMs do Linux usando clusters de processamento do Google Cloud
- Requisitos para migrar aplicativos IIS do Windows usando clusters de processamento do Google 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 GKE Enterprise criado especificamente para migrar VMs com o Migrate to Containers.
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.
Como instalar o Migrate to Containers
migctl no Google Cloud
Use comandos migctl
para instalar o Migrate to Containers 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.
Acesse o menu do GKE no Console do Google Cloud.
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 to Containers 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 to Containers 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 to Containers foi implantado 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 Google Distributed Cloud Virtual para Bare Metal
- 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://modernize-release.storage.googleapis.com/v1.15.0/linux/amd64/migctl
sudo cp migctl /usr/local/bin/
sudo chmod +x /usr/local/bin/migctl
. <(migctl completion bash)
- Configure os componentes do Migrate to Containers no cluster de processamento executando
o comando migctl setup install:
migctl setup install --anthos-bm --gcp-project myproject --gcp-region us-central1 --json-key m4a-install.json
Quando receber todos os argumentos, incluindo--gcp-project
,--gcp-region
e--json-key
,migctl
criará um registro do Docker padrão e repositórios de artefatos no Container Registry e no Cloud Storage, respectivamente. Isso significa que as imagens e os artefatos de migração serão enviados por upload para o Google Cloud. É possível configurar outros registros do Docker e defini-los como padrão para migração ou defini-los para serem usados em uma migração específica. - Valide a instalação do Migrate to Containers executando o
comando migctl Medical.
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 to Containers 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
- 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
Abra a página "Migrate to Containers" no Console do Google Cloud.
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.
Selecione o cluster na lista suspensa e clique em Avançar.
Selecione o bucket para o repositório de artefatos.
Por padrão, o Migrate to Containers usa o Cloud Storage com o nome do bucket especificado. É possível definir o nome do bucket aqui. Revise os requisitos descritos em Como definir repositórios de dados.
Selecione o nome do projeto Repositório de imagem.
Por padrão, o Migrate to Containers usa o projeto atual para o Container Registry. Se quiser, você pode alterar o nome do projeto aqui. Revise os requisitos descritos em Como definir repositórios de dados.
Clique em Continuar.
Especifique a conta de serviço do repositório de artefatos usada para acessar o Cloud Storage. É possível criar uma nova conta de serviço ou selecionar uma atual. Consulte Como configurar contas de serviço para mais informações.
Clique em Continuar para revisar as configurações e, em seguida, clique em Implantar para instalar o Migrate to Containers no cluster.
Quando a instalação for concluída, você verá o nome do cluster na guia Clusters de processamento com status Pronto.
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 to Containers é instalado em todos os nós do cluster. Para controlar quais nós
são usados pelo Migrate to Containers, é 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 to Containers. 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ó.
A seguir
- Saiba como fazer upgrade para a versão mais recente.
- Saiba como definir repositórios de dados.
- Saiba como configurar um proxy HTTPS.