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.

Nota

Las utilidades oci-image-migrate no constituyen parte de las utilidades deOCI preinstaladas, pero están disponibles en el repositorio addons. Debe instalar manualmente las utilidades oci-image-migrate en la imagen local.

Compatibilidad

Puede usar 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 del proceso de migración funcionan con el formato por defecto de imagen del disco (VMDK) de Oracle VM VirtualBox o el formato por defecto de imagen del 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 SO de las máquinas virtuales 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 de oci-image-migrate, convierta la instalación física en una imagen del disco virtual y migre la imagen del 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 10

Active el repositorio de yum ol10_addons para Oracle Linux 10:
```
sudo dnf config-manager --enable ol10_addons
```
Actualice los sistemas con el comando dnf update y, a continuación, instale los paquetes necesarios:
```
sudo dnf update -y
sudo dnf install -y python3-oci-sdk python3-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 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 y ol7_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 apagar el dispositivo físico para crear la imagen, incluya temporalmente todos los controladores de dispositivo 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 los archivos de imagen del disco en la documentación de Oracle VM VirtualBox. Para obtener más información sobre el comando qemu-img, consulte el comando man qemu-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 huéspedes 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 del disco virtual a una instancia de Oracle Cloud Infrastructure (OCI).

Requisitos

Antes de realizar la migración, asegúrese de que ya:

Ha configurado Identity and Access Management.
Se ha creado un cubo para Object Storage en el arrendamiento de OCI.
Configurado el SDK de OCI con las credenciales para el acceso a la 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 es nuevo en OCI, consulte la sección Introducción en la documentación de OCI.

Uso de las utilidades para migrar la imagen

Complete los requisitos.
Verifique y realice un procesamiento previo en el disco duro virtual en formato VMDK o QCOW2:
```
sudo oci-image-migrate -y -i unprocessed_virtual_hard_disk
```
Cargue el disco duro virtual preprocesado en un cubo de OCI Object Storage como imagen personalizada:
```
oci-image-migrate-upload -y -i processed_virtual_hard_disk -b bucket_name -o image_name
```
Importe el archivo de imagen del cubo de Object Storage al repositorio de imágenes personalizado:
```
oci-image-migrate-import -y -i image_name -b bucket_name -c compartment_name
```
Si ha migrado desde un host físico, vuelva a generar initramfs en cada nueva instancia mediante el uso de la imagen personalizada importada:
```
sudo dracut --force
```

Referencia de utilidades de migración

Obtenga información sobre cada utilidad, incluida una descripción, las opciones y las ejemplos de uso.

Prepara una imagen de entorno local para la importación en Oracle Cloud Infrastructure. Debe ejecutar este comando como usuario root.

La utilidad oci-image-migrate puede migrar 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 en los que se 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 la ejecución del procesamiento de 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
...

Carga un archivo de imagen de entorno local en un cubo de Object Storage en Oracle Cloud Infrastructure. Este comando No requiere privilegios del usuario root, siempre que pueda acceder al cubo de Object Storage en Oracle Cloud Infrastructure y tenga privilegios para escribir en los directorios donde se escriben el archivo log y los archivos de resultados (/var/tmp/).

Sintaxis

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 Object Storage 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 que se va a utilizar en Object Storage. 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 la carga de 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

Importa una imagen desde el almacenamiento de objetos a un depósito de imágenes personalizado en Oracle Cloud Infrastructure. Este comando No requiere privilegios del usuario root, siempre que pueda acceder al cubo de Object Storage en Oracle Cloud Infrastructure y tenga privilegios para escribir en los directorios donde se escriben el archivo log y los archivos de resultados (/var/tmp/).

Sintaxis

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 Object Storage en Oracle Cloud Infrastructure donde se almacena el archivo del almacenamiento de imágenes. 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 especifica este parámetro, se utilizará el nombre de la imagen como nombre mostrado.

-l launch_mode | --launch-mode launch_mode

Especifique el modo del inicio que utiliza la imagen personalizada cuando se inicia. Los valores posibles son PARAVIRTUALIZED, EMULATED y NATIVE. Si el modo no se especifica, el valor por defecto es PARAVIRTUALIZED.

-v | --verbose

Muestre información detallada durante la importación de imágenes 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 una imagen personalizada, consulte Tareas tras la importación para imágenes de Linux.
Para migrar servidores on-premises a instancias con hardware dedicado, consulte Traiga su propia imagen (BYOI).
Para migrar la máquina virtual de Oracle VM VirtualBox, consulte la sección sobreexportación de un dispositivo a Oracle Cloud Infrastructure.

Documentación de Oracle Cloud Infrastructure

Utilidades de migración de imágenes de OCI

Migración de una imagen con oci-image-migrate

Instalación de las utilidades de migración

Oracle Linux 10

Oracle Linux 9

Oracle Linux 8

Oracle Linux 7 (soporte extendido)

Conversión de una instalación física en una imagen de disco virtual

Creación de la imagen de disco sin formato

Opción 1: Convertir a formato de disco de máquina virtual (VMDK)

Opción 2: Convertir a formato QEMU Copy-on-Write (QCOW2)

Migración de una imagen de disco virtual a Oracle Cloud Infrastructure

Requisitos

Uso de las utilidades para migrar la imagen

Referencia de utilidades de migración

Información adicional sobre la migración