Utilidades de migración de imágenes de OCI
Puede migrar imágenes de Oracle Linux locales a Oracle Cloud Infrastructure con las utilidades oci-image-migrate
.
Las utilidades
oci-image-migrate
no forman parte de las utilidades de OCI preinstaladas, pero están disponibles en el repositorio addons
. Debe instalar manualmente las utilidades oci-image-migrate
en la imagen local.Compatibilidad
Puede utilizar las utilidades para migrar tanto máquinas virtuales como hosts físicos a Oracle Cloud Infrastructure. Para migrar, debe crear una imagen de disco compatible y guardarla en una ubicación compartida donde un host de Oracle Linux pueda acceder a ella. Las utilidades de migración funcionan con el formato de imagen de disco por defecto de Oracle VM VirtualBox (VMDK) o el formato de imagen de disco QEMU copy-on-write (QCOW2) que se suele utilizar con Oracle Linux KVM.
Cómo modifican la imagen las utilidades
Las utilidades verifican que el sistema operativo de la máquina virtual está soportado y realizan los cambios necesarios para garantizar que se ejecute correctamente como instancia informática en Oracle Cloud Infrastructure. Para obtener más información sobre los cambios que estas utilidades automatizan, consulte Traiga su propio dispositivo (BYOI).
Migración de una imagen con oci-image-migrate
Instale las utilidades oci-image-migrate
, convierta las instalaciones físicas en una imagen de disco virtual y migre la imagen de disco virtual a Oracle Cloud Infrastructure.
Instalación de las utilidades de migración
Instale las utilidades en el sistema host antes de la migración.
Oracle Linux 9
-
Active el repositorio de yum
ol9_addons
para Oracle Linux 9:sudo dnf config-manager --enable ol9_addons
-
Actualice el sistema mediante el comando
dnf update
y, a continuación, instale los paquetes necesarios:sudo dnf update -y sudo dnf install -y python36-oci-sdk python36-oci-cli oci-utils-migrate
-
Si desea migrar una instalación física, instale el paquete qemu-img:
sudo dnf install -y qemu-img
Oracle Linux 8
-
Active el repositorio de yum
ol8_addons
para Oracle Linux 8:sudo dnf config-manager --enable ol8_addons
-
Actualice el sistema mediante el comando
dnf update
y, a continuación, instale los paquetes necesarios:sudo dnf update -y sudo dnf install -y python36-oci-sdk python36-oci-cli oci-utils-migrate
-
Si desea migrar una instalación física, instale el paquete qemu-img:
sudo dnf install -y qemu-img
Oracle Linux 7 (soporte extendido)
-
Active los repositorios
ol7_addons
yol7_kvm_utils
para Oracle Linux 7:sudo yum-config-manager --enable ol7_addons ol7_kvm_utils
-
Actualice el sistema con el comando
yum update
y, a continuación, instale los paquetes necesarios:sudo yum update -y sudo yum install -y python36-oci-sdk python36-oci-cli oci-utils-migrate
-
Si desea migrar una instalación física, instale el paquete
qemu-img
:sudo yum install -y qemu-img
Conversión de una instalación física en una imagen de disco virtual
Para migrar una instalación física, cree una imagen de disco sin formato y, a continuación, conviértala a un formato de disco duro virtual (VMDK o QCOW2). A continuación, puede seguir las instrucciones de Migración de una imagen de disco virtual.
Creación de la imagen de disco sin formato
-
Antes de cerrar el equipo físico para crear la imagen, incluya temporalmente todos los controladores de dispositivos en el ramdisk inicial (
initramfs
):sudo dracut --force --no-hostonly
-
Después de apagar la máquina física, utilice un sistema de recuperación para crear una imagen de disco en una ubicación externa:
sudo dd if=device_or_volume of=path_to_image bs=4M status=progress conv=sync,noerror
- Seleccione un formato de disco VMDK (compatible con Oracle VM Virtualbox) o QCOW2 (compatible con Oracle Linux KVM) y, a continuación, convierta la imagen de disco.
Opción 1: Convertir a formato de disco de máquina virtual (VMDK)
-
Convierta la imagen de disco sin formato al formato de disco de máquina virtual (VMDK). Este formato de archivo se utiliza para discos duros virtuales compatibles con Oracle VM Virtualbox.
qemu-img convert -f raw -p -O vmdk raw_disk_image exported_file.vmdk
-
También puede probar el disco duro virtual antes de empaquetarlo e importarlo en Oracle Cloud Infrastructure.
Para obtener más información, consulte la sección sobre archivos de imagen de disco en la documentación de Oracle VM VirtualBox. Para obtener más información sobre el comando
qemu-img
, consulte la página del comando manqemu-img(1)
. - Vaya a Migración de una imagen de disco virtual a Oracle Cloud Infrastructure.
Opción 2: Convertir a formato QEMU Copy-on-Write (QCOW2)
-
Convierta la imagen de disco sin formato a QEMU copy-on-write (QCOW2). Este formato de almacenamiento se utiliza para discos duros virtuales compatibles con Oracle Linux KVM.
qemu-img convert -f raw -p -c -O qcow2 raw_disk_image exported_file.qcow2
-
También puede probar el disco duro virtual antes de empaquetarlo e importarlo en Oracle Cloud Infrastructure.
Para obtener más información, consulte el capítulo Trabajar con almacenamiento para invitados de KVM en la Guía del usuario de Oracle Linux KVM.
- Vaya a Migración de una imagen de disco virtual a Oracle Cloud Infrastructure.
Migración de una imagen de disco virtual a Oracle Cloud Infrastructure
Use las utilidades oci-image-migrate
para migrar una imagen de disco virtual a una instancia de Oracle Cloud Infrastructure.
Requisitos
Antes de realizar la migración, asegúrese de que ya:
- Ha configurado Identity and Access Management.
- Ha creado un cubo para Object Storage en el arrendamiento de Oracle Cloud Infrastructure.
- Ha configurado el SDK de Oracle Cloud Infrastructure con sus credenciales para el acceso de API. Consulte Configuración y requisitos.
- Ha completado la Conversión de una instalación física a una imagen de disco virtual (si migra un host físico).
Si no está familiarizado con Oracle Cloud Infrastructure, consulte la sección Introducción en la documentación de Oracle Cloud Infrastructure.
Uso de las utilidades para migrar la imagen
- Complete los requisitos.
- Verifique y realice un procesamiento previo del disco duro virtual en formato VMDK o QCOW2:
sudo oci-image-migrate -y -i unprocessed_virtual_hard_disk
- Cargue el disco duro virtual con procesamiento previo en un cubo de Oracle Cloud Infrastructure como una imagen personalizada:
oci-image-migrate-upload -y -i processed_virtual_hard_disk -b bucket_name -o image_name
- Importe el archivo de imagen desde almacenamiento de objetos del cubo de Oracle Cloud Infrastructure al repositorio de imágenes personalizado:
oci-image-migrate-import -y -i image_name -b bucket_name -c compartment_name
- Si ha realizado la migración desde un host físico, vuelva a generar
initramfs
en cada nueva instancia mediante la imagen personalizada importada:sudo dracut --force
Referencia de utilidades de migración
Obtenga más información sobre cada utilidad, incluida una descripción, las opciones y los ejemplos de uso.
oci-image-migrate
Descripción
Prepara una imagen local para la importación en Oracle Cloud Infrastructure. Debe ejecutar este comando como usuario root.
La utilidad oci-image-migrate
soporta la migración de archivos de imagen en formato qcow2
y vmdk
.
La utilidad realiza las siguientes acciones para preparar la imagen para la migración:
- Verifica los requisitos para importar la imagen.
- Desactiva las interfaces de red, excepto la interfaz de red principal, que se configura como cliente DHCP.
- Instala los paquetes recomendados, como el paquete
cloud-init
. La lista de paquetes instalados se muestra en el archivo/etc/oci-utils/oci-migrate-conf.yaml
. - Intenta acceder a servidores remotos que alojan repositorios de software de la imagen que se va a procesar. Los servidores de nombres del servidor de nombres de dominio (DNS) y la configuración de proxy deben poder acceder a los repositorios de software.
- Define el usuario de nube por defecto en
opc
.
Sintaxis
oci-image-migrate [-i unprocessed_virtual_hard_disk | --input-image unprocessed_virtual_hard_disk] [-y | --yes] [-v | --verbose] [-h | --help}
Opciones
-i unprocessed_virtual_hard_disk | --input-image unprocessed_virtual_hard_disk
- Especifique la ruta completa del el disco duro virtual sin procesar. Esta opción es obligatoria.
-y | --yes
- Responda "yes" a las peticiones de datos.
-v | --verbose
- Muestre información detallada durante el procesamiento de la imagen en el terminal. Esta información puede utilizarse para solucionar errores o supervisar el estado. Esta información de depuración también se escribe en /var/tmp.
-h | --help
- Muestre un resumen de las opciones de la línea de comandos.
Ejemplo
$ sudo oci-image-migrate /omv/data/images/ol79.vmdk -v
2021-03-30 20:38:38,177 - oci-utils.migrate-tools - DEBUG(migrate_tools:223) - __ Get config data: helpers_list
2021-03-30 20:38:38,205 - oci-utils.migrate-tools - DEBUG(migrate_tools:223) - __ Get config data: lc_all
...
oci-image-migrate-upload
Descripción
Carga un archivo de imagen local en un cubo de almacenamiento de objetos en Oracle Cloud Infrastructure. Este comando no requiere privilegios de usuario root, siempre que pueda acceder al cubo de almacenamiento de objetos en Oracle Cloud Infrastructure y tenga privilegios de escritura en los directorios en los que se escriben los archivos log y de resultados (/var/tmp/
).
Uso
oci-image-migrate-upload [-i processed_virtual_hard_disk | --input-image processed_virtual_hard_disk] [-b bucket_name | --bucket-name bucket_name] [-o output_name | --output-name output_name] [-y | --yes] [-v | --verbose] [-h | --help}
Opciones
-i processed_virtual_hard_disk | --input-image processed_virtual_hard_disk
- Especifique la ruta completa del el disco duro virtual procesado. Esta opción es obligatoria.
-b bucket_name | --bucket-name bucket_name
- Especifique el nombre del cubo de almacenamiento de objetos en Oracle Cloud Infrastructure para almacenar el archivo de imagen. Esta opción es obligatoria.
-o output_name | --output-name output_name
- Especifique el nombre del archivo de imagen que se va a utilizar en el almacenamiento de objetos. Si no se especifica, se utilizará el nombre del disco duro virtual procesado como nombre de la imagen.
-y | --yes
- Responda "yes" a las peticiones de datos.
-v | --verbose
- Muestre información detallada durante el procesamiento de la carga de la imagen en el terminal. Utilice esta información para solucionar errores o supervisar el estado. Esta información de depuración también se escribe en
/var/tmp
.
-h | --help
- Muestre un resumen de las opciones de la línea de comandos.
Ejemplo
$ oci-image-migrate-upload -v -i /omv/data/images/ol79.vmdk -b test_bucket_001 -o ol79_demo.qcow2
Uploading ol79.vmdk -b test_bucket_001 -o ol79_demo.qcow2 at Thu Mar 25 20:44:16 2021
Uploading /omv/data/images/ol79.vmdk to object storage test_bucket_001 in the Oracle Cloud Infrastructure as ol79_demo.qcow2
Object storage test_bucket_001 present.
Agree to proceed uploading /omv/data/images/ol79.vmdk to test_bucket_001 as ol79_demo.qcow2? (y/N) y
Uploading /omv/data/images/ol79.vmdk, this may take a while....
00:03:12 [ uploading ol79_demo.qcow2
oci-image-migrate-import
Descripción
Importa una imagen del almacenamiento de objetos al repositorio de imágenes personalizadas en Oracle Cloud Infrastructure. Este comando no requiere privilegios de usuario root, siempre que pueda acceder al cubo de almacenamiento de objetos en Oracle Cloud Infrastructure y tenga privilegios de escritura en los directorios en los que se escriben los archivos log y de resultados (/var/tmp/
).
Uso
oci-image-migrate-import[-i image_name | --input-image image_name] [-b bucket_name | --bucket-name bucket_name] [-c compartment_name | --compartment_name compartment_name] [-d display_name | display-name display_name] [-l launch_mode | launch-mode launch_mode] [-y | --yes] [-v | --verbose] [-h | --help}
Opciones
-i image_name | --input-image image_name
- Especifique el nombre de la imagen que desea importar como una imagen personalizada. Esta opción es obligatoria.
-b bucket_name| --bucket-name bucket_name
- Especifique el nombre del cubo de almacenamiento de objetos en Oracle Cloud Infrastructure donde se almacena el archivo de imagen. Esta opción es obligatoria.
-c compartment_name | --compartment-name compartment_name
- Especifique el nombre del compartimento de destino. Esta opción es obligatoria.
-d display_name | --display-name display_name
- Especifique el nombre que se mostrará para la imagen personalizada en el repositorio de imágenes personalizadas en Oracle Cloud Infrastructure. Si no se especifica este parámetro, se utilizará el nombre de la imagen como nombre mostrado.
-l launch_mode | --launch-mode launch_mode
- Especifique el modo de inicio que utiliza la imagen personalizada al iniciar. Los valores posibles son
PARAVIRTUALIZED
,EMULATED
yNATIVE
. Si no se especifica un modo, el valor por defecto esPARAVIRTUALIZED
.
-v | --verbose
- Muestre información detallada durante el procesamiento de la importación de la imagen en el terminal. Utilice esta información para solucionar errores o supervisar el progreso. Esta información de depuración también se escribe en
/var/tmp
.
-y | --yes
- Responda "yes" a las peticiones de datos.
-h | --help
- Muestre un resumen de las opciones de la línea de comandos.
Ejemplo
$ oci-image-migrate-import -v -y -i ol79_demo.qcow2 -b test_bucket_001 -c OLimages -d ol79_demo
Importing ol79_demo.qcow2 from test_bucket_001 into test_bucket_001 as ol79_demo and setting launch mode as PARAVIRTUALIZED
Object storage namespace: IMAGETEST
Compartment: OLimages
Object storage test_bucket_001 present.
Import ol79_demo.qcow2 to OLimages as ol79_demo y
00:00:05 [ importing ol79_demo
Información adicional sobre la migración
- Para descubrir cómo crear y configurar nuevas instancias con su imagen personalizada, consulte Tareas posteriores a la importación para imágenes de Linux.
- Para migrar sus servidores locales a instancias con hardware dedicado, consulte Traiga su propia imagen (BYOI).
- Para migrar las máquinas virtuales de Oracle VM VirtualBox, consulte la sección sobre exportación de un dispositivo a Oracle Cloud Infrastructure.