yeagerai/simulator-database-migration

GenLayer Simulator 数据库迁移镜像

概述

该镜像为GenLayer Simulator提供专用的数据库迁移功能，旨在简化数据库模式变更和数据迁移流程，确保数据库结构与GenLayer Simulator应用版本保持同步，支持开发、测试和生产环境的数据库管理。

核心功能

• 版本化迁移管理：支持迁移脚本的版本控制，追踪数据库变更历史，便于回滚和审计
• 自动化迁移执行：提供命令行工具实现迁移操作自动化，减少手动干预
• GenLayer兼容性：专为GenLayer Simulator设计，确保与应用数据模型完全兼容
• 事务支持：迁移过程中的事务管理，保障数据一致性和迁移安全性

使用场景

• GenLayer Simulator开发环境部署时的数据库初始化
• 应用版本升级过程中的数据库结构变更
• 测试环境与生产环境之间的数据库同步
• 多环境（开发、测试、生产）的数据库一致性维护

使用方法

基本运行方式

通过docker run命令执行迁移操作，需指定数据库连接信息和迁移命令：

bash
docker run --rm \
  -e DB_HOST=数据库主机地址 \
  -e DB_PORT=数据库端口 \
  -e DB_NAME=数据库名称 \
  -e DB_USER=数据库用户名 \
  -e DB_PASSWORD=数据库密码 \
  genlayer/migration:latest migrate up

环境变量配置

常用迁移命令

• migrate up：执行所有未应用的迁移脚本
• migrate down：回滚最近一次应用的迁移
• migrate version：查看当前数据库迁移版本
• migrate status：检查迁移脚本与数据库的同步状态

Docker Compose 示例

yaml
version: '3'
services:
  migration:
    image: genlayer/migration:latest
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=genlayer_db
      - DB_USER=genlayer_user
      - DB_PASSWORD=secure_password
    depends_on:
      - postgres
  postgres:
    image: postgres:14
    environment:
      - POSTGRES_DB=genlayer_db
      - POSTGRES_USER=genlayer_user
      - POSTGRES_PASSWORD=secure_password