beneha/flyway-azure

flyway-azure

镜像概述和主要用途

flyway-azure是专为Azure Pipeline设计的Docker镜像，基于Flyway CLI工具，用于在Azure DevOps流水线中执行数据库迁移任务。该镜像满足Azure Pipeline对容器环境的特定要求，可无缝集成到流水线作业中，实现数据库变更的自动化管理。

核心功能和特性

• 支持完整的Flyway CLI命令集，可执行数据库版本迁移、校验、信息查看等操作
• 满足Azure Pipeline对Linux容器的环境要求：包含Bash、基于glibc、可运行Node.js（由代理提供）、未定义ENTRYPOINT、USER可无sudo执行groupadd等权限命令
• 兼容Azure Pipeline代理环境，可直接作为容器作业运行
• 提供非glibc环境（如Alpine）的适配方案

使用场景和适用范围

适用于需要在Azure DevOps Pipeline中实现数据库版本控制和自动化迁移的场景，特别适合CI/CD流程中数据库变更的集成，确保数据库结构变更与应用代码部署保持同步和一致性。

使用方法和配置说明

快速开始

通过以下命令可快速测试镜像功能：

bash
docker run --rm flyway [flyway cli参数]

将[flyway cli参数]替换为实际的Flyway命令参数，如migrate、info、validate等。

Azure Pipeline配置要求

Linux-based容器要求

Azure Pipeline对Linux容器有以下特定要求：

• 必须包含Bash
• 基于glibc库
• 能够运行Node.js（由Azure Pipeline代理提供）
• 不得定义ENTRYPOINT
• 运行用户(USER)需具备无需sudo即可执行groupadd等权限命令的能力

代理主机要求

运行Azure Pipeline代理的主机需满足：

• 已安装Docker
• 代理服务账户具有访问Docker守护进程的权限

非glibc容器的额外配置

对于非glibc基础的容器（如Alpine），需额外执行以下配置：

1. 添加Node.js LTS版本二进制文件到容器
2. 设置容器标签com.azure.dev.pipelines.handler.node.path指向Node.js二进制文件路径
3. 安装必要依赖：

bash
RUN apk add bash sudo shadow

更多信息请参考Microsoft官方文档：定义容器作业（YAML）。

Azure Pipeline示例

以下是在Azure Pipeline中使用该镜像的YAML配置示例：

yaml
stages:
- stage: DeployDatabase
  jobs:
  - job: FlywayDocker
    timeoutInMinutes: 10
    pool:
      vmImage: 'ubuntu-16.04'
    container:
      image: beneha/flyway-azure:7.14.1
    steps:
    - script: whoami
    - script: pwd
    - script: ls -la
    - script: flyway -v

该示例定义了一个名为DeployDatabase的阶段，其中包含一个使用beneha/flyway-azure:7.14.1镜像的作业，执行基本系统信息查看和Flyway版本检查。