Com a Central de migração, é possível fazer o upload de 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 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 o upload das tabelas para a Central de migração.
Limitações
- O tamanho máximo para o upload de um arquivo é de 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 a Central de migração. Os modelos têm dados de amostra como sugestão de preenchimento da tabela. Para uma descrição detalhada do formato de dados necessário, consulte Especificações de arquivos de importação.
| Nome do arquivo | Tipo de dado | Descrição |
|---|---|---|
| vmInfo.csv | Informações do computador | Use-o para fornecer informações sobre recursos individuais, incluindo CPU, memória e outros parâmetros de configuração. Essa tabela será necessária sempre que você criar uma nova importação. |
| perfInfo.csv | Dados de desempenho | Opcional: use esse modelo para fornecer dados de performance dos seus recursos em um formato de série temporal. |
| diskInfo.csv | Dados do disco | Opcional: use este modelo para enviar informações sobre discos e o uso deles. |
| tagInfo.csv | Tags do sistema | Opcional: use esse 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 Importar especificações 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. Uma nova página é aberta.
Selecione Fazer upload de arquivos e, em Configurar upload de arquivos, insira o nome do upload.
Na lista, selecione Modelos de CSV preenchidos manualmente.
Clique em Selecionar arquivos para upload e selecione todos os arquivos que você quer enviar.
Para confirmar e começar a enviar os arquivos, clique em Enviar arquivos.
Se os arquivos estiverem validados corretamente, para criar os recursos dos arquivos, 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 será criado.REGION: região em que o job de importação será criado.IMPORT_JOB_ID: ID do novo job de importação.SOURCE_ID: ID de uma fonte existente a ser associada ao job de importação.
Opcional: receba o job de importação para confirmar que ele foi criado corretamente.
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 dados.IMPORT_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 que é enviado.COPIED_URL: o URL assinado copiado das etapas de visualizações.
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
Acesse o job de importação e confira o relatório de validação. Se o estado for
READY, será possível prosseguir para as próximas etapas. Caso contrário, você precisará corrigir o job ou arquivos específicos, o que 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 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 problemas de mensagens de erro comuns.
Revisar o upload
Depois de fazer upload dos arquivos, a Central de migração os valida para verificar se estão formalmente corretos. Se a validação for bem-sucedida, a Central de migração processará os dados para criar novos recursos ou atualizar os atuais. É possível verificar o status dos jobs de upload no console do Google Cloud.
Para analisar o status do seu job de upload, siga estas etapas:
- Acesse a página Importação de dados e clique em Uploads 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, confira o Status dos arquivos enviados.
Você pode ver os arquivos em um dos status a seguir.
Lista de status
- Concluído. O arquivo foi importado.
- Pronto. Seu arquivo foi validado 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 os arquivos, revise 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 analisar 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 a Central de migração 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 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
Veja nas tabelas a seguir as especificações técnicas dos arquivos de modelo usados para a 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. Isso é 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 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 de máquinas com AWS ou 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 | 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 de 0 a 100. |
| MemoryUtilizationPercentage | float | A porcentagem de memória do sistema usada. 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 curto período. |
| DiskWriteOperationsPerSec | float | As IOPS médias amostradas em um curto período. |
| NetworkBytesPerSecSent | float | A saída de rede média em B/s, amostrada em um curto período. |
| NetworkBytesPerSecReceived | float | A média de entrada de rede em B/s, amostrada em um curto período. |
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 para rótulos no Google Cloud. Se o rótulo não estiver em conformidade com os requisitos, a Central de migração usará a seguinte estratégia para convertê-lo:
- Para chaves, ela remove todos os caracteres iniciais que não sejam letras do alfabeto inglês.
- Ela substitui todas as letras maiúsculas por minúsculas.
- Ela substitui todos os caracteres inválidos por sublinhados (
_). - Ela 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.
- Aprenda a gerenciar uploads de arquivos.