Instale com Docker
Você pode instalar e executar o Relational Migrator como um contêiner Docker. A execução do Relational Migrator com o Docker garante um processo de instalação independente do sistema operacional e simples de replicar.
Sobre esta tarefa
Você também pode usar o Docker Compose para executar o Relational Migrator. Você pode encontrar um arquivo de exemplo do Docker Compose no centro de download. Se você usar o Docker Compose, deverá definir variáveis de ambiente para MIGRATOR_PATH_DATA
como o caminho local para a montagem do volume de dados e MIGRATOR_PATH_DRIVER
para o caminho do arquivo JAR com os drivers JDBC.
Antes de começar
Instale o Docker
Procedimento
Execute a imagem como um contêiner
As guias abaixo mostram vários comandos do Docker que são úteis para executar o Relational Migrator:
O -p 8080:8080
neste comando mapeia a porta do contêiner para a porta do host. Isso permite que você se conecte ao Relational Migrator navegando até http://localhost:8080:
docker run --name mongodb-relational-migrator -p 8080:8080 public.ecr.aws/v4d7k6c9/relational-migrator:latest
O comando a seguir torna os arquivos e registros do projeto persistentes mesmo se o container for interrompido:
docker run --name mongodb-relational-migrator -p 8080:8080 -v c:\temp\migdocker\data:/root/Migrator public.ecr.aws/v4d7k6c9/relational-migrator:latest
O comando a seguir mapeia um único arquivo JAR que contém um driver JDBC para o contêiner. Isso é útil para projetos de migração Oracle e MySQL porque esses drivers não estão incluídos com o Relational Migrator por padrão:
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
Observação
Substituir uma configuração
Você pode especificar uma definição de configuração a ser substituída no comando Docker. Por exemplo, considere desativar a telemetria com o seguinte comando:
docker run --name mongodb-relational-migrator -p 8080:8080 -e MIGRATOR_APP_TELEMETRY_ENABLE=false public.ecr.aws/v4d7k6c9/relational-migrator:latest
Verifique se o contêiner está em execução
Para verificar o status do contêiner do Docker, execute o seguinte comando:
docker container ls
A saída do comando ls
lista os seguintes campos que descrevem o contêiner em execução:
Container ID
Image
Command
Created
Status
Port
Names
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 o aplicativo
Para visualizar o aplicativo, navegue até: http://localhost:8080.
Observação
Se você alterou o número da porta no comando docker run
, também precisará alterar a porta no URL acima.