하위 도메인이 있는 다중 테넌트 Ruby on Rails 앱 빌드

config.action_dispatch.tld_length = 0

다중 테넌시와 함께 작동하는 하위 도메인 만들기

이제 기사에 작성자를 지정할 수 있습니다. 하위 도메인을 사용하는 경우에는 불가능합니다. ArticlesController의 동작을 변경해야 합니다. , 모든 작성자를 설정하는 대신 하위 도메인이 요청된 작성자를 설정해야 합니다.

 
class ArticlesController < ApplicationController
 before_action :set_author
 before_action :set_article, only: [:show, :edit, :update, :destroy]
 
 # GET /articles
 # GET /articles.json
 def index
   @articles = Article.where(tenant_id: @author.id)
 end
 
 # ...
 
 private
   def set_article
     @article = Article.find_by!(id: params[:id], tenant_id: @author.id)
   end
 
   # ...
 
   def set_author
     @author = Author.find_by!(slug: request.subdomain)
   end
end

컨트롤러를 몇 가지 변경했습니다.

• set_authors 대신 메소드에서 set_author를 정의했습니다. 하위 도메인을 통해 요청한 작성자를 설정하는 메서드입니다. before_filter에서 이 메서드를 호출하는 것이 중요합니다. set_article 앞에 라고 합니다. 기사를 설정하기 전에 작성자를 지정해야 합니다.
• set_article을 업데이트했습니다. 주어진 id와 지정된 저자로 기사를 찾는 메소드. 현재 테넌트가 John인 동안 Tom이 만든 기사를 렌더링하고 싶지 않습니다.
• 현재 테넌트에 할당된 기사만 선택하도록 색인 작업을 업데이트했습니다.

다중 테넌트 앱에서 작업하고 하나의 스키마로 하나의 데이터베이스를 사용할 때 항상 tenant_id로 쿼리 범위를 지정해야 한다는 것을 기억해야 합니다. 열; 그렇지 않으면 요청한 테넌트에 할당되지 않은 데이터를 제공하게 됩니다.

컨트롤러가 업데이트되었으므로 다음 단계는 양식 보기를 업데이트하는 것입니다. app/views/articles/_form.html.erb를 엽니다. 파일을 만들고 이전 섹션을 간단한 숨겨진 필드로 바꿉니다.

<%= form.hidden_field :tenant_id, value: @author.id %>

이러한 변경 이전에는 사용자가 양식을 사용하여 기사 작성자를 선택할 수 있었습니다. 사용자는 웹사이트 주소에서 주어진 하위 도메인을 사용하여 모든 작업에 대한 작성자를 선택할 수 있습니다.

이제 우리가 만든 코드를 테스트할 수 있습니다. 예를 들어 이름이 John Doe이고 슬러그가 johndoe인 새 작성자를 만듭니다. . https://johndoe.localhost:3000/articles/new address를 방문하여 새 기사를 추가하십시오. 새 기사를 추가한 후 https://johndoe.localhost:3000/articles에서 사용할 수 있는 목록에서 볼 수 있습니다.

축하합니다! 각 작성자에 하위 도메인이 있는 다중 테넌트 앱을 만들었습니다.

추가 개선 사항

이제 새로운 기능을 추가하여 애플리케이션의 코드를 확장할 수 있습니다. 우리 블로그 플랫폼은 간단합니다. 댓글 섹션을 추가해야 할 때인가요? 어떤 기능을 추가하든지 tenant_id를 추가해야 합니다. 열을 새 모델에 추가하고 리소스를 쿼리할 때 사용합니다.

특별한 범위를 만들어 우려 사항에 래핑할 수 있습니다.

module Tenantable
 extend ActiveSupport::Concern
 
 included do
   scope :for_author, -> (author) { where(tenant_id: author.id) }
 end
end

테넌트에 대한 데이터가 포함된 모든 모델에서 사용:

class Article < ApplicationRecord
 include Tenantable
end
 
author = Author.find(1)
Article.for_author(author)

위의 접근 방식을 사용하면 tenant_id의 이름을 변경하는 경우 한 곳만 업데이트하면 됩니다. 열 또는 테넌트 관련 데이터 쿼리와 관련하여 더 많은 조건을 도입합니다.

여러 데이터베이스가 있는 다중 테넌트 Rails 애플리케이션

이전 단락에서 우리는 하나의 데이터베이스와 하나의 스키마로 여러 테넌트를 지원하는 Rails 애플리케이션을 구축했습니다. 이러한 접근 방식의 가장 큰 단점은 데이터 유출 가능성이 높다는 것입니다.

좋은 소식은 최신 버전의 Ruby on Rails 프레임워크에 여러 데이터베이스 관리를 지원하는 기능이 내장되어 있다는 것입니다. 이를 탐색하고 이를 사용하여 수많은 데이터베이스와 사용자 지정 하위 도메인이 있는 다중 테넌트 Rails 애플리케이션을 구축하는 방법을 보여 드리겠습니다.

계획은 다음과 같습니다:

• 사용 가능한 최신 버전의 Ruby 및 Ruby on Rails 프레임워크를 사용하여 Rails 애플리케이션의 골격을 생성합니다.
• 운영할 수 있는 데이터를 얻기 위해 일부 모델을 비계할 것입니다.
• 맞춤 하위 도메인에 대한 지원을 추가할 예정입니다.
• 새 데이터베이스를 만들고 구성하여 새 테넌트를 추가하는 방법을 배웁니다.
• 마지막 단계는 지정된 하위 도메인이 요청될 때 데이터베이스를 전환하도록 애플리케이션을 업데이트하는 것입니다.

테스트 데이터 준비

사용자가 여러 작성자가 게시한 기사를 볼 수 있는 블로그 플랫폼을 구축하고 있다고 가정해 보겠습니다. 각 저자는 전용 데이터베이스를 갖게 됩니다.

작성자 생성부터 시작 새로운 저자를 보고 생성하는 데 도움이 되는 스캐폴딩 기능과 함께 모델:

rails g scaffold author slug:string name:string description:string
rake db:create
rake db:migrate

이제 https://localhost:3000/authors를 방문하여 Rails가 우리를 위해 생성한 것을 볼 수 있습니다.

새 저자 추가

John Doe라는 이름과 슬러그 johndoe로 새 작성자를 만들었습니다. . 슬러그 값은 나중에 하위 도메인을 사용하여 정보를 표시해야 하는 작성자를 감지하는 데 사용됩니다.

각 작성자는 별도의 데이터베이스를 가지므로 John에 대한 새 데이터베이스를 수동으로 추가해야 합니다. config/database.yml 열기 다음 변경 사항을 추가하십시오.

development:
 primary:
   <<: *default
   database: tenantapp_development
 primary_johndoe:
   <<: *default
   database: tenantapp_johndoe_development
   migrations_paths: db/tenants_migrations

테넌트가 사용하는 마이그레이션에는 별도의 디렉터리를 사용할 것입니다. 중앙 데이터베이스에는 필요하지 않습니다. 이제 기본 명령을 사용하여 John에 대한 데이터베이스를 만들 수 있습니다.

rake db:create

기사 추가

이제 Article을 스캐폴딩할 수 있습니다. 컨트롤러 및 뷰와 함께 모델:

rails g scaffold article title:string content:text --database primary_johndoe

--database를 전달했습니다. 마이그레이션이 기본 db/migrations에 배치되어서는 안 된다는 것을 Rails에 알리는 param 기본 데이터베이스에서 사용하는 디렉토리. 이제 마이그레이션 명령을 실행할 수 있습니다.

rake db:migrate

현재 두 개의 스키마가 있습니다. db/schema.rb 및 db/primary_johndoe_schema.rb . 테넌트에 대해 다른 테이블을 생성하려는 경우 고유한 migrations_path를 설정하여 이를 수행할 수 있습니다. config/database.yml의 값 지정된 테넌트에 대한 파일입니다. 이 문서에서는 모든 테넌트에 대해 동일한 테이블을 사용하므로 마이그레이션 경로가 동일합니다.

멀티 테넌시 지원 추가

하나의 데이터베이스에서 멀티 테넌시를 지원하는 애플리케이션에서 주어진 테넌트에 대한 데이터를 얻으려면 적절한 tenant_id로 데이터베이스에 대한 쿼리를 업데이트하기만 하면 됩니다. 값. 우리의 경우 테넌트마다 데이터베이스가 있으므로 데이터베이스 간에 전환해야 합니다.

Rails 6.1은 수평 분할을 기본적으로 지원합니다. 샤드는 전체 데이터 세트의 하위 집합을 포함하는 수평 데이터 파티션입니다. 우리는 하나의 데이터베이스에 있는 하나의 테이블에 모든 저자의 기사를 저장할 수 있지만 샤딩 덕분에 데이터를 동일한 구조를 가진 여러 테이블로 분할할 수 있지만 별도의 데이터베이스에 배치할 수 있습니다.

모든 모델의 부모 클래스에서 샤드를 정의합시다. app/models/application_record.rb 아래에 저장됩니다. :

ActiveRecord::Base.connected_to(role: :reading, shard: :johndoe) do
  Article.all # get all articles created by John
end

호출을 connected_to로 래핑하지 않고 블록, 기본 샤드가 사용됩니다. 계속 진행하기 전에 변경 사항을 하나 더 도입해야 합니다. 모든 샤드가 동일한 데이터 구조를 공유하므로 app/models/primary_johndoe_record.rb를 삭제할 수 있습니다. 기사를 스캐폴딩할 때 자동으로 생성된 모델입니다.

app/models/article.rb도 수정해야 합니다. 모델을 만들고 PrimaryJohndoeRecord에서 상위 클래스를 변경합니다. ApplicationRecord로 :

class Article < ApplicationRecord
end

테넌트 추가

현재 우리 데이터베이스에는 저자가 한 명뿐입니다. 테넌트(데이터베이스) 간 전환 기능을 테스트하려면 작성자를 한 명 더 추가해야 합니다. https://localhost:3000/authors/new address를 열고 새로운 저자를 추가합니다. Tim Doe라는 이름과 슬러그 timdoe로 작성자를 추가했습니다. .

새 작성자에 대한 레코드가 있으므로 새 데이터베이스를 정의해야 합니다.

development:
 primary:
   <<: *default
   database: tenantapp_development
 primary_johndoe:
   <<: *default
   database: tenantapp_johndoe_development
   migrations_paths: db/tenants_migrations
 primary_timdoe:
   <<: *default
   database: tenantapp_timdoe_development
   migrations_paths: db/tenants_migrations

이제 새 데이터베이스를 만들고 마이그레이션을 실행합니다.

rake db:create
rake db:migrate

마지막 단계는 ApplicationRecord를 업데이트하는 것입니다. 새 샤드를 모델링하고 정의합니다.

class ApplicationRecord < ActiveRecord::Base
 self.abstract_class = true
 
 connects_to shards: {
   default: { writing: :primary, reading: :primary },
   johndoe: { writing: :primary_johndoe, reading: :primary_johndoe },
   timdoe: { writing: :primary_timdoe, reading: :primary_timdoe },
 }
end

이제 각 작성자에 대한 기사를 작성할 수 있습니다.

ActiveRecord::Base.connected_to(role: :writing, shard: :johndoe) do
  Article.create!(title: 'Article from John', content: 'content')
end
 
ActiveRecord::Base.connected_to(role: :writing, shard: :timdoe) do
  Article.create!(title: 'Article from Tim', content: 'content')
end

사용자 지정 하위 도메인에 대한 지원 추가

John과 Tim의 기사를 언제 표시해야 할지 모르기 때문에 아직 주어진 저자의 기사 목록을 방문할 수 없습니다. 사용자 지정 하위 도메인을 구현하여 이 문제를 해결할 것입니다. https://johndoe.localhost:3000/articles를 방문하면 John의 기사를 볼 수 있고 https://timedoe.localhost:3000/articles를 방문하면 Tim의 기사를 볼 수 있습니다.

하위 도메인 구성

임차인이 정해지면 기사를 관리하고 방문하고 싶습니다. config/routes.rb를 업데이트하여 이를 달성할 수 있습니다. 파일 및 기사 리소스 정의를 제약 조건 블록에 래핑:

Rails.application.routes.draw do
 constraints subdomain: /.*/ do
   resources :articles
 end
 
 resources :authors
end

기본적으로 Rails는 최상위 도메인 길이를 1로 설정하지만 localhost를 사용하여 이 설정을 0으로 설정하려고 합니다. config/environments/development.rb<파일에 다음 줄을 추가하면 됩니다. /코드> :

config.action_dispatch.tld_length = 0

module Tenantable
 extend ActiveSupport::Concern
 
 private
 
 def read_with_tenant(&block)
   author = Author.find_by!(slug: request.subdomain)
 
   ActiveRecord::Base.connected_to(role: :reading, shard: author.slug.to_sym) do
     block.call
   end
 end
end

class ArticlesController < ApplicationController
 include Tenantable
 
 before_action :set_article, only: [:show, :edit, :update, :destroy]
 
 def index
   read_with_tenant do
     @articles = Article.all
   end
 end
 # ...
end

ActiveRecord::Base.establish_connection(:primary_timdoe)