Puede instalar y ejecutar Relational Migrator como un contenedor Docker. Ejecutar Relational Migrator con Docker garantiza un proceso de instalación independiente del sistema operativo y fácil de replicar.
Nota
Este método de implementación está pensado como una forma sencilla de evaluar Relational Migrator y no se recomienda para cargas de trabajo de producción.
Para obtener información sobre la implementación de Relational Migrator en producción, consulte la Guía de instalación de producción.
Acerca de esta tarea
También puedes utilizar Docker ComposePara ejecutar Relational Migrator. Puede encontrar un archivo de ejemplo de Docker Compose en el centro de descargas. Si usa 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 a continuación muestran varios comandos de Docker que son útiles para ejecutar Relational Migrator:
El -p 8080:8080 de este comando asigna el puerto del contenedor al puerto del host. Esto le permite conectarse 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
Puede especificar una opción de configuración para anularla en el comando de 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
Abra 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 deberá cambiar el puerto en la URL anterior.