El Centro de migraciones te permite subir tablas de datos que debes completar manualmente con las plantillas proporcionadas. Esto es útil si tu infraestructura tiene una cantidad limitada de recursos y deseas crear los datos de forma manual.
Para importar las tablas que completaste de forma manual, sigue estos pasos:
- Descarga las plantillas de la lista de plantillas disponibles.
- Completa las tablas de forma manual con los datos de tu infraestructura.
- Sube las tablas al Centro de migraciones.
Limitaciones
- El tamaño máximo de carga de un archivo es de 100 MB.
Plantillas de datos disponibles
En la siguiente tabla, se proporcionan las plantillas de archivos que puedes usar para subir tus datos de infraestructura a Migration Center. Las plantillas contienen datos de muestra como sugerencia para completar la tabla. Para obtener una descripción detallada del formato de datos requerido, consulta Especificaciones de los archivos de importación
Nombre del archivo | Tipo de datos | Descripción |
---|---|---|
vmInfo.csv | Información de la máquina | Usa esta plantilla para brindar información sobre recursos individuales, incluidos la CPU, la memoria y otros parámetros de configuración. Esta tabla es obligatoria cada vez que creas una importación nueva. |
perfInfo.csv | Datos de rendimiento | Opcional: Usa esta plantilla para proporcionar datos de rendimiento para tus recursos en un formato de serie temporal. |
diskInfo.csv | Datos del disco | Opcional: Usa esta plantilla para proporcionar información sobre los discos y su uso. |
tagInfo.csv | Etiquetas del sistema | Opcional: Usa esta plantilla para asignar etiquetas a los activos. Etiquetas debe cumplir con los requisitos para las etiquetas en Google Cloud. |
Para obtener más información sobre las especificaciones de cada archivo, consulta Especificaciones de los archivos de importación.
Sube las tablas
Para subir los archivos, sigue estos pasos:
Console
Ve a la página Importación de datos.
Haz clic en Agregar datos > Subir archivos.
En la sección Configurar carga de archivos, ingresa el nombre de la carga de archivos.
En la lista Formato de archivo, selecciona Plantillas de CSV propagadas manualmente.
Haz clic en Seleccionar archivos para subir y, luego, selecciona todos los archivos que desees subir.
Para confirmar y comenzar a subir los archivos, haz clic en Subir archivos.
Si los archivos se validan correctamente, para crear los recursos a partir de ellos, haz clic en Importar datos y, luego, en Confirmar.
API
Crea un trabajo de importación.
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" }
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID del proyecto para crear la un trabajo de importación.REGION
: Es la región en la que se creará el trabajo de importación.IMPORT_JOB_ID
: El ID del trabajo de importación nuevo.SOURCE_ID
: Es el ID de una fuente existente que se asociará con el trabajo de importación.
Opcional: Para confirmar que el trabajo de importación se creó correctamente, obtener el trabajo de importación.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Crea un archivo de datos de importación adjunto al trabajo de importación.
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" }
Reemplaza lo siguiente:
DATA_FILE_ID
: Es el ID del nuevo archivo de datos.IMPORT_JOB_FORMAT
:IMPORT_JOB_FORMAT_MANUAL_CSV
Obtén el archivo de datos.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
Copia la URL del campo
signedUrl
de la respuesta.Sube un archivo a la URL copiada.
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
Reemplaza lo siguiente:
UPLOAD_FILE_PATH
: Es la ruta de acceso local del que se suba.COPIED_URL
: La URL firmada copiada de los pasos de vista previa.
Opcional: Repite los pasos del 3 al 6 para crear más archivos de datos en la misma tarea de importación.
Opcional: Obtén todos los archivos de datos de un trabajo de importación.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
Valida el trabajo de importación.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Obtén el trabajo de importación y consulta el informe de validación. Si el estado es
READY
, es posible continuar con los pasos siguientes. De lo contrario, debes corregir el trabajo o archivos específicos. Esto puede requerir borrar archivos o subir otros nuevos.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Ejecuta el trabajo de importación.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
Obtén el trabajo de importación y consulta el informe de ejecución. Si el estado es
COMPLETED
, el trabajo se ejecutó de forma correcta. De lo contrario, si el trabajo falló y en estado terminal, el informe de ejecución incluye los errores. Crea un trabajo de importación nuevo y aplica los cambios necesarios.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Si tienes problemas al subir el archivo, consulta cómo Solucionar problemas de mensajes de error comunes.
Revisa la carga
Después de subir tus archivos, el Centro de migraciones los valida para verificar si son correctos de forma formal. Si la validación se realiza correctamente, Migration Center procesará los datos para crear recursos nuevos o actualizar los existentes. Verifica el estado de los trabajos de carga desde la consola de Google Cloud.
Para revisar el estado de tu trabajo de carga, sigue estos pasos:
- Ve a la página Importación de datos y, luego, haz clic en Cargas de archivos.
- En la lista de importaciones de archivos, selecciona la carga que deseas revisar.
- En la página de carga de archivos, en Progreso de la importación de datos, revisa el Estado de los archivos que subiste.
Tus archivos pueden tener uno de los siguientes estados.
Lista de estados
- Completado. Se importó correctamente el archivo.
- Listo. Tu archivo pasó la validación y está listo para importarse.
- Pendiente. Tu archivo está esperando a que se termine de procesar otro.
- En ejecución. Se está procesando tu archivo.
- Validación: Tu archivo está en la etapa de validación.
- Validación con errores. Tu archivo contiene algunos errores. Corrige los errores y, luego, intenta subir el archivo nuevamente.
- Fallida. No se pudo importar el archivo.
Revisa los detalles del error
Si encuentras errores después de importar los archivos, puedes revisar el mensaje de error directamente en la consola de Google Cloud.
Para revisar los errores de tu trabajo de carga, sigue estos pasos:
- Ve a la página Importación de datos y, luego, haz clic en Subidas de archivos.
- Haz clic en el archivo de importación que muestra una advertencia o un error. La página de detalles del archivo de importación muestra la lista completa de errores.
En la página de detalles del archivo de importación, puedes revisar los activos y los campos de datos que causan los errores, así como ver una descripción del error. Los errores en el trabajo de importación del archivo podrían impedir que el Centro de migraciones haga lo siguiente: crear nuevos recursos o actualizar los existentes con los nuevos cambios. Para corregir el error, edita tus archivos y crea un nuevo trabajo de importación de archivos para subirlos de nuevo.
Para obtener más información sobre los posibles mensajes de error, consulta Soluciona problemas de importación de archivos.
Especificaciones de los archivos de importación
En las siguientes tablas se muestran las especificaciones técnicas de los archivos de plantilla para la importación manual.
Archivo vmInfo
Columna | Tipo esperado | Descripción |
---|---|---|
MachineId | string | Es el identificador único de la máquina virtual. |
MachineName | string | El nombre visible de la máquina virtual. |
PrimaryIPAddress | string | La dirección IP de la máquina. |
PrimaryMACAddress | string | La dirección MAC de la máquina Esto solo se usa para identificar máquina. |
PublicIPAddress | string | La dirección IP pública de la máquina. |
IpAddressListSemiColonDelimited | Lista de mensajes | Es la lista de direcciones de red asignadas o asignadas. |
TotalDiskAllocatedGiB | int64 | La capacidad total del disco. |
TotalDiskUsedGiB | int64 | La cantidad total de espacio usado en el disco. |
MachineTypeLabel | string | La etiqueta del tipo de máquina de AWS o Azure. |
AllocatedProcessorCoreCount | int64 | Cantidad de núcleos de CPU en la máquina virtual. |
MemoryGiB | int32 | La cantidad de memoria de la máquina virtual. |
HostingLocation | string | La ubicación de la máquina en formato AWS o Azure. |
OsType | string | Es el SO de la máquina. |
OsName | string | Es el SO de la máquina. |
OsVersion | string | La versión del SO de la máquina. |
MachineStatus | string | Es el estado de la alimentación de la máquina. |
ProvisioningState | string | El estado de aprovisionamiento, solo para las VMs de Azure. |
CreateDate | Marca de tiempo | La marca de tiempo de creación de la máquina. |
IsPhysical | string | Si la máquina es física o virtual. |
Fuente | mensaje | Los detalles de la fuente para las máquinas de AWS o Azure |
Archivo diskInfo
Columna | Tipo esperado | Descripción |
---|---|---|
MachineId | string | Es el identificador único de la máquina virtual. |
DiskLabel | string | La etiqueta del disco. |
SizeInGib | int64 | Es la capacidad total del disco. |
UsedInGib | int64 | La cantidad total de espacio usado en el disco. |
StorageTypeLabel | string | Es el tipo de etiqueta de disco (por ejemplo, BIOS o GPT). |
Archivo perfInfo
Columna | Tipo esperado | Descripción |
---|---|---|
MachineId | string | Es el identificador único de la máquina virtual. |
TimeStamp | Es la marca de tiempo del momento en que se recopiló la muestra. | |
CpuUtilizationPercentage | float | Es el porcentaje de la capacidad total de la CPU que se usa. Debe estar entre 0 y 100. |
MemoryUtilizationPercentage | float | El porcentaje de memoria del sistema usado. Debe estar entre 0 y 100. |
UtilizedMemoryBytes | float | Es la memoria total usada en bytes. |
DiskReadOperationsPerSec | float | Es el promedio de IOPS muestreados en un período breve. |
DiskWriteOperationsPerSec | float | Es el promedio de IOPS muestreados en un período breve. |
NetworkBytesPerSecSent | float | La salida de red promedio en B/s, muestreada en un período corto. |
NetworkBytesPerSecReceived | float | La entrada de red promedio en B/s, muestreada en un período corto. |
Archivo tagInfo
Columna | Tipo esperado | Descripción |
---|---|---|
MachineId | string | Es el identificador único de la máquina virtual. |
Clave | string | Es la clave de etiqueta. |
Valor | string | Es el valor de la etiqueta. |
Algoritmo de análisis de etiquetas
Las etiquetas que subas con el archivo tagInfo deben cumplir con los requisitos de las etiquetas en Google Cloud. Si la etiqueta no cumple con los requisitos, el Centro de migraciones usa la siguiente estrategia para convertirla:
- Solo para las claves, se quitan todos los caracteres iniciales que no son letras del alfabeto inglés.
- Reemplaza todas las letras mayúsculas por minúsculas.
- Reemplaza todos los caracteres no válidos por guiones bajos (
_
). - Trunca la etiqueta a un máximo de 62 caracteres.
- Agrega el sufijo
_<CRC32>
, calculado en función de la cadena original.
Cada vez que se convierte una etiqueta aparece un mensaje de advertencia.
Si la validación falla o si la clave ya existe, la importación omite la fila. y aparecerá un mensaje de advertencia.
¿Qué sigue?
- Obtén más información sobre los métodos de recopilación de Migration Center.
- Obtén más información para administrar las cargas de archivos.