El Centro de migraciones te permite subir tablas de datos que puedes completar de forma manual con las plantillas proporcionadas. Esto es útil si tu infraestructura tiene una cantidad limitada de elementos 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 manualmente las tablas con los datos de tu infraestructura.
- Sube las tablas al Centro de migraciones.
Limitaciones
- El tamaño máximo para subir un archivo es de 100 MB.
Plantillas de datos disponibles
En la siguiente tabla, se proporcionan las plantillas de archivo que puedes usar para subir tus datos de infraestructura al Centro de migraciones. Las plantillas contienen datos de muestra como una sugerencia sobre cómo completar la tabla. Para obtener una descripción detallada del formato de datos requerido, consulta Especificaciones de los archivos para importar.
| Nombre del archivo | Tipo de datos | Descripción |
|---|---|---|
| vmInfo.csv | Información de la máquina | Usa esta plantilla para proporcionar información sobre elementos 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 de 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 recursos. Las etiquetas deben cumplir con los requisitos para las etiquetas de 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 Add Data: Se abrirá una página nueva.
Selecciona Subir archivos y, luego, en Configurar carga de archivos, ingresa el nombre del archivo de carga.
En la lista, selecciona Plantillas CSV completadas manualmente.
Haz clic en Seleccionar archivos para subir y selecciona todos los archivos que deseas subir.
Para confirmar y comenzar a subir los archivos, haz clic en Subir archivos.
Si los archivos se validan de forma correcta, haz clic en Importar datos (Import data) para crear los elementos a partir de ellos y, luego, en Confirmar (Confirm).
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 que se creará para el 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 nuevoSOURCE_ID: Es el ID de una fuente existente que se asociará con el trabajo de importación.
Opcional: Obtén el trabajo de importación para confirmar que se creó de forma correcta.
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 archivo de datos nuevo.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
signedUrlde 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 local del archivo que se sube.COPIED_URL: La URL firmada copiada de los pasos de vista previa.
Repite los pasos 3 a 6 para crear más archivos de datos en el mismo trabajo de importación (opcional).
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 visualiza 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 algunos 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 visualiza 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 está en un estado terminal, el informe de ejecución incluirá 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 con la carga de archivos, consulta cómo solucionar problemas comunes de mensajes de error comunes.
Revisa la carga
Después de que subes tus archivos, el Centro de migraciones los valida para verificar si son formalmente correctos. Si la validación se realiza correctamente, el Centro de migraciones procesa los datos para crear recursos nuevos o actualizar los existentes. Puedes verificar el estado de tus trabajos de carga en 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 quieras revisar.
- En la página de carga de archivos, en Progreso de la importación de datos, revisa el Estado de los archivos subidos.
Puedes ver tus archivos con uno de los siguientes estados.
Lista de estados
- Completado. Se importó tu archivo correctamente.
- Listo. Tu archivo pasó la validación y está listo para importarse.
- Pendiente. El archivo está esperando que termine de procesarse otro archivo.
- En ejecución. Se está procesando tu archivo.
- Validación. Tu archivo se encuentra en la etapa de validación.
- Error de validación: Tu archivo contiene algunos errores. Corrige los errores e intenta subir tu archivo nuevamente.
- Fallida. No se pudo importar el archivo.
Revisa los detalles del error
Si encuentras errores después de importar tus 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 Cargas de archivos.
- Haz clic en el archivo de importación que muestra una advertencia o un error. En la página de detalles del archivo de importación, se muestra la lista completa de errores.
En la página de detalles del archivo de importación, puedes revisar los campos de elementos y datos que causan los errores y ver una descripción del error. Los errores en el trabajo de importación de archivos pueden impedir que el Centro de migraciones cree recursos nuevos o actualice los existentes con los cambios nuevos. Para corregir el error, edita tus archivos y crea un trabajo de importación de archivos nuevo para volver a subirlos.
Para obtener más información sobre los posibles mensajes de error, consulta Cómo solucionar errores de importación de archivos.
Especificaciones de la importación de archivos
En las siguientes tablas, se muestran las especificaciones técnicas de los archivos de plantilla que se usan 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 | Es el nombre visible de la máquina virtual. |
| PrimaryIPAddress | string | Es la dirección IP de la máquina. |
| PrimaryMACAddress | string | Es la dirección MAC de la máquina. Solo se usa para identificar la 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 | Es la cantidad total de espacio utilizado 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 | Es la cantidad de memoria de la máquina virtual. |
| HostingLocation | string | Es la ubicación de la máquina en formato AWS o Azure. |
| OsType | string | El SO de la máquina. |
| OsName | string | El SO de la máquina. |
| OsVersion | string | Es la versión del SO de la máquina. |
| MachineStatus | string | Es el estado de energía de la máquina. |
| ProvisioningState | string | El estado de aprovisionamiento, solo para las VMs de Azure. |
| CreateDate | Marca de tiempo | Es la marca de tiempo de creación de la máquina. |
| IsPhysical | string | Si la máquina es física o máquina virtual |
| Origen | message | Los detalles de la fuente de 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 | Es la etiqueta del disco. |
| SizeInGib | int64 | La capacidad total del disco. |
| UsedInGib | int64 | Es la cantidad total de espacio utilizado en el disco. |
| StorageTypeLabel | string | Es el tipo de etiqueta del 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 | La marca de tiempo en la que se recopiló la muestra. | |
| CpuUtilizationPercentage | float | El porcentaje de capacidad total de CPU usada. Debe estar en el intervalo de 0 a 100. |
| MemoryUtilizationPercentage | float | El porcentaje de memoria del sistema usado. Debe estar en el intervalo de 0 a 100. |
| UtilizedMemoryBytes | float | Es la memoria total utilizada en bytes. |
| DiskReadOperationsPerSec | float | Las IOPS promedio muestreadas durante un período breve. |
| DiskWriteOperationsPerSec | float | Las IOPS promedio muestreadas durante un período breve. |
| NetworkBytesPerSecSent | float | La salida de red promedio en B/s, muestreada en un período breve. |
| NetworkBytesPerSecReceived | float | La entrada de red promedio en B/s, muestreada en un período breve. |
Archivo tagInfo
| Columna | Tipo esperado | Descripción |
|---|---|---|
| MachineId | string | Es el identificador único de la máquina virtual. |
| Clave | string | La clave de etiqueta. |
| Valor | string | El valor de la etiqueta. |
Algoritmo de análisis de etiquetas
Las etiquetas que subas con el archivo tagInfo deben cumplir con los requisitos para 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 aparece un mensaje de advertencia.
¿Qué sigue?
- Obtén más información sobre los métodos de recopilación del Centro de migraciones.
- Obtén información sobre cómo administrar tus cargas de archivos.