7factor/flyway

自定义Flyway容器镜像

镜像概述

本镜像基于Flyway构建，是一个自定义容器，内置了若干额外实用工具，旨在提供更全面的数据库版本控制与迁移能力。它继承了Flyway的核心功能，同时通过集成额外工具增强了在复杂场景下的实用性。

核心功能与特性

• 继承Flyway核心能力：支持数据库版本控制、迁移脚本执行、版本校验等标准功能
• 内置额外实用工具：集成辅助数据库操作的工具（如数据库连接测试、脚本格式校验等）
• 灵活配置：支持通过环境变量、配置文件等多种方式自定义迁移行为
• 轻量级设计：在保留功能的同时保持镜像体积优化

使用场景与适用范围

• 企业级数据库迁移项目
• 需要额外工具辅助迁移流程的场景
• 多环境（开发、测试、生产）数据库版本统一管理
• CI/CD流程中的数据库自动化迁移环节

使用方法与配置说明

基本使用（docker run）

bash
docker run -v /path/to/migrations:/flyway/sql \
  -e FLYWAY_URL=jdbc:postgresql://db-host:5432/mydb \
  -e FLYWAY_USER=myuser \
  -e FLYWAY_PASSWORD=mypassword \
  custom-flyway-container migrate

docker-compose配置示例

yaml
version: '3'
services:
  flyway:
    image: custom-flyway-container
    volumes:
      - ./migrations:/flyway/sql
      - ./conf:/flyway/conf
    environment:
      - FLYWAY_URL=jdbc:mysql://mysql:3306/mydb
      - FLYWAY_USER=root
      - FLYWAY_PASSWORD=secret
      - FLYWAY_VALIDATE_ON_MIGRATE=true
    depends_on:
      - mysql
  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=mydb

主要配置参数

额外工具使用

内置工具可通过容器内命令直接调用，例如：

bash
# 连接数据库测试
docker exec -it [container-id] db-connect-test

# 迁移脚本格式校验
docker exec -it [container-id] script-validate /flyway/sql/V1__initial_schema.sql

注意事项

• 迁移脚本需遵循Flyway命名规范（如V1__Description.sql）
• 首次使用时建议先执行validate命令验证配置与脚本
• 生产环境建议配合卷挂载持久化版本历史数据