Importar e exportar VMs

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

Pré-requisitos para migração

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

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

• Migrar VMs individuais
• Migrar grupos de VMs

Aspectos gerais da 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. Edite o arquivo CSV externamente e faça o upload dele 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 cria migrações e grupos, altera as associações ao grupo e atualiza os detalhes do destino para que correspondam ao estado do arquivo CSV importado.

Você pode definir um arquivo CSV para o processo de importação de várias formas:

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

Se o arquivo CSV estiver formatado incorretamente ou um detalhe de migração específico for inválido, um erro será exibido 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 do 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 o nome de exibição da VM de origem ou 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 faltantes 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. Confira um exemplo em Exportar um modelo de arquivo.

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 é necessária e precisa conter as colunas a seguir que identificam a VM de migração ou de origem. As demais colunas são opcionais e só são atualizadas quando importadas se existirem. As colunas de cabeçalho desconhecidas são ignoradas.

Os campos obrigatórios do arquivo CSV são:

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

Para mais informações sobre campos opcionais, confira 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 encoberto quando exportado. A reimportação do mesmo arquivo CSV vai ignorar as colunas de metadados encobertas.

Modelos de arquivos

É possível exportar um modelo de arquivo para definir o arquivo CSV. O modelo do arquivo CSV é vazio, exceto por uma linha de cabeçalho que detalha os campos obrigatórios e opcionais e uma amostra de linha 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çalho 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, exporte um arquivo CSV que represente o status atual delas.

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 baixar o arquivo CSV.

3. Para exportar grupos de migrações:

   1. Selecione a guia Grupos.
   2. Na lista, selecione os grupos que você quer exportar.
   3. Clique em Exportar para baixar o 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 exibidos. Você pode ignorar essas linhas e importar o restante.

Depois do upload de um arquivo CSV validado, um plano de importação vai ser exibido para aprovação. O 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 o 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 exibidos 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 exibidas. 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. Devido à 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 do ponto em que falhou.

Analisar 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.

Depois de aceitar o plano de importação, o status de cada item vai ser atualizado à medida que o processo avança. O relatório contém o status, como Pendente, Em execução, Concluído e Com falha, que se correlaciona a cada item.

Exportar o modelo do arquivo de migração

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

Para exportar o modelo do arquivo 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ê deverá baixar o arquivo Template.csv.