lynqtech/docker-sql-migrate Docker 镜像 - 轩辕镜像

sql-migrate 镜像文档

镜像概述

sql-migrate是一款基于Alpine Linux和Go语言构建的轻量级SQL迁移工具，旨在简化数据库模式的管理与迁移流程。通过版本化的迁移文件，可实现数据库结构的可控更新，支持开发、测试及生产环境的一致性部署，具备体积小、跨平台兼容的特点。

核心功能与特性

• 轻量级架构：基于Alpine Linux构建，镜像体积小巧，资源占用低
• 版本化迁移：支持数据库迁移脚本的版本控制，追踪迁移历史
• 跨平台兼容：基于Go语言开发，可在多种操作系统和架构下运行
• 安全增强：自v2版本起，容器默认使用"service"用户运行，降低权限风险
• 依赖透明：明确标注各版本依赖的Alpine Linux和Go语言版本，便于环境一致性管理

适用场景

• 开发环境：本地数据库模式迭代与测试，快速验证迁移脚本
• CI/CD流程：集成到持续集成/部署 pipeline，实现数据库变更的自动化执行
• 生产环境：安全、可控地执行数据库结构更新，避免手动操作风险
• 多环境同步：确保开发、测试、预发及生产环境的数据库结构一致

使用方法

基本使用（docker run）

通过挂载本地迁移文件目录，执行迁移命令：

bash
# 执行迁移（向上迁移）
docker run -v /path/to/local/migrations:/migrations sql-migrate up

# 回滚迁移（向下迁移）
docker run -v /path/to/local/migrations:/migrations sql-migrate down

版本历史

• 2.1.1
  • ALPINE_VERSION=3.20
  • GO_VERSION=1.23.3
• 2.1.0
  • ALPINE_VERSION=3.20
  • GO_VERSION=1.23.2
• 2.0.7
  • ALPINE_VERSION=3.19
  • GO_VERSION=1.23.1
• 2.0.6
  • ALPINE_VERSION=3.19
  • GO_VERSION=1.22.6
• 2.0.4
  • ALPINE_VERSION=3.19
  • GO_VERSION=1.22.4
• 2.0.3
  • ALPINE_VERSION=3.19
  • GO_VERSION=1.22.3
• 2.0.2
  • ALPINE_VERSION=3.19
  • GO_VERSION=1.22.2
• 2
  • 自v2起，默认用户变更为"service"
• 1.2.0
  • ALPINE_VERSION=3.19
  • GO_VERSION=1.22.1
• 1.11
  • ALPINE_VERSION=3.18
  • GO_VERSION=1.21.1