Importar dados de outros provedores de nuvem

A Central de migração permite importar dados de desempenho e uso do infraestrutura hospedada em outros provedores de nuvem, como Amazon Web Services (AWS) e Azure.

Para importar dados de outros provedores de nuvem, siga estas etapas:

  1. Faça o download do script de coleta.
  2. Executar o script na infraestrutura em nuvem e gerar as tabelas de saída.
  3. Faça upload das tabelas de saída para o Migration Center.

Práticas recomendadas para executar o script de coleta

Ao executar o script de coleta, considere o seguinte:

  • Execute o script de coleta usando uma instância do AWS Cloud Shell (quando (coleta de dados da AWS) ou do Azure Cloud Shell (ao coletar dados de Azure). O uso desses shells evita a necessidade de gerar, distribuir e manter chaves de autenticação para executar o script de coleta em outro ambiente de execução e ambientes de teste.
  • Execute o script de coleta representando uma conta que tem contas somente leitura. O uso de permissões somente leitura evita problemas modificações nos recursos da AWS ou do Azure.
  • Os scripts são de código aberto. Portanto, se sua organização tiver requisitos regulatórios revisar o código para entender exatamente que tipo de dados coletados.

Limitações

  • O tamanho máximo para um upload de arquivo é 100 MB.

Faça o download do script

Para fazer o download dos scripts, selecione um dos links a seguir, dependendo do seu provedor de nuvem:

Executar o script

Para executar o script, siga as instruções no arquivo README da repositório de dados. O script gera um arquivo ZIP com as tabelas dos dados coletados. Extraia os arquivos do arquivo ZIP.

Fazer upload dos resultados do script de coleta

Para fazer upload dos arquivos, siga estas etapas:

Console

  1. Acesse a página Importação de dados.

    Acessar a importação de dados

  2. Clique em Adicionar dados > Fazer upload de arquivos.

  3. Na seção Configurar upload de arquivos, digite o nome do upload do arquivo.

  4. Na lista Formato de arquivo, selecione Exportações da AWS ou Exportações do Azure.

  5. Clique em Selecionar arquivos para upload e selecione todos os arquivos quer fazer upload.

  6. Para confirmar e iniciar o upload dos arquivos, clique em Fazer upload de arquivos.

  7. Se os arquivos forem validados corretamente, para criar os recursos a partir do clique em Importar dados e em Confirmar.

API

  1. Crie um job de importação.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID
    
    {
      "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID"
    }
    

    Substitua:

    • PROJECT_ID: ID do projeto em que o job de importação.
    • REGION: região para criar o job de importação.
    • IMPORT_JOB_ID: ID do novo job de importação.
    • SOURCE_ID: ID de uma fonte existente a ser associados ao job de importação.
  2. Opcional: para confirmar que o job de importação foi criado corretamente, receba o job de importação.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
    
  3. Crie um arquivo de dados de importação anexado ao job de importação.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID
    
    {
      "format": "IMPORT_JOB_FORMAT"
    }
    

    Substitua:

    • DATA_FILE_ID: ID do novo arquivo de dados.
    • IMPORT_JOB_FORMAT: IMPORT_JOB_FORMAT_EXPORTED_AWS_CSV ou IMPORT_JOB_FORMAT_EXPORTED_AZURE_CSV
  4. Acesse o arquivo de dados.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
    
  5. Copie o URL do campo signedUrl da resposta.

  6. Faça upload de um arquivo para o URL copiado.

    PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
    

    Substitua:

    • UPLOAD_FILE_PATH: o caminho local do arquivo que é carregado.
    • COPIED_URL: o URL assinado copiado de etapas de visualização.
  7. Opcional: repita as etapas 3 a 6 para criar mais arquivos de dados no mesmo job de importação.

  8. Opcional: receba todos os arquivos de dados de um job de importação.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
    
  9. Valide o job de importação.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
    
  10. Acesse o job de importação e confira o relatório de validação. Se o estado for READY, é possível continuar para as próximas etapas. Caso contrário, você vai precisar corrigir o job ou arquivos específicos, isso pode exigir excluir arquivos ou fazer upload de novos.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
    
  11. Execute o job de importação.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
    
  12. Acesse o job de importação e veja o relatório de execução. Se o estado for COMPLETED, significa que o job foi executado com sucesso. Caso contrário, se o job falhar e em estado terminal, o relatório de execução inclui os erros. Crie um novo job de importação e aplique as alterações necessárias.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
    

Se você tiver problemas com o upload de arquivos, veja como solucionar mensagens de erro comuns.

Revisar o upload

Depois que você faz upload dos arquivos, eles são validados pela Central de migração para verificar se estão formalmente corretas. Se a validação for bem-sucedida, A Central de migração processa os dados para criar novos recursos, ou atualizar os existentes. É possível verificar o status dos seus jobs de upload no console do Google Cloud.

Para analisar o status de sua tarefa de upload, siga estas etapas:

  1. Acesse a página Importação de dados e clique em Uploads de arquivos.
  2. Na lista de importações de arquivos, selecione o upload que você quer analisar.
  3. Na página de upload de arquivos, em Progresso da importação de dados, analise o Status dos arquivos enviados.

Você pode ver seus arquivos em um dos seguintes status.

Lista de status

  • Concluído. O arquivo foi importado.
  • Pronto. Seu arquivo foi aprovado na validação e está pronto para ser importado.
  • Pendente. Seu arquivo está aguardando a conclusão do processamento de outro arquivo.
  • Em execução. Seu arquivo está sendo processado.
  • Validação. Seu arquivo está no estágio de validação.
  • Falha na validação. Seu arquivo contém alguns erros. Corrija os erros e, em seguida, tente fazer o upload do seu arquivo novamente.
  • Falhou. Não foi possível importar seu arquivo.

Analisar os detalhes do erro

Se você encontrar erros depois de importar seus arquivos, poderá analisar a mensagem de erro diretamente no console do Google Cloud.

Para analisar os erros do job de upload, siga estas etapas:

  1. Acesse a página Importação de dados e clique em Uploads de arquivos.
  2. Clique no arquivo de importação que mostra um aviso ou erro. A página de detalhes do arquivo de importação mostra a lista completa de erros.

Na página de detalhes do arquivo de importação, é possível revisar os campos de recursos e dados. que causou os erros e veja uma descrição do erro. Erros no job de importação de arquivos podem impedir que o Migration Center criar novos recursos ou atualizar os atuais com as novas alterações. Para corrigir o erro, edite seus arquivos e crie um novo job de importação de arquivos para fazer upload novamente.

Para mais informações sobre as possíveis mensagens de erro, consulte Resolver erros de importação de arquivos

A seguir