Puedes instalar y ejecutar Relational Migrator como un contenedor de Docker. Ejecutar Relational Migrator con Docker asegura que el proceso de instalación sea independiente del sistema operativo y fácil de replicar.
Nota
Este método de implementación está destinado a ser una forma sencilla de evaluar Relational Migrator y no se recomienda para cargas de trabajo de producción.
Para obtener información sobre el despliegue de Relational Migrator en un entorno de producción, consulta el Guía de instalación de producción.
Acerca de esta tarea
También puedes utilizar Docker Compose para ejecutar el Relational Migrator. Puede encontrar un ejemplo de archivo de Docker Compose en el Centro de Descargas. Si utiliza Docker Compose, debe configurar variables de entorno para MIGRATOR_PATH_DATA a la ruta local para el montaje del volumen de datos y MIGRATOR_PATH_DRIVER a la ruta del archivo JAR con los controladores JDBC.
Antes de comenzar
Instale Docker
Procedimiento
Ejecute la imagen como un contenedor
Las pestañas de abajo muestran varios comandos de docker que resultan útiles para ejecutar Relational Migrator:
El -p 8080:8080 en este comando asigna el puerto del contenedor al puerto del host. Esto te permite conectarte a Relational Migrator navegando a http://localhost:8080:
docker run --name mongodb-relational-migrator -p 8080:8080 public.ecr.aws/v4d7k6c9/relational-migrator:latest
El siguiente comando hace que los archivos y registros del proyecto sean persistentes incluso si se detiene el contenedor:
docker run --name mongodb-relational-migrator -p 8080:8080 -v c:\temp\migdocker\data:/root/Migrator public.ecr.aws/v4d7k6c9/relational-migrator:latest
El siguiente comando asigna un único archivo jar que contiene un controlador JDBC al contenedor. Esto resulta útil para proyectos de migración de Oracle y MySQL, ya que dichos controladores no están incluidos en Relational Migrator por defecto:
docker run --name mongodb-relational-migrator -p 8080:8080 -v C:\Temp\migdocker\drivers\ojdbc11.jar:/opt/mongodb-relational-migrator/lib/app/lib/driver.jar public.ecr.aws/v4d7k6c9/relational-migrator:latest
Nota
Anular una configuración
Puedes especificar una configuración para anular en el comando Docker. Por ejemplo, considere deshabilitar la telemetría con el siguiente comando:
docker run --name mongodb-relational-migrator -p 8080:8080 -e MIGRATOR_APP_TELEMETRY_ENABLE=false public.ecr.aws/v4d7k6c9/relational-migrator:latest
Verifique que el contenedor esté en ejecución
Para comprobar el estado de su contenedor Docker, ejecute el siguiente comando:
docker container ls
El resultado del comando ls enumera los siguientes campos que describen el contenedor en ejecución:
Container IDImageCommandCreatedStatusPortNames
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 82b1f8adca43 public.ecr.aws/v4d7k6c9/relational-migrator:latest "/opt/mongodb-relati…" 46 seconds ago Up 44 seconds 0.0.0.0:8080->8080/tcp pedantic_kirch
Abre la aplicación
Para ver la aplicación, navegue a: http://localhost:8080.
Nota
Si cambió el número de puerto en el comando docker run, también debe cambiar el puerto en la URL de arriba.