InfoGrab DocsInfoGrab Docs

조직이 생성되는 방식

요약

조직 생성은 현재 여러 개의 독립된 경로를 통해 이루어지며, 모든 경로가 같은 관문을 공유하지는 않습니다. "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용 조직을 생성하고 확인할 수 있습니다. 플로는 다음과 같이 동작합니다.

  1. TLG에 확인되지 않은 기본이 아닌 조직이 있는지 확인합니다. 있다면 TLG가 이미 백필된 것이므로 3단계로 건너뜁니다.
  2. /groups/<group-path>/-/create_organization_from_group으로 API를 호출합니다. 확인되지 않은 상태로 조직을 생성하고 그룹을 그 조직으로 이전합니다.
  3. 현재 사용자가 소유자인 다른 TLG 중 조직으로 이동할 그룹을 선택합니다.
  4. Mutations::Organizations::Confirm으로 GraphQL 호출을 합니다. 선택한 다른 TLG를 이전하고 조직을 확인합니다.
  5. 조직을 확인하면 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 픽스처에서, 기본 조직을 소유하지 않는 모든 셀에서 시드된 관리자를 위한 셀별 조직을 생성합니다.

두 경로 모두 인스턴스 프로비저닝 밖에서는 접근할 수 없으며, 위 표에 포함되지 않습니다.

조직이 생성되는 방식

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용 조직을 생성하고 확인할 수 있습니다. 플로는 다음과 같이 동작합니다.

  1. TLG에 확인되지 않은 기본이 아닌 조직이 있는지 확인합니다. 있다면 TLG가 이미 백필된 것이므로 3단계로 건너뜁니다.
  2. /groups/<group-path>/-/create_organization_from_group으로 API를 호출합니다. 확인되지 않은 상태로 조직을 생성하고 그룹을 그 조직으로 이전합니다.
  3. 현재 사용자가 소유자인 다른 TLG 중 조직으로 이동할 그룹을 선택합니다.
  4. Mutations::Organizations::Confirm으로 GraphQL 호출을 합니다. 선택한 다른 TLG를 이전하고 조직을 확인합니다.
  5. 조직을 확인하면 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 픽스처에서, 기본 조직을 소유하지 않는 모든 셀에서 시드된 관리자를 위한 셀별 조직을 생성합니다.

두 경로 모두 인스턴스 프로비저닝 밖에서는 접근할 수 없으며, 위 표에 포함되지 않습니다.