使用Rails迁移于非Rails项目：standalone_migrations实战指南

使用Rails迁移于非Rails项目：standalone_migrations实战指南

standalone-migrationsA gem to use Rails Database Migrations in non Rails projects项目地址:https://gitcode.com/gh_mirrors/st/standalone-migrations

项目介绍

standalone_migrations 是一个精巧的Ruby宝石，它使您能够在非Rails应用程序中利用Rails的强大数据库迁移功能。这对于那些希望在纯Ruby应用、或者其他框架中执行结构化数据库变更的开发者来说，是个巨大的福音。自6.x版本支持Rails 6迁移以来，最新的7.x系列已升级以兼容Rails 7，从而保持与最新技术栈的一致性。

该宝石依赖于ActiveRecord（版本6.0.0以上但低于7.2）、Nokogiri等，确保了与大多数现代Ruby环境的良好集成。

项目快速启动

安装

首先，确保您的系统已经安装了Ruby和RubyGems。接下来，可以通过以下命令安装standalone_migrations：

gem install standalone_migrations

或者，在您的项目中使用Gemfile进行管理：

source 'https://rubygems.org'
gem 'standalone_migrations'
gem 'pg' # 或者使用'mysql2'作为数据库驱动，根据实际数据库类型选择

之后，执行bundle install来安装所需的依赖。

配置与基础使用

在您的项目根目录创建一个名为.standalone_migrations.rb的配置文件，定义基本的数据库连接信息（默认值可用于简单场景）：

# .standalone_migrations.rb示例
db:
  seeds: db/seeds.rb
  migrate: db/migrate
  schema: db/schema.rb
config: 
  database: db/config.yml

并设置数据库配置文件db/config.yml，类似于Rails的标准配置。

最后，在Rakefile中加入以下代码以加载standalone_migrations的任务：

require 'standalone_migrations'
StandaloneMigrations::Tasks.load_tasks

现在，您可以使用熟悉的Rails迁移命令来创建、运行或回滚迁移了：

rake db:new_migration name=创建表用户
编辑生成的迁移文件（如db/migrate/时间戳_创建表用户.rb），然后执行迁移：
rake db:migrate

应用案例与最佳实践

standalone_migrations非常适合需要数据库版本控制但又不想引入整个Rails框架的项目。例如，在构建微服务架构时，各服务可能需要独立的数据库迁移方案，此时standalone_migrations可以提供便利。最佳实践中，确保每项数据库更改都通过迁移脚本记录下来，以便于团队协作和未来的审计追踪。

典型生态项目集成

standalone_migrations的灵活性允许其轻松融入多样化的开发环境。除了标准的数据库操作，您还可以通过在Rakefile中的on_loaded回调添加外部库的支持，比如Foreigner用于处理外键关系：

require 'foreigner'
StandaloneMigrations.on_loaded do
  Foreigner.load
end

这使得在处理复杂的数据库关联时，能够享受到与Rails环境中相似的便利。

总之，standalone_migrations 是一个强大且灵活的工具，对于需要数据库迁移功能的任何Ruby应用来说，都是不可或缺的选择，无需捆绑Rails的全部重量，即可实现高效的数据结构管理。

standalone-migrationsA gem to use Rails Database Migrations in non Rails projects项目地址:https://gitcode.com/gh_mirrors/st/standalone-migrations