vcesf/jenkins-flyway

镜像概述

本镜像基于Alpine Linux构建，是一个轻量级Docker镜像，预安装Java 8运行时环境（JRE）和Flyway数据库版本管理工具。旨在为开发、测试及生产环境提供简洁高效的数据库迁移解决方案，通过标准化的版本控制机制管理数据库结构变更。

核心功能与特性

轻量级基础

• 基于Alpine Linux构建，镜像体积小（通常<200MB），资源占用低，启动速度快
• 精简的系统依赖，降低安全风险面

Java 8环境

• 内置OpenJDK 8运行时环境（JRE），满足Flyway运行依赖
• 预配置JAVA_HOME环境变量，支持Java应用运行

Flyway集成

• 预安装最新稳定版Flyway Community Edition
• 支持主流关系型数据库（MySQL、PostgreSQL、Oracle、SQL Server等）
• 内置Flyway命令行工具，可直接执行迁移（migrate）、清理（clean）、信息（info）等操作

使用场景

• 开发环境数据库迁移：本地开发时快速应用数据库脚本，保持开发环境与代码同步
• CI/CD流水线集成：在持续集成/部署流程中自动执行数据库变更，确保应用发布与数据库版本匹配
• 多环境数据库同步：统一管理开发、测试、生产环境的数据库结构，减少环境差异导致的问题
• 版本回溯与审计：通过Flyway元数据表记录所有迁移历史，支持版本回溯与变更审计

使用方法与配置说明

基本使用（docker run）

通过挂载迁移脚本目录并指定数据库连接参数执行迁移：

bash
docker run -v /本地迁移脚本目录:/flyway/sql \
  -e FLYWAY_URL=jdbc:mysql://数据库主机:端口/数据库名 \
  -e FLYWAY_USER=数据库用户名 \
  -e FLYWAY_PASSWORD=数据库密码 \
  [镜像名称]:[标签] migrate

示例（MySQL）：

bash
docker run -v ./migrations:/flyway/sql \
  -e FLYWAY_URL=jdbc:mysql://mysql-host:3306/mydb?useSSL=false \
  -e FLYWAY_USER=root \
  -e FLYWAY_PASSWORD=root123 \
  docker.xuanyuan.run/alpine-java8-flyway:latest migrate

核心配置参数（环境变量）

迁移脚本规范

迁移脚本需放置在挂载至/flyway/sql的目录中，命名需遵循Flyway规范：

• 版本化迁移：V<版本号>__<描述>.sql（例：V1__Create_users_table.sql）
• 可重复迁移：R__<描述>.sql（例：R__Insert_test_data.sql）

Docker Compose配置示例

yaml
version: '3.8'
services:
  db-migrate:
    image: docker.xuanyuan.run/alpine-java8-flyway:latest
    volumes:
      - ./migrations:/flyway/sql  # 挂载本地迁移脚本目录
    environment:
      - FLYWAY_URL=jdbc:postgresql://db:5432/mydb
      - FLYWAY_USER=postgres
      - FLYWAY_PASSWORD=postgres123
      - FLYWAY_LOCATIONS=files:/flyway/sql  # 指定脚本位置
    depends_on:
      - db  # 确保数据库服务先启动

  db:
    image: docker.xuanyuan.run/postgres:14
    environment:
      - POSTGRES_DB=mydb
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres123
    ports:
      - "5432:5432"

常用Flyway命令

示例（查看迁移状态）：

bash
docker run -e FLYWAY_URL=jdbc:mysql://mysql-host:3306/mydb \
  -e FLYWAY_USER=root \
  -e FLYWAY_PASSWORD=root123 \
  alpine-java8-flyway:latest info