ActsAsTenant：Rails共享数据库多租户解决方案

ActsAsTenant：Rails共享数据库多租户解决方案

acts_as_tenantEasy multi-tenancy for Rails in a shared database setup.项目地址:https://gitcode.com/gh_mirrors/ac/acts_as_tenant

1. 项目介绍

ActsAsTenant 是一个为 Ruby on Rails 应用程序设计的多租户扩展库，它支持在共享数据库架构下实现轻松的多租户功能。通过该插件，你可以将模型范围限定于特定的“租户”，通常由如 Account 这样的模型代表。它自动在每个请求中设置当前租户，并确保所有“租户模型”始终正确地限定于当前上下文。ActsAsTenant 提供了防止绕过租户隔离的保护机制，增加了跨租户唯一性验证的方法，并提供辅助方法以访问当前租户。

2. 项目快速启动

要快速启动一个包含 ActsAsTenant 的 Rails 项目，你需要首先添加它到你的 Gemfile 中：

gem 'acts_as_tenant'

然后运行 bundle install 来安装 gem。接下来，在你的租户模型（例如 Account）上激活 ActsAsTenant：

class Account < ApplicationRecord
  acts_as_tenant
end

在配置文件中，如果你打算使用 ActiveJob 或 Sidekiq 进行后台处理，别忘了添加相关支持。对于 Sidekiq，需在 config/initializers/acts_as_tenant.rb 文件中加入：

require 'acts_as_tenant/sidekiq'

最后，确保你的应用能够根据子域名或其他方式识别并设置当前租户。这可能涉及到中间件或者控制器中的逻辑。

3. 应用案例和最佳实践

应用案例

假设有一个 Saas 平台，每个客户都有自己的数据隔离空间。通过在用户的每次请求时自动设置当前租户， ActsAsTenant 确保查询仅返回属于当前登录客户的记录，从而实现了数据的逻辑隔离。

最佳实践

• 环境配置：在测试环境中清理 current_tenant 避免状态污染。
• 后台作业：确保在调度任何背景作业时，租户上下文被正确传递。
• 集成测试：利用 test_tenant 特性来管理测试中的租户切换，并结合合适的中间件避免租户状态跨请求保留。

4. 典型生态项目

尽管具体的生态项目提及不多，但 ActsAsTenant 已经足够灵活，可以与多种后台处理框架（如 ActiveJob, Sidekiq, Delayed::Job）无缝协作。社区中可能会有更多围绕 Rails 多租户的工具和服务，虽未直接列出典型的生态项目，但 ActsAsTenant 的设计使其容易与其他 Ruby on Rails 生态中的监测、部署、自动化工具搭配使用。

---

以上就是使用 ActsAsTenant 插件的基本指南，希望对你集成多租户功能到你的 Rails 应用程序有所帮助。记住，深入阅读项目的官方文档总是获得最新且详细指导的最佳途径。

acts_as_tenantEasy multi-tenancy for Rails in a shared database setup.项目地址:https://gitcode.com/gh_mirrors/ac/acts_as_tenant