Importar e exportar VMs

O recurso de importação e exportação do Migrate to Virtual Machines permite criar, exportar e revisar VMs de migração usando um arquivo CSV.

Pré-requisitos de migração

Antes de usar o recurso de importação e exportação, revise os requisitos de migração de VMs individuais e grupos de VMs. Os mesmos requisitos são aplicados ao gerenciar migrações por CSV.

Para mais informações sobre migrações, consulte a documentação Migrate to Virtual Machines:

• Migrar VMs individuais
• Migrar grupos de VMs

Visão geral de importação e exportação

Use o recurso de exportação para gerar um arquivo CSV que especifica as VMs de origem ou atuais e os detalhes do destino, editá-las externamente e fazer o upload do CSV para o Migrate to Virtual Machines para definir as migrações.

Ao editar e importar o arquivo CSV, mantenha o foco no estado final da migração. Em outras palavras, é possível definir as configurações no arquivo CSV. O processo de importação vai criar migrações e grupos, alterar as associações a grupos e atualizar os detalhes do destino para que correspondam ao estado do seu arquivo CSV importado.

Existem várias opções para definir um arquivo CSV para o processo de importação:

• Exportar os detalhes de migração existentes como um arquivo CSV para edição em massa e uploads de grupo
• Exportar VMs de origem de um inventário de origem como um arquivo CSV
• Fazer o download e editar um arquivo CSV de modelo

Se o arquivo CSV estiver formatado incorretamente ou um detalhe de migração específico for inválido, você receberá um erro durante o upload para o Migrate to Virtual Machines.

Observação: não é possível excluir os grupos ou as VMs de migração usando o recurso de importação e exportação.

Formato de arquivo CSV

Antes de qualquer ação, o arquivo CSV importado vai ser analisado e validado conforme os seguintes critérios:

• As migrações e as VMs de origem vão ser identificadas como uma combinação de nome de origem, região de origem e nome de exibição da VM de origem ou o ID da VM de origem.
• A mesma VM de migração ou origem não pode aparecer em mais de uma linha.
• No máximo 100 migrações ou VMs de origem podem ser processadas em um único arquivo.
• Se não houver uma migração para a VM de origem, a existência da VM de origem será validada e uma nova migração vai ser criada para ela.
• O recurso de migração de importação e exportação valida colunas de detalhes do destino de acordo com as restrições de nomenclatura de tipo e recurso. Valide manualmente a existência de recursos no projeto de destino para evitar falhas.
• As colunas ausentes no arquivo CSV são ignoradas, e as migrações não vão ser atualizadas nesses campos. No entanto, os valores vazios atualizam a respectiva migração e removem os dados dela.
• As colunas podem conter vários valores por VM, como tags de rede ou rótulos, separados por quebras de linha. Veja um exemplo em Exportar um arquivo de modelo.

Alguns erros de validação vão impedir que a importação continue. Por exemplo, uma linha de cabeçalho inválida ou um arquivo com muitas linhas vai gerar um erro de validação.

Observação: os avisos no nível da linha podem ser ignorados de acordo com seus critérios. Para prosseguir, selecione Ignorar erros e continuar na página de importação.

Campos do arquivo CSV

Uma linha de cabeçalho é esperada e precisa conter as seguintes colunas que identificam a VM de migração ou de origem. As demais colunas são opcionais e só são atualizadas quando importadas. As colunas de cabeçalho desconhecidas são ignoradas.

Os campos obrigatórios do arquivo CSV incluem:

• Nome da origem
• Região
• Nome de exibição da VM de origem ou ID da VM de origem

Saiba mais sobre campos opcionais, em Como configurar o destino de uma VM migrada.

Observação: os valores de metadados podem ser muito longos e conter quebras de linha. O processo de exportação e importação é compatível apenas com valores simples de uma linha. Se a migração tiver valores de metadados incompatíveis, o arquivo CSV vai ser editado quando exportado. A reimportação do mesmo arquivo CSV vai ignorar as colunas de metadados editadas.

Arquivos de modelo

É possível exportar um arquivo de modelo para definir seu arquivo CSV. O modelo do arquivo CSV está vazio, exceto por uma linha de cabeçalho que detalha os campos obrigatórios e opcionais e uma linha de amostra com exemplos de como cada coluna deve ser formatada. No modelo, os detalhes do destino são representados pelas colunas do arquivo CSV.

Observação: a linha de cabeçalhos fornecida pelo modelo é necessária para uma importação correta.

Exportar um arquivo CSV preenchido automaticamente

Para criar migrações com base em VMs de origem ou fazer alterações em uma migração ou um grupo de migrações existente, exporte primeiro um arquivo CSV que represente o status atual das migrações.

Para exportar um arquivo CSV preenchido automaticamente, siga estas etapas:

1. Abra a página Migrate to Virtual Machines no Console do Google Cloud:

2. Para exportar uma lista de VMs de origem:

   1. Selecione a guia Origens.
   2. Selecione as VMs de origem que você quer exportar do inventário.
   3. Clique em Exportar para fazer o download do arquivo CSV.

3. Para exportar grupos de migrações existentes:

   1. Selecione a guia Grupos.
   2. Na lista, selecione os grupos que você quer exportar.
   3. Clique em Exportar para fazer o download do arquivo CSV.

Importar o arquivo CSV

Quando você fizer upload de um arquivo CSV, ele vai ser validado. Se algumas linhas do arquivo tiverem erros, eles vão ser mostrados. Você pode optar por ignorar essas linhas e importar o restante.

Depois do upload de um arquivo CSV validado, um plano de importação vai ser apresentado para aprovação. Seu arquivo vai ser importado após a aprovação.

Para importar o arquivo CSV, siga estas etapas:

1. Abra a página Migrate to Virtual Machines no Console do Google Cloud:
2. Selecione a guia Grupos e depois Importar.

3. Procure seu arquivo de importação. Ele precisa ser um arquivo CSV de até 100 KB.

   Dica: não é possível fazer o upload de um arquivo CSV enquanto outra importação já estiver em andamento.

4. Selecione Fazer upload.

   Se houver erros, eles vão ser mostrados nesta etapa. Você pode escolher Ignorar erros e continuar.

5. Você vai receber um plano de importação. O plano detalha quais ações estão sendo invocadas e quais recursos estão sendo referenciados.

6. Selecione Iniciar importação para aprovar o plano e iniciar a importação. O plano de importação vai ser atualizado com o progresso de cada etapa.

7. Se a importação não for concluída, analise as mensagens de erro fornecidas. A falha de qualquer etapa vai interromper a sequência inteira.

8. Após a importação, selecione Acessar grupos para retornar à página Grupos e verificar os recursos atualizados.

   Observação: em caso de falha, tente importar o mesmo arquivo CSV novamente. Dada a natureza do processo de importação, em que o arquivo CSV representa o estado ideal das migrações, o processo de migração de importação e exportação ignora as ações que já foram concluídas e continua a partir do ponto em que falhou.

Revisar o plano de importação

Um plano de importação é uma lista de ações geradas de acordo com as alterações detectadas no arquivo de importação. Os seguintes tipos de mensagens podem ser listados:

• Criar migrações.
• Criar um grupo.
• Remover migrações de um grupo.
• Adicionar migrações a um grupo.
• Atualizar os detalhes do destino das migrações.

Após a aceitação no plano de importação, o status de cada item vai ser atualizado à medida que o processo avança. No relatório, você vai ver o status, como Pendente, Em execução, Concluído e Com falha, que se correlaciona a cada item.

Exportar o arquivo de modelo de migração

É possível exportar um arquivo de modelo de migração para detalhes sobre a formatação correta do arquivo CSV.

Para exportar o arquivo de modelo de migração, siga estas etapas:

1. Abra a página Migrate to Virtual Machines no Console do Google Cloud:
2. Selecione a guia Grupos.
3. Selecione Importar.
4. Selecione Exportar modelo. Você vai receber uma solicitação para fazer o download do arquivo Template.csv.