A Central de migração permite fazer upload de tabelas de dados que você preenche manualmente usando os modelos fornecidos. Isso é útil se a infraestrutura tiver um número limitado de recursos e você quiser criar os dados manualmente.
Para importar as tabelas que você preencheu manualmente, siga estas etapas:
- Faça o download dos modelos na lista de modelos disponíveis.
- Preencha manualmente as tabelas com os dados da sua infraestrutura.
- Faça upload das tabelas na Central de migração.
Limitações
- O tamanho máximo para upload de um arquivo é de 100 MB.
Modelos de dados disponíveis
A tabela a seguir mostra os modelos de arquivo que podem ser usados para enviar os dados de infraestrutura para a 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. 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 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 este modelo para atribuir rótulos aos recursos. Os rótulos precisam seguir os requisitos para 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
Acesse a página Importação de dados.
Clique em Adicionar dados > Fazer upload de arquivos.
Na seção Configurar o upload de arquivos, insira o nome do upload de arquivos.
Na lista Formato do arquivo, selecione Modelos de CSV preenchidos manualmente.
Clique em Selecionar arquivos para fazer upload e selecione todos os arquivos que você quer enviar.
Para confirmar e começar o upload dos arquivos, clique em Fazer upload de arquivos.
Se os arquivos forem validados corretamente, para criar os recursos com base neles, 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 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 origem existente a ser associada ao job de importação.
Opcional: para confirmar se o job de importação foi criado corretamente, acesse 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_MANUAL_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
signedUrlda 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 das etapas de visualização.
Opcional: repita as etapas 3 a 6 para criar mais arquivos de dados no mesmo job de importação.
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
Valide o job de importação.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Acesse o job de importação e confira o relatório de validação. Se o estado for
READY, será possível continuar para as próximas etapas. Caso contrário, você precisa corrigir o job ou arquivos específicos. 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
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 confira o relatório de execução. Se o estado for
COMPLETED, o job foi executado com sucesso. 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 mudanças 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, saiba como resolver mensagens de erro comuns.
Analisar o upload
Depois que você faz upload dos arquivos, a Central de migração os valida para verificar se eles estão formalmente corretos. 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 revisar.
- Na página de envio de arquivos, em Progresso da importação de dados, confira 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 outro arquivo terminar o processamento.
- Em execução. Seu arquivo está sendo processado.
- Validação. Seu arquivo está na fase 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 detalhes do erro
Se você encontrar erros após importar os arquivos, poderá 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 Envios 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 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 crie novos recursos ou atualize os existentes com as novas mudanças. Para corrigir o erro, edite seus arquivos e crie um novo job de importação de arquivos para fazer o 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 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 | O carimbo de data/hora em que a amostra foi coletada. | |
| CpuUtilizationPercentage | float | A porcentagem da capacidade total da CPU usada. Precisa estar no intervalo 0 a 100. |
| MemoryUtilizationPercentage | float | A porcentagem de memória do sistema usada. Precisa estar no intervalo 0-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 de rede média em B/s, coletada em um curto período. |
| NetworkBytesPerSecReceived | float | A entrada de rede média em B/s, coletada em uma janela curta. |
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 identificadores que você enviar com o arquivo tagInfo precisam seguir os requisitos para identificadores no Google Cloud. Se o rótulo não estiver em conformidade com os requisitos, o Migration Center vai usar a seguinte estratégia para convertê-lo:
- Apenas para chaves, ele remove todos os caracteres iniciais que não sejam letras do alfabeto inglês.
- Ele substitui todas as letras maiúsculas por letras minúsculas.
- Ele substitui todos os caracteres inválidos por sublinhados (
_). - Ele trunca o rótulo para um máximo de 62 caracteres.
- Ele adiciona o sufixo
_<CRC32>, calculado com base na string original.
Uma mensagem de aviso aparece sempre 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
- Saiba mais sobre os métodos de coleta da Central de migração.
- Saiba como gerenciar seus uploads de arquivos.