조직이 생성되는 방식
GitLab v19.6요약
조직 생성은 현재 여러 개의 독립된 경로를 통해 이루어지며, 모든 경로가 같은 관문을 공유하지는 않습니다. "New organization" 양식(Organizations::OrganizationsController#new), 해당 내비게이션 항목 (Nav::NewDropdownHelper), 조직 목록과 관리자 조직 목록의 "New" 컨트롤 (Organizations...
조직 생성은 현재 여러 개의 독립된 경로를 통해 이루어지며, 모든 경로가 같은 관문을 공유하지는 않습니다. 이 페이지는 모든 경로와, 행위자와 생성된 조직 사이에 있는 관문을 점검한 내용입니다. 목표 상태가 아니라 현재 상태를 문서화합니다. 각 경로는 결국 조직 릴리스 프로세스로 하나씩 점진적으로 옮겨질 예정입니다.
생성 경로#
| 진입점 | 현재 관문 |
|---|---|
| 새 조직 양식 | org_creation 조직 플래그와 :create_organization 권한(ability) |
| GraphQL 뮤테이션 | org_creation 조직 플래그와 :create_organization 권한(ability) |
| REST API | org_creation 조직 플래그, :create_organization 권한(ability), 속도 제한 |
| 최상위 그룹 백필 및 확인 | 두 개의 ops 기능 플래그에 대한 ChatOps 프로덕션 액세스 |
| 그룹 설정에서 조직 생성 | create_org_from_group_settings 조직 플래그, :create_organization 권한(ability), :admin_group 권한(ability) |
새 조직 양식#
"New organization" 양식(Organizations::OrganizationsController#new), 해당 내비게이션 항목
(Nav::NewDropdownHelper), 조직 목록과 관리자 조직 목록의 "New" 컨트롤
(Organizations::OrganizationHelper#shared_organization_index_app_data)은 모두
org_creation 조직 플래그와 :create_organization 권한(ability)을 확인합니다.
서버에서 authorize_create_organization!을 통해 이를 강제하는 것은 양식뿐입니다.
내비게이션 항목과 "New" 컨트롤은 표시 여부만 제어할 뿐 강제하지 않습니다.
GraphQL 뮤테이션#
셀프 서비스 플로는 Mutations::Organizations::Create로 제출합니다.
이 뮤테이션은 :create_organization 권한(ability)과 organization_switching
기능 플래그를 확인합니다.
그런 다음 Organizations::CreateService를 호출하며, 이 서비스가 권한을 다시 확인합니다.
GraphQL 액세스 권한과 해당 권한(ability)이 있는 사람은 셀프 서비스 플로를 완전히 우회해
이 뮤테이션을 직접 호출할 수 있습니다.
REST API#
POST /organizations(lib/api/organizations.rb)는 org_creation 조직
플래그, :create_organization 권한(ability), 속도 제한을 확인한 다음
Organizations::CreateService를 호출하며, 이 서비스가 권한을 다시 확인합니다.
이 경로는 셀프 서비스 플로와 독립적이며 개인 액세스 토큰으로 접근할 수 있습니다.
최상위 그룹 백필 및 확인(ops)#
이 경로는 베타 고객을 온보딩하는 수동 프로세스입니다. ChatOps로 트리거되는 두 단계가 있으며, 각 단계는 행위자 범위의 ops 기능 플래그에 반응하는 이벤트 구독자 워커입니다.
Organizations::RootGroupOrganizationBackfillWorker는root_group_organization_backfill을 구독합니다. 활성화되면 확인되지 않은 상태로 조직을 생성하고 그룹을 그 조직으로 이전합니다.Organizations::ConfirmWorker는root_group_organization_confirm을 구독합니다. 활성화되면Organizations::ConfirmService를 통해 조직을 확인합니다.
두 워커는 모두 skip_authorization: true로 서비스를 호출하므로, 권한(ability)과 이 페이지의 다른 모든
관문을 우회합니다.
액세스는 프로덕션에서 ChatOps 명령을 실행할 수 있는 사람이 누구인지로만 제한됩니다.
그룹 설정에서 조직 생성#
이 경로는 베타 고객을 온보딩하는 셀프 서비스 프로세스입니다.
그룹 행위자를 지원하는 create_org_from_group_settings 조직 플래그로 제어됩니다.
이를 통해 그룹 소유자는 Settings -> General -> Advanced에서 자신의 TLG용 조직을 생성하고 확인할 수 있습니다.
플로는 다음과 같이 동작합니다.
- TLG에 확인되지 않은 기본이 아닌 조직이 있는지 확인합니다. 있다면 TLG가 이미 백필된 것이므로 3단계로 건너뜁니다.
/groups/<group-path>/-/create_organization_from_group으로 API를 호출합니다. 확인되지 않은 상태로 조직을 생성하고 그룹을 그 조직으로 이전합니다.- 현재 사용자가 소유자인 다른 TLG 중 조직으로 이동할 그룹을 선택합니다.
Mutations::Organizations::Confirm으로 GraphQL 호출을 합니다. 선택한 다른 TLG를 이전하고 조직을 확인합니다.- 조직을 확인하면
Organizations::ActivateService가 트리거되어 그룹과 프로젝트를 조직으로 이전하고 그룹/프로젝트의 모든 멤버에 대한 조직 사용자 레코드를 생성합니다. 모든 TLG의 소유자인 그룹 멤버는 조직의 관리자가 됩니다.
:create_organization 권한(ability)#
위 경로 중 여러 곳은 app/policies/global_policy.rb에 정의된 :create_organization 권한(ability)에도 의존합니다.
이 권한에는 역할이나 소유권 요건이 없습니다.
다음 두 조건이 모두 참이면 인증된 모든 사용자에게 참으로 평가됩니다.
- 인스턴스가 GitLab.com입니다. 다른 모든 인스턴스에서는 이 권한이 아예 차단됩니다.
can_create_organization애플리케이션 설정이 활성화되어 있습니다. 이 설정의 기본값은true이며 다른 제한은 없습니다.
실제로 현재 조직을 생성할 수 있는 사람을 좁히는 것은 권한(ability)이 아니라 기능 플래그 계층뿐입니다.
인스턴스 부트스트랩#
행위자 없이 조직을 생성하는 경로가 두 가지 있으며, 인스턴스 설정 중에 한 번만 실행됩니다.
Gitlab::DatabaseImporters::DefaultOrganizationImporter는db/fixtures/production/002_default_organization.rb픽스처에서, 셀이 Topology Service를 통해 요청하지 않거나 Topology Service가 셀에 부여한 시퀀스 범위에 기본 조직 ID가 포함될 때 기본 조직을 생성합니다. 다른 셀은 이를 건너뜁니다.Gitlab::DatabaseImporters::AdminOrganizationImporter는db/fixtures/production/003_admin.rb픽스처에서, 기본 조직을 소유하지 않는 모든 셀에서 시드된 관리자를 위한 셀별 조직을 생성합니다.
두 경로 모두 인스턴스 프로비저닝 밖에서는 접근할 수 없으며, 위 표에 포함되지 않습니다.