La función de importación y exportación de Migrate to Virtual Machines te permite crear, exportar o revisar las VMs que migran mediante un archivo CSV.
Requisitos para la migración
Antes de usar la función de importación y exportación, debes revisar los requisitos para migrar VMs individuales o grupos de VMs. Se aplican los mismos requisitos cuando se administran las migraciones mediante CSV.
Para obtener más información sobre las migraciones, consulta la documentación sobre Migrate to Virtual Machines en las siguientes páginas:
Descripción general de importación y exportación
Puedes usar la función de exportación a fin de generar un archivo CSV que detalla las VM de origen o las VMs actuales y sus detalles de destino, editarlo de forma externa y, luego, subir el CSV a Migrate to Virtual Machines para definir las migraciones.
Cuando edites y, luego, importes el archivo CSV, debes tener en cuenta el estado final de la migración. En otras palabras, puedes definir la configuración en tu archivo CSV y el proceso de importación creará migraciones y grupos, cambiará las membresías de los grupos y actualizará los detalles del destino para que coincidan con el estado de tu archivo CSV importado.
Para definir un archivo CSV a fin de realizar el proceso de importación, tienes varias opciones:
- Exporta los detalles de migración existentes como un archivo CSV para editar de forma masiva y subir grupos.
- Exporta las VM de origen desde un inventario de origen como un archivo CSV
- Descarga y edita un archivo CSV de plantilla
Si tu archivo CSV tiene un formato incorrecto o un detalle de migración específico no es válido, recibirás un error mientras lo subes a Migrate to Virtual Machines.
Formato de archivo CSV
Antes de realizar cualquier acción, se analizará y validará el archivo CSV importado según los siguientes criterios:
- Las migraciones y VMs de origen se identificarán como una combinación de nombre de la fuente, región de origen y el nombre visible de la VM de origen o el ID de la VM de origen.
- La misma migración o VM de origen no puede aparecer en más de una fila.
- No se pueden procesar más de 100 migraciones o VMs de origen en un solo archivo.
- Si no existe una migración para la VM de origen, la existencia de la VM de origen se valida y se creará una migración nueva para ella.
- La función de migración de importación y exportación valida las columnas de detalles de destino por el tipo y las restricciones de denominación de recursos. Debes validar de forma manual la existencia de recursos en el proyecto de destino para evitar fallas.
- Las columnas que faltan en el archivo CSV se ignorarán y las migraciones no se actualizarán en esos campos. Sin embargo, los valores vacíos actualizarán la migración respectiva y quitarán datos de esa migración.
- Las columnas pueden contener varios valores por VM (como etiquetas o etiquetas de red), separados por saltos de línea. Consulta Exporta un archivo de plantilla para ver un ejemplo.
Algunos errores de validación bloquearán la continuación de la importación. Por ejemplo, una fila de encabezado no válida o un archivo con demasiadas filas arrojará un error de validación.
Campos de archivos CSV
Se espera una fila de encabezado que debe contener las siguientes columnas que identifiquen la migración o la VM de origen. Otras columnas son opcionales y solo se actualizarán cuando se importen si existen. Se ignorarán las columnas de encabezado desconocidas.
Los campos obligatorios para tu archivo CSV incluyen lo siguiente:
- Nombre del origen
- Región
- Nombre visible de la VM de origen o ID de la VM de origen
Para obtener más información sobre los campos opcionales, consulta Configura el destino de una VM migrada.
Archivos de plantillas
Puedes exportar un archivo de plantilla para ayudarte a definir tu archivo CSV. El archivo CSV de la plantilla está vacío, excepto por una fila de encabezado que detalla los campos obligatorios y opcionales y una fila de muestra que proporciona ejemplos de cómo se debe formatear cada columna. En la plantilla, los detalles del destino están representados por las columnas del archivo CSV.
Exporta un archivo CSV completado previamente
Para crear migraciones basadas en VM de origen o realizar cambios en una migración o grupo de migraciones existente, primero debes exportar un archivo CSV que represente el estado actual de las migraciones.
Para exportar un archivo CSV completado previamente, sigue estos pasos:
- Abre la página Migrate to Virtual Machines en la consola de Google Cloud.
Para exportar una lista de VM de origen, sigue estos pasos:
- Selecciona la pestaña Fuentes.
- Selecciona las VM de origen que deseas exportar desde el inventario.
- Haz clic en Exportar para descargar el archivo CSV.
Para exportar grupos de migraciones existentes, haz lo siguiente:
- Selecciona la pestaña Grupos.
- Selecciona los grupos que deseas exportar de la lista grupal.
- Haz clic en Exportar para descargar el archivo CSV.
Importa tu archivo CSV
Cuando subas un archivo CSV, se validará. Si algunas líneas del archivo tienen errores, se presentarán y podrás omitirlas y, luego, importar el resto.
Después de subir un archivo CSV validado, se presentará un plan de importación para que lo apruebes. El archivo se importará cuando se apruebe.
Para importar tu archivo CSV, sigue estos pasos:
- Abre la página Migrate to Virtual Machines en la consola de Google Cloud.
- Selecciona la pestaña Grupos y, luego, Importar.
Busca tu archivo de importación. Debe ser un archivo CSV y pesar 100 KB o menos.
Selecciona Subir.
Si hay errores, se te presentarán en este paso. Puedes elegir Omitir errores y continuar.
Aparecerá un plan de importación. Esto detallará qué acciones se están invocando y a qué recursos se hace referencia.
Selecciona Iniciar importación para aprobar el plan de importación y comenzar la importación. El plan de importación se actualizará con el progreso de cada paso.
Si la importación no se completa, revisa los mensajes de error como se proporcionaron. La falla de cualquier paso detendrá toda la secuencia.
En una importación exitosa, selecciona Ir a grupos para volver a la página Grupos y revisar tus recursos actualizados.
Revisa tu plan de importación
Un plan de importación es una lista de acciones generadas de acuerdo con los cambios detectados en tu archivo de importación. Se podrían enumerar los siguientes tipos de mensajes:
- Crear migraciones.
- Crear un grupo.
- Quitar las migraciones de un grupo.
- Agregar migraciones a un grupo.
- Actualizar los detalles del destino de las migraciones.
Si aceptas el plan de importación, el estado de cada elemento se actualizará a medida que avance la importación. En el informe, podrá ver el estado, como Pendiente, En ejecución, Listo y Con errores a medida que se correlaciona con cada elemento.
Exporta el archivo de la plantilla de migración
Puedes exportar un archivo de plantilla de migración para obtener detalles sobre cómo darle formato al archivo CSV de forma correcta.
Para exportar tu archivo de plantilla de migración, sigue estos pasos:
- Abre la página Migrate to Virtual Machines en la consola de Google Cloud.
- Selecciona la pestaña Grupos.
- Selecciona Importar.
- Selecciona Exportar plantilla y se te solicitará que descargues el archivo
Template.csv.