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:
- Faça o download do script de coleta.
- Executar o script na infraestrutura em nuvem e gerar as tabelas de saída.
- Faça upload das tabelas de saída no 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 com permissões mínimas do tipo somente leitura. O uso de permissões somente leitura evita modificações acidentais nos recursos da AWS ou do Azure.
- Os scripts são de código aberto. Portanto, se a sua organização tiver requisitos regulatórios específicos, revise o código para entender exatamente que tipo de dados é coletado.
Limitações
- O tamanho máximo para upload de um arquivo é de 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 do repositório. O script gera um arquivo ZIP com as tabelas dos dados coletados. Extraia os arquivos do arquivo ZIP.
O arquivo ZIP contém os seguintes arquivos que você envia para Central de migração:
vmInfo.csv
perfInfo.csv
diskInfo.csv
tagInfo.csv
Ele também pode conter outros arquivos que não podem ser enviados para o Migration Center, como o arquivo resources.json
.
O upload de arquivos JSON para o Migration Center resulta em um erro.
Fazer upload dos resultados do script de coleta
Para fazer upload dos arquivos, siga estas etapas:
Console
Acesse a página Importação de dados.
Clique em Adicionar dados > Fazer upload de arquivos.
Na seção Configurar upload de arquivos, digite o nome do upload do arquivo.
Na lista Formato do arquivo, selecione Exportações da AWS ou Exportações do Azure.
Clique em Selecionar arquivos para upload e escolha todos os arquivos que você quer enviar.
Para confirmar e iniciar o upload dos arquivos, clique em Fazer upload de arquivos.
Se os arquivos forem validados corretamente, para criar os recursos a partir deles, clique em Importar dados e em Confirmar.
API
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 origem existente a ser associada ao job de importação.
Opcional: para confirmar se o job de importação foi criado corretamente, peça o job de importação.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
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 dadosIMPORT_JOB_FORMAT
:IMPORT_JOB_FORMAT_EXPORTED_AWS_CSV
ouIMPORT_JOB_FORMAT_EXPORTED_AZURE_CSV
.
Acesse o arquivo de dados.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
Copie o URL do campo
signedUrl
da resposta.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 enviado.COPIED_URL
: o URL assinado copiado de etapas de visualização.
Opcional: repita as etapas 3 a 6 para criar mais arquivos de dados no mesmo job de importação.
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
Valide o job de importação.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Receba o job de importação e acesse o relatório de validação. Se o estado for
READY
, será 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
Execute o job de importação.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
Acesse o job de importação e veja o relatório de execução. Se o estado for
COMPLETED
, o job foi executado. Caso contrário, se o job falhar e estiver em um estado terminal, o relatório de execução vai incluir 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, o Migration Center processará os dados para criar novos recursos ou atualizar os existentes. É possível verificar o status dos jobs de upload no console do Google Cloud.
Para analisar o status do job de envio, siga estas etapas:
- Acesse a página Importação de dados e clique em Envios de arquivos.
- Na lista de importações de arquivos, selecione o upload que você quer analisar.
- Na página de upload de arquivos, em Progresso da importação de dados, analise o Status dos arquivos enviados.
Seus arquivos podem estar em um dos seguintes status.
Lista de status
- Concluído. A importação do arquivo foi concluída.
- Pronto. Seu arquivo passou 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 detalhes do erro
Se você encontrar erros depois de importar seus arquivos, é possível analisar a mensagem de erro diretamente no console do Google Cloud.
Para analisar os erros do seu job de upload, siga estas etapas:
- Acesse a página Importação de dados e clique em Uploads de arquivos.
- 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
- Saiba mais sobre métodos de coleta da Central de migração
- Saiba como gerenciar uploads de arquivos.