flyway/flyway-azure

[已弃用] 官方Flyway Docker镜像

https://img.shields.io/docker/cloud/automated/flyway/flyway]https://hub.docker.com/r/flyway/flyway/

[已弃用] 对于Flyway 9及更新版本，请使用https://hub.docker.com/r/flyway/flyway%E4%B8%AD%E7%9A%84azure%E6%A0%87%E7%AD%BE

这是https://flywaydb.org/documentation/usage/commandline/%E9%95%9C%E5%83%8F%E7%9A%84%E5%AE%98%E6%96%B9%E4%BB%93%E5%BA%93%E3%80%82

应使用哪个镜像？

有两个镜像家族：

• flyway/flyway - 此镜像为基础Flyway命令行应用，应作为默认选择。
• flyway/flyway-azure - 此镜像适用于Azure Pipelines代理作业。

支持的标签

有关官方支持的标签，请阅读仓库https://github.com/flyway/flyway-docker#supported-tags%E3%80%82

flyway-azure镜像仅支持alpine版本。

支持的卷

为方便按需求运行Flyway，支持以下卷：

Flyway版本

可通过设置FLYWAY_EDITION环境变量切换不同Flyway版本，取值如下：

快速开始

最简单的入门方式是运行默认镜像测试：

bash
docker run --rm docker.xuanyuan.run/flyway/flyway

这将显示Flyway命令行的使用说明。

要执行实际操作，需向镜像传递所需参数。例如：

bash
docker run --rm docker.xuanyuan.run/flyway/flyway -url=jdbc:h2:mem:test -user=sa info

注意，flyway/flyway-azure的语法略有不同，为兼容Azure Pipelines代理作业要求，它未定义入口点，需显式添加flyway命令。例如：

bash
docker run --rm docker.xuanyuan.run/flyway/flyway-azure:latest-alpine flyway

添加SQL文件

要添加自定义SQL文件，将其放在目录中并挂载为flyway/sql卷。

示例

创建新目录并添加名为V1__Initial.sql的文件，内容如下：

sql
CREATE TABLE MyTable (
    MyColumn VARCHAR(100) NOT NULL
);

运行挂载卷的镜像：

bash
docker run --rm -v /绝对路径/到/sql目录:/flyway/sql docker.xuanyuan.run/flyway/flyway -url=jdbc:h2:mem:test -user=sa migrate

添加配置文件

若倾向于将参数存储在配置文件中，可使用flyway/conf卷。

示例

创建名为flyway.conf的文件，内容如下：

properties
flyway.url=jdbc:h2:mem:test
flyway.user=sa

运行挂载该卷的镜像：

bash
docker run --rm -v /绝对路径/到/sql目录:/flyway/sql -v /绝对路径/到/conf目录:/flyway/conf docker.xuanyuan.run/flyway/flyway migrate

添加JDBC驱动

Flyway默认包含以下数据库的驱动：

• Aurora MySQL
• Aurora PostgreSQL
• CockroachDB
• Derby
• Firebird
• H2
• HSQLDB
• MariaDB
• MySQL
• Percona XtraDB Cluster
• PostgreSQL
• SQL Server
• SQLite
• Sybase ASE

若数据库不在此列表中，或需使用不同/更新的驱动，可通过flyway/drivers卷添加。

示例

创建目录并放入例如Oracle JDBC驱动（ojdbc8.jar）。

挂载该卷让Flyway使用：

bash
docker run --rm -v /绝对路径/到/sql目录:/flyway/sql -v /绝对路径/到/conf目录:/flyway/conf -v /绝对路径/到/driver目录:/flyway/drivers docker.xuanyuan.run/flyway/flyway migrate

添加基于Java的迁移和回调

要传入基于Java的迁移和回调，可使用flyway/jars卷。

示例

创建目录并放入包含Java迁移的JAR文件。

挂载该卷让Flyway使用：

bash
docker run --rm -v /绝对路径/到/sql目录:/flyway/sql -v /绝对路径/到/conf目录:/flyway/conf -v /绝对路径/到/jar目录:/flyway/jars docker.xuanyuan.run/flyway/flyway migrate

Docker Compose

要在容器中同时运行Flyway和待迁移数据库，可使用docker-compose.yml文件启动并链接两个容器。

示例

yaml
version: '3'
services:
  flyway:
    image: docker.xuanyuan.run/flyway/flyway
    command: -url=jdbc:mysql://db -schemas=myschema -user=root -password=P@ssw0rd -connectRetries=60 migrate
    volumes:
      - .:/flyway/sql
    depends_on:
      - db
  db:
    image: docker.xuanyuan.run/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=P@ssw0rd
    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    ports:
      - 3306:3306

运行docker-compose up，将启动Flyway和MySQL。Flyway将自动等待最多一分钟，待MySQL初始化完成后开始数据库迁移。