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:
- 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 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
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 Modelos de CSV preenchidos manualmente.
Clique em Selecionar arquivos para upload e escolha 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 a partir do 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 fonte existente a ser associados ao job de importação.
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
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
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 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
, é 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, 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:
- 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 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:
- 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 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:
- 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 minúsculas.
- Ela substitui todos os caracteres inválidos por sublinhados (
_
). - Ela trunca o rótulo até um máximo de 62 caracteres.
- 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
- Saiba mais sobre os métodos de coleta da Central de migração.
- Saiba como gerenciar uploads de arquivos.