jetbrains/ide-services-migrations

JetBrains IDE Services 数据库迁移辅助镜像

镜像概述

该镜像为JetBrains官方提供的IDE服务辅助工具，专门用于数据库迁移场景。作为JetBrains IDE Services生态的一部分，它提供标准化的数据库迁移执行环境，支持与各类JetBrains开发工具及服务集成，简化开发和部署流程中的数据库版本管理。

核心功能与特性

• 官方支持：JetBrains官方维护，确保与IDE Services生态的兼容性和稳定性
• 迁移专注：专注于数据库迁移任务，支持主流数据库迁移工具和脚本执行
• 环境隔离：提供独立的迁移执行环境，避免与主应用环境冲突
• 配置灵活：通过环境变量和挂载点支持自定义迁移参数及脚本路径
• 轻量设计：优化镜像体积，适合在开发环境和CI/CD流程中快速部署

使用场景

• 开发环境中自动执行数据库迁移脚本，保持本地数据库结构与项目版本一致
• CI/CD流水线中集成数据库迁移步骤，实现代码与数据库 schema 变更的同步部署
• 多环境（开发/测试/预发布）数据库版本统一管理，确保迁移流程一致性
• 与JetBrains IDE（如IntelliJ IDEA、DataGrip）联动，可视化管理迁移过程

使用方法与配置说明

基本使用命令

bash
docker run -d \
  --name jetbrains-db-migration \
  -v /local/migration-scripts:/migrations \
  -e DB_TYPE=postgresql \
  -e DB_URL=jdbc:postgresql://db-host:5432/mydb \
  -e DB_USER=admin \
  -e DB_PASSWORD=secret \
  jetbrains/ide-services-db-migration:latest

环境变量配置

数据卷挂载

• 迁移脚本目录：建议将本地迁移脚本目录挂载至容器内的/migrations（或通过MIGRATION_DIR指定的路径），镜像会自动扫描该目录下的脚本文件并按命名顺序执行

  bash
  -v /path/to/local/migrations:/migrations
  

迁移执行流程

1. 容器启动后，读取环境变量配置并验证数据库连接
2. 扫描迁移脚本目录，按文件名顺序（建议使用版本前缀命名，如V1__init_schema.sql、V2__add_users_table.sql）识别待执行脚本
3. 通过迁移记录跟踪表检查已执行脚本，避免重复执行
4. 按顺序执行未执行的迁移脚本，并更新跟踪表状态
5. 执行完成后输出结果日志，容器自动退出（非后台运行模式）

注意事项

• 迁移脚本应遵循数据库迁移最佳实践，确保可重复执行性（如使用CREATE TABLE IF NOT EXISTS语法）
• 敏感信息（如数据库密码）建议通过环境变量注入，避免硬编码在脚本或容器镜像中
• 生产环境使用时，建议配合数据备份机制，避免迁移失败导致数据丢失
• 镜像标签应指定具体版本（如2024.1）而非latest，确保环境一致性