조직 데이터 격리
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
구현#
- 코드는 gem으로 구현되어 있으며
gems/gitlab-database-data_isolation에서 사용할 수 있습니다. - gem은 여러 전략을 지원합니다. ActiveRecord가 사용하는 쿼리 표현에서 동작하는 Arel 전략을 사용합니다.
config/initializers/gitlab_database_data_isolation.rb에서 gem이 모놀리스에 연결됩니다.Gitlab::Organizations::Isolation.enabled?가 격리를 적용할지 결정합니다. 이 확인은 쿼리마다 실행됩니다.
알려진 문제#
- 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
쿼리 범위 지정을 우회해야 하는 경우#
가능한 이유는 다음과 같습니다.
- 의도적인 조직 간 데이터 액세스. 예를 들어 관리자 도구입니다.
- 낮은 쿼리 성능. 쿼리 수정으로 비효율적인 쿼리가 될 수 있습니다.