Importar tabelas geradas manualmente

A Central de migração permite fazer upload de tabelas de dados que você preenche manualmente usando os modelos fornecidos. Isso é útil quando sua infraestrutura tem um impacto específico de recursos e quiser criar os dados manualmente.

Para importar as tabelas que você preencheu manualmente, siga estas etapas:

  1. Faça o download dos modelos na lista de modelos disponíveis.
  2. Preencha manualmente as tabelas com os dados da sua infraestrutura.
  3. Faça upload das tabelas na Central de migração.

Limitações

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

Modelos de dados disponíveis

A tabela a seguir mostra os modelos de arquivo que você pode usar fazer upload dos dados de infraestrutura para o Migration Center. Os modelos contêm dados de exemplo como sugestão de como preencher a tabela. Para uma descrição detalhada do formato de dados necessário, consulte Especificações de importação de arquivos.

Nome do arquivo Tipo de dado Descrição
vmInfo.csv Informações do computador Use esse modelo para fornecer informações sobre recursos individuais, incluindo CPU, memória e outros parâmetros de configuração. Esta tabela é obrigatório toda vez que você cria uma nova importação.
perfInfo.csv Dados de desempenho Opcional: use esse modelo para fornecer dados de desempenho dos recursos em formato de série temporal.
diskInfo.csv Dados do disco Opcional: use esse modelo para fornecer informações sobre discos e utilização.
tagInfo.csv Tags do sistema Opcional: use esse modelo para atribuir rótulos aos recursos. Rótulos. precisam seguir os requisitos de rótulos no Google Google Cloud.

Para mais informações sobre as especificações de cada arquivo, consulte Especificações de importação de arquivos.

Fazer upload das tabelas

Para fazer upload dos arquivos, siga estas etapas:

Console

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

    Acesse 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 do arquivo, selecione Modelos de CSV preenchidos manualmente.

  5. Clique em Selecionar arquivos para upload e escolha todos os arquivos que você quer enviar.

  6. Para confirmar e começar 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 para criar o serviço 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 se 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_MANUAL_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 enviado.
    • COPIED_URL: o URL assinado copiado das 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: acesse 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, 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, A Central de migração processa os dados para criar novos recursos, ou atualizar as 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:

  1. Acesse a página Importação de dados e clique em Envios de arquivos.
  2. Na lista de importações de arquivos, selecione o upload que você quer revisar.
  3. 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 tente fazer o upload do 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, é possível 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 analisar os recursos e campos de dados que causam os erros e conferir uma descrição deles. 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.

Especificações de importação de arquivos

As tabelas a seguir mostram as especificações técnicas dos arquivos de modelo usados para importação manual.

Arquivo vmInfo

Coluna Tipo esperado Descrição
MachineId string O identificador exclusivo da máquina virtual.
MachineName string O nome de exibição da máquina virtual.
PrimaryIPAddress string O endereço IP da máquina.
PrimaryMACAddress string O endereço MAC da máquina. Ele é usado apenas para identificar a máquina.
PublicIPAddress string O endereço IP público da máquina.
IpAddressListSemiColonDelimited Lista de mensagens A lista de endereços de rede alocados ou atribuídos.
TotalDiskAllocatedGiB int64 A capacidade total do disco.
TotalDiskUsedGiB int64 A quantidade total de espaço usado no disco.
MachineTypeLabel string O rótulo do tipo de máquina da AWS ou do Azure.
AllocatedProcessorCoreCount int64 Número de núcleos de CPU na máquina virtual.
MemoryGiB int32 A quantidade de memória da máquina virtual.
HostingLocation string O local da máquina no formato AWS ou Azure.
OsType string O SO da máquina.
OsName string O SO da máquina.
OsVersion string A versão do SO da máquina.
MachineStatus string O estado de energia da máquina.
ProvisioningState string O estado de provisionamento, somente para VMs do Azure.
CreateDate Carimbo de data/hora O carimbo de data/hora de criação da máquina.
IsPhysical string Se a máquina é física ou máquina virtual.
Origem mensagem Os detalhes da origem das máquinas da AWS ou do Azure.

Arquivo diskInfo

Coluna Tipo esperado Descrição
MachineId string O identificador exclusivo da máquina virtual.
DiskLabel string O rótulo do disco.
SizeInGib int64 A capacidade total do disco.
UsedInGib int64 A quantidade total de espaço usado no disco.
StorageTypeLabel string O tipo de rótulo do disco (por exemplo, BIOS ou GPT).

Arquivo perfInfo

Coluna Tipo esperado Descrição
MachineId string O identificador exclusivo da máquina virtual.
Carimbo de data/hora Carimbo de data/hora em que a amostra foi coletada.
CpuUtilizationPercentage float A porcentagem da capacidade total da CPU usada. Deve estar no intervalo 0 a 100.
MemoryUtilizationPercentage float A porcentagem usada da memória do sistema. Precisa estar no intervalo 0 a 100.
UtilizedMemoryBytes float A memória total usada em bytes.
DiskReadOperationsPerSec float O IOPS médio amostrado em um curto período.
DiskWriteOperationsPerSec float O IOPS médio amostrado em um curto período.
NetworkBytesPerSecSent float A saída média de rede em B/s, amostrada em um período curto.
NetworkBytesPerSecReceived float Entrada média de rede em B/s, amostrada em um período curto.

Arquivo tagInfo

Coluna Tipo esperado Descrição
MachineId string O identificador exclusivo da máquina virtual.
Chave string A chave de rótulo
Valor string O valor do rótulo.

Algoritmo de análise para rótulos

Os rótulos enviados com o arquivo tagInfo precisam seguir as requisitos para rótulos no Google Cloud. Se o rótulo não atender aos requisitos, a Central de migração usará a seguinte estratégia para converter o rótulo:

  1. Apenas para chaves, ele remove todos os caracteres iniciais que não sejam letras do alfabeto inglês.
  2. Ele substitui todas as letras maiúsculas por minúsculas.
  3. Ela substitui todos os caracteres inválidos por sublinhados (_).
  4. Ela trunca o rótulo até um máximo de 62 caracteres.
  5. Ele adiciona o sufixo _<CRC32>, calculado com base na string original.

Uma mensagem de aviso aparece toda vez que um marcador é convertido.

Se a validação falhar ou se a chave já existir, a importação vai pular a linha e uma mensagem de aviso vai aparecer.

A seguir