Importar tabelas geradas manualmente

Com o Migration Center, é possível fazer upload das tabelas de dados preenchidas manualmente usando os modelos fornecidos. Isso é útil quando a infraestrutura tem um número limitado de recursos e você quer criar os dados manualmente.

Para importar as tabelas preenchidas 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 no Migration Center.

Limitações

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

Modelos de dados disponíveis

A tabela a seguir fornece os modelos de arquivo que podem ser usados para fazer upload dos dados de infraestrutura para o Migration Center. Os modelos contêm dados de amostra como uma 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. Essa tabela é necessária sempre que você cria uma nova importação.
perfInfo.csv Dados de desempenho Opcional: use esse modelo para fornecer dados de desempenho dos seus recursos em formato de série temporal.
diskInfo.csv Dados do disco Opcional: use este modelo para fornecer informações sobre discos e a utilização deles.
tagInfo.csv Tags do sistema Opcional: use esse modelo para atribuir rótulos aos recursos. Os rótulos precisam seguir os requisitos de rótulos no 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.

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

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

  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 usando os arquivos, 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 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.
  2. Opcional: acesse o job de importação para confirmar se ele foi criado corretamente.

    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: 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ê precisará corrigir o job ou arquivos específicos, e isso pode exigir a exclusão de arquivos ou o 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 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 resolver mensagens de erro comuns.

Revisar o upload

Depois que você faz upload dos arquivos, o Migration Center os valida para verificar se estão formalmente corretos. Se a validação for bem-sucedida, o Migration Center processa os dados para criar novos recursos ou atualizar os atuais. Verifique o status dos 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 tente fazer 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, revise 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 recursos e os campos de dados que causam os erros e ver uma descrição do erro. Erros no job de importação de arquivos podem impedir que o Migration Center crie novos recursos ou atualize os atuais com as novas alterações. Para corrigir o erro, edite os arquivos e crie um novo job de importação de arquivos para fazer upload deles 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 da potência da máquina.
ProvisioningState string O estado de provisionamento, apenas 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.
TimeStamp Carimbo de data/hora em que a amostra foi coletada.
CpuUtilizationPercentage float A porcentagem da capacidade total da CPU usada. Ele precisa estar no intervalo de 0 a 100.
MemoryUtilizationPercentage float A porcentagem usada da memória do sistema. Ele precisa estar no intervalo de 0 a 100.
UtilizedMemoryBytes float A memória total usada em bytes.
DiskReadOperationsPerSec float As IOPS médias amostradas em um período curto.
DiskWriteOperationsPerSec float As IOPS médias amostradas em um período curto.
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 os requisitos de 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 convertê-lo:

  1. Apenas para chaves, remove todos os caracteres iniciais que não são letras do alfabeto em inglês.
  2. Ele substitui todas as letras maiúsculas por minúsculas.
  3. Ela substitui todos os caracteres inválidos por sublinhados (_).
  4. A etiqueta 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