InfoGrab DocsInfoGrab Docs

조직 데이터 격리

요약

gitlab-database-data_isolation gem은 공유 테이블에 대한 행 수준 데이터 격리를 제공합니다. 데이터 격리는 GitLab 19.0에서 기본적으로 비활성화된 data_isolation이라는 기능 플래그 뒤에 도입되었습니다.

gitlab-database-data_isolation gem은 공유 테이블에 대한 행 수준 데이터 격리를 제공합니다. 이 gem은 조직 격리의 쿼리 범위 지정 메커니즘이며, Protocell의 전제 조건입니다.

데이터 격리는 GitLab 19.0에서 기본적으로 비활성화된 data_isolation이라는 기능 플래그 뒤에 도입되었습니다.

데이터 격리의 목적#

조직은 고객 데이터의 컨테이너처럼 동작합니다. 한 고객의 모든 데이터는 하나의 조직에 속합니다. 조직은 설계상 격리되어 있습니다. 조직은 다른 조직의 데이터를 참조할 수 없습니다.

GitLab은 공유 인프라를 사용합니다. GitLab 인스턴스 하나에 조직이 하나 이상 있을 수 있습니다. 따라서 한 조직의 데이터가 다른 조직으로 유출되지 않도록 보장하는 메커니즘이 필요합니다.

gitlab-database-data_isolation gem은 샤딩 키가 구성된 테이블에 대한 ActiveRecord 쿼리를 투명하게 다시 작성해 이를 방지합니다.

쿼리를 데이터베이스로 보내기 전에 FROM 테이블에 WHERE 절을 추가로 삽입하는 방식으로 동작합니다. 예를 들면 다음과 같습니다.

SELECT "users"."id" FROM "users" WHERE "users"."username" = 'some_user'
# Scoped:
SELECT "users"."id" FROM "users" WHERE "users"."username" = 'some_user' AND "users"."organization_id" = 1000

구현#

알려진 문제#

  • ActiveRecord가 처리하는 쿼리만 지원됩니다.
  • UPDATE, DELETE, INSERT 문은 격리되지 않습니다.

데이터 격리 활성화#

다음 조건이 모두 참일 때만 쿼리에 격리가 적용됩니다.

  • 기능 플래그가 활성화되어 있습니다: Feature.enable(:data_isolation).
  • Current.organization이 할당되어 있습니다.
  • 현재 조직이 격리된 것으로 표시되어 있습니다. 모든 조직을 표시하려면 Organizations::Organization.find_each(&:mark_as_isolated!)를 실행합니다.

예시#

격리가 동작하는 모습을 보려면 Rails 콘솔에서 다음 스크립트를 실행합니다.

Feature.enable(:data_isolation)
my_org = Organizations::Organization.find_or_create_by!(path: 'my-org') { |org| org.name = 'My Org' }
puts my_org.isolated? # initially, the organization is not isolated
Current.organization = my_org

# my_org is not isolated, so this prints the organization ID of the first project:
puts Project.first.organization.id

# Mark my_org as isolated and repeat:
my_org.mark_as_isolated!
puts Project.first # prints nil, because no project belongs to my-org

# Bypass the isolation:
Gitlab::Database::DataIsolation::ScopeHelper.without_data_isolation do
  puts Project.first.organization.id # No longer isolated, so it will print the organization id
end

쿼리 범위 지정을 우회해야 하는 경우#

가능한 이유는 다음과 같습니다.

  • 의도적인 조직 간 데이터 액세스. 예를 들어 관리자 도구입니다.
  • 낮은 쿼리 성능. 쿼리 수정으로 비효율적인 쿼리가 될 수 있습니다.

조직 데이터 격리

GitLab v19.6
원문 보기

요약

gitlab-database-data_isolation gem은 공유 테이블에 대한 행 수준 데이터 격리를 제공합니다. 데이터 격리는 GitLab 19.0에서 기본적으로 비활성화된 data_isolation이라는 기능 플래그 뒤에 도입되었습니다.

gitlab-database-data_isolation gem은 공유 테이블에 대한 행 수준 데이터 격리를 제공합니다. 이 gem은 조직 격리의 쿼리 범위 지정 메커니즘이며, Protocell의 전제 조건입니다.

데이터 격리는 GitLab 19.0에서 기본적으로 비활성화된 data_isolation이라는 기능 플래그 뒤에 도입되었습니다.

데이터 격리의 목적#

조직은 고객 데이터의 컨테이너처럼 동작합니다. 한 고객의 모든 데이터는 하나의 조직에 속합니다. 조직은 설계상 격리되어 있습니다. 조직은 다른 조직의 데이터를 참조할 수 없습니다.

GitLab은 공유 인프라를 사용합니다. GitLab 인스턴스 하나에 조직이 하나 이상 있을 수 있습니다. 따라서 한 조직의 데이터가 다른 조직으로 유출되지 않도록 보장하는 메커니즘이 필요합니다.

gitlab-database-data_isolation gem은 샤딩 키가 구성된 테이블에 대한 ActiveRecord 쿼리를 투명하게 다시 작성해 이를 방지합니다.

쿼리를 데이터베이스로 보내기 전에 FROM 테이블에 WHERE 절을 추가로 삽입하는 방식으로 동작합니다. 예를 들면 다음과 같습니다.

SELECT "users"."id" FROM "users" WHERE "users"."username" = 'some_user'
# Scoped:
SELECT "users"."id" FROM "users" WHERE "users"."username" = 'some_user' AND "users"."organization_id" = 1000

구현#

알려진 문제#

  • ActiveRecord가 처리하는 쿼리만 지원됩니다.
  • UPDATE, DELETE, INSERT 문은 격리되지 않습니다.

데이터 격리 활성화#

다음 조건이 모두 참일 때만 쿼리에 격리가 적용됩니다.

  • 기능 플래그가 활성화되어 있습니다: Feature.enable(:data_isolation).
  • Current.organization이 할당되어 있습니다.
  • 현재 조직이 격리된 것으로 표시되어 있습니다. 모든 조직을 표시하려면 Organizations::Organization.find_each(&:mark_as_isolated!)를 실행합니다.

예시#

격리가 동작하는 모습을 보려면 Rails 콘솔에서 다음 스크립트를 실행합니다.

Feature.enable(:data_isolation)
my_org = Organizations::Organization.find_or_create_by!(path: 'my-org') { |org| org.name = 'My Org' }
puts my_org.isolated? # initially, the organization is not isolated
Current.organization = my_org

# my_org is not isolated, so this prints the organization ID of the first project:
puts Project.first.organization.id

# Mark my_org as isolated and repeat:
my_org.mark_as_isolated!
puts Project.first # prints nil, because no project belongs to my-org

# Bypass the isolation:
Gitlab::Database::DataIsolation::ScopeHelper.without_data_isolation do
  puts Project.first.organization.id # No longer isolated, so it will print the organization id
end

쿼리 범위 지정을 우회해야 하는 경우#

가능한 이유는 다음과 같습니다.

  • 의도적인 조직 간 데이터 액세스. 예를 들어 관리자 도구입니다.
  • 낮은 쿼리 성능. 쿼리 수정으로 비효율적인 쿼리가 될 수 있습니다.