하위 그룹

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

GitLab 그룹을 하위 그룹으로 조직할 수 있습니다. 하위 그룹을 사용하여:

  • 내부 및 외부 콘텐츠를 분리합니다. 모든 하위 그룹은 자체 가시성 수준을 가질 수 있으므로, 동일한 상위 그룹 아래에 서로 다른 목적을 위한 그룹을 호스팅할 수 있습니다.

  • 대규모 프로젝트를 조직합니다. 하위 그룹을 사용하여 소스 코드의 일부에 접근할 수 있는 사람들을 관리할 수 있습니다.

  • 권한을 관리합니다. 사용자가 회원인 각 그룹에 대해 다른 역할을 부여합니다.

하위 그룹은:

  • 하나의 즉각적인 상위 그룹에 속할 수 있습니다.
  • 여러 하위 그룹을 가질 수 있습니다.
  • 최대 20단계까지 중첩될 수 있습니다.
  • 상위 그룹에 등록된 러너를 사용할 수 있습니다:
    • 상위 그룹에 대해 구성된 비밀은 하위 그룹 작업에 사용할 수 있습니다.
    • 하위 그룹에 속한 프로젝트에서 관리 역할을 가진 사용자는 상위 그룹에 등록된 러너의 세부정보를 볼 수 있습니다.

예를 들어:

%%{init: { "fontFamily": "GitLab Sans" }}%% graph TD accTitle: 상위 및 하위 그룹 중첩 accDescr: 상위 그룹, 하위 그룹 및 프로젝트의 중첩 방식. subgraph "상위 그룹" subgraph "하위 그룹 A" subgraph "하위 그룹 A1" G["프로젝트 E"] end C["프로젝트 A"] D["프로젝트 B"] E["프로젝트 C"] end subgraph "하위 그룹 B" F["프로젝트 D"] end end

그룹의 하위 그룹 보기

전제 조건:

  • 비공개 중첩 하위 그룹을 보려면 해당 비공식 하위 그룹의 직접 또는 상속된 회원이어야 합니다.

그룹의 하위 그룹을 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 하위 그룹 및 프로젝트 탭을 선택합니다.
  3. 보려는 하위 그룹을 선택합니다.
    중첩 하위 그룹을 보려면 하위 그룹을 확장( )합니다.

공개 상위 그룹의 비공식 하위 그룹

계층 목록에서 비공식 하위 그룹이 있는 공개 그룹은 그룹에 중첩 하위 그룹이 있다는 것을 나타내는 확장 옵션( )이 있습니다. 모든 사용자는 확장 옵션( )을 볼 수 있지만, 비공식 하위 그룹의 직접 또는 상속된 회원만 비공식 그룹을 볼 수 있습니다.

중첩 하위 그룹의 존재에 대한 정보를 비공개로 유지하고 싶은 경우, 비공식 하위 그룹은 비공식 상위 그룹에만 추가해야 합니다.

하위 그룹 만들기

전제 조건:

note
최상위 도메인 이름으로 GitLab Pages 하위 그룹 웹사이트를 호스팅할 수 없습니다. 예: subgroupname.example.io.

하위 그룹을 만들려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 하위 그룹을 만들고자 하는 그룹을 찾습니다.
  2. 상위 그룹의 개요 페이지에서 오른쪽 상단 모서리에 있는 새 하위 그룹을 선택합니다.
  3. 필드를 작성합니다. 그룹 이름으로 사용할 수 없는 예약된 이름 목록을 확인하세요.
  4. 하위 그룹 생성을 선택합니다.

하위 그룹을 생성할 수 있는 사람 변경

사전 요구 사항:

  • 그룹 설정에 따라 그룹에서 최소한 유지 관리자의 역할을 가져야 합니다.

그룹에서 하위 그룹을 생성할 수 있는 사람을 변경하려면:

  • 그룹에서 소유자 역할을 가진 사용자로서:
    1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
    2. 설정 > 일반을 선택합니다.
    3. 권한 및 그룹 기능을 확장합니다.
    4. 하위 그룹을 생성할 수 있는 역할에서 옵션을 선택합니다.
    5. 변경 사항 저장을 선택합니다.
  • 관리자로서:
    1. 왼쪽 사이드바에서 맨 아래의 관리자를 선택합니다.
    2. 왼쪽 사이드바에서 개요 > 그룹을 선택하고 그룹을 찾습니다.
    3. 그룹의 행에서 편집을 선택합니다.
    4. 하위 그룹을 생성할 수 있는 드롭다운 목록에서 옵션을 선택합니다.
    5. 변경 사항 저장을 선택합니다.

자세한 정보는 권한 테이블을 참조하세요.

하위 그룹 구성원

  • 변경됨 GitLab 16.10에서 초대된 그룹 구성원을 구성원 페이지의 구성원 탭에 표시합니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 17.0에서 GitLab.com 및 셀프 관리에서 활성화됨.
  • GitLab 17.4에서 기능 플래그 webui_members_inherited_users가 제거됨. 초대된 그룹의 구성원은 기본적으로 표시됩니다.

그룹에 구성원을 추가하면 해당 구성원도 해당 그룹의 모든 하위 그룹에 추가됩니다.

구성원의 권한은 그룹으로부터 모든 하위 그룹으로 상속됩니다.

하위 그룹 구성원은 다음과 같습니다:

  1. 하위 그룹의 직접 구성원.
  2. 하위 그룹의 상위 그룹에서 상속된 구성원.
  3. 하위 그룹의 최상위 그룹과 공유된 그룹의 구성원.
  4. 간접 구성원에는 상속된 구성원과 하위 그룹 또는 그 조상의 그룹에 초대된 그룹의 구성원이 포함됩니다.
%%{init: { "fontFamily": "GitLab Sans" }}%% flowchart RL accTitle: 하위 그룹 구성원 accDescr: 사용자가 하위 그룹의 구성원이 되는 방법 - 직접, 간접 또는 상속된 구성원으로. subgraph 그룹 A A(직접 구성원) B{{공유된 구성원}} subgraph 하위 그룹 A H(1. 직접 구성원) C{{2. 상속된 구성원}} D{{상속된 구성원}} E{{3. 공유된 구성원}} end A-->|그룹 A의 직접 구성원\n하위 그룹 A의 상속된 구성원|C end subgraph 그룹 C G(직접 구성원) end subgraph 그룹 B F(직접 구성원) end F-->|그룹 B\n그룹 A와 공유됨|B B-->|하위 그룹 A의 상속된 구성원|D G-->|하위 그룹 A와 공유된 그룹 C|E

구성원의 그룹 권한은 다음에 의해 변경될 수 있습니다:

  • 그룹에서 소유자 역할을 가진 사용자.
  • 구성원이 추가된 그룹의 구성을 변경하는 것.

회원 상속 결정

회원이 상위 그룹으로부터 권한을 상속 받았는지 확인하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.

  2. 관리 > 구성원을 선택합니다.
    구성원의 상속은 출처 열에 표시됩니다.

예시 하위 그룹 _Four_의 구성원 목록:

그룹 구성원 페이지

위 스크린샷에서:

  • 다섯 명의 구성원이 그룹 _Four_에 접근할 수 있습니다.
  • 사용자 0은 그룹 _Four_에서 Reporter 역할을 가지고 있으며, 그룹 _One_에서 권한을 상속 받았습니다:
    • 사용자 0은 그룹 _One_의 직접적인 구성원입니다.
    • 그룹 One_은 계층 구조에서 그룹 _Four 위에 있습니다.
  • 사용자 1은 그룹 _Four_에서 Developer 역할을 가지고 있으며, 그룹 _Two_에서 권한을 상속 받았습니다:
    • 사용자 0은 그룹 _Two_의 직접적인 구성원이며, 그룹 _Two_는 그룹 _One_의 하위 그룹입니다.
    • 그룹 One / Two_는 그룹 _Four 위에 있습니다.
  • 사용자 2는 그룹 _Four_에서 Developer 역할을 가지고 있으며, 그룹 _Three_에서 권한을 상속 받았습니다:
    • 사용자 0은 그룹 _Three_의 직접적인 구성원이며, 그룹 _Three_는 그룹 _Two_의 하위 그룹입니다. 그룹 _Two_는 그룹
      _One_의 하위 그룹입니다.
    • 그룹 One / Two / Three_는 그룹 _Four 위에 있습니다.
  • 사용자 3은 그룹 _Four_의 직접적인 구성원입니다. 이는 그들이 그룹 _Four_에서 직접 Maintainer 역할을 받음을 의미합니다.
  • 관리자는 그룹 _Four_에서 Owner 역할을 가지고 있으며 모든 하위 그룹의 구성원입니다. 그런 이유로 사용자 3과 마찬가지로
    출처 열은 그들이 직접적인 구성원임을 나타냅니다.

구성원은 상속된 또는 직접 구성원으로 필터링할 수 있습니다.

상위 그룹 구성원 자격 무시

하위 그룹의 Owner 역할을 가진 사용자는 그 그룹에 구성원을 추가할 수 있습니다.

사용자에게 상위 그룹에서 가지고 있는 역할보다 낮은 역할을 하위 그룹에서 부여할 수는 없습니다.
상위 그룹에서 사용자의 역할을 무시하려면, 사용자를 더 높은 역할로 하위 그룹에 다시 추가하십시오.
예를 들어:

  • 사용자 1이 그룹 _Two_에 Developer 역할로 추가되면, 사용자 1은 그룹 _Two_의 모든 하위 그룹에서 그 역할을 상속받습니다.
  • 그룹 _Four_에서 사용자 1에게 Maintainer 역할을 부여하려면, 사용자 1을 그룹 _Four_에 다시 추가하고
    Maintainer 역할을 부여합니다.
  • 사용자 1이 그룹 _Four_에서 제거되면, 사용자의 역할은 그룹 _Two_의 역할로 돌아갑니다. 사용자 1은 다시
    그룹 _Four_에서 Developer 역할을 갖게 됩니다.

하위 그룹 언급

에픽, 이슈, 커밋 및 병합 요청에서 하위 그룹을 언급하는 것은 (@<subgroup_name>)
그 그룹의 모든 직접적인 구성원에게 알립니다. 하위 그룹의 상속된 구성원은 언급으로 알림을 받지 않습니다.
언급은 프로젝트 및 그룹과 동일하게 작동하며 알림을 받을 구성원 그룹을 선택할 수 있습니다.