서브그룹
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
GitLab 그룹을 서브그룹으로 구성할 수 있습니다. 계층 구조 목록에서 비공개 서브그룹을 가진 공개 그룹에는 확장 옵션([chevron-down])이 있으며, 이는 해당 그룹이 중첩된 서브그룹을 가지고 있음을 나타냅니다.
GitLab 그룹을 서브그룹으로 구성할 수 있습니다. 서브그룹을 사용하면:
- 내부 콘텐츠와 외부 콘텐츠를 분리할 수 있습니다. 각 서브그룹에 고유한 가시성 수준을 설정할 수 있으므로 동일한 상위 그룹 아래 다양한 목적의 그룹을 호스팅할 수 있습니다.
- 대규모 프로젝트를 구성할 수 있습니다. 서브그룹을 사용하여 소스 코드의 특정 부분에 액세스할 수 있는 사용자를 관리할 수 있습니다.
- 권한을 관리할 수 있습니다. 사용자가 멤버인 각 그룹에 대해 다른 역할을 부여합니다.
서브그룹은:
- 하나의 직접 상위 그룹에 속합니다.
- 여러 서브그룹을 가질 수 있습니다.
- 최대 20단계까지 중첩할 수 있습니다.
- 상위 그룹에 등록된 러너를 사용할 수 있습니다:
- 상위 그룹에 구성된 시크릿은 서브그룹 잡에서 사용할 수 있습니다.
- 서브그룹에 속하는 프로젝트에서 Maintainer 또는 Owner 역할을 가진 사용자는 상위 그룹에 등록된 러너의 세부 정보를 볼 수 있습니다.
예시:
소스 코드 보기
%%{init: { "fontFamily": "GitLab Sans" }}%%
graph TD
accTitle: Parent and subgroup nesting
accDescr: How parent groups, subgroups, and projects nest.
subgraph "Parent group"
subgraph "Subgroup A"
subgraph "Subgroup A1"
G["Project E"]
end
C["Project A"]
D["Project B"]
E["Project C"]
end
subgraph "Subgroup B"
F["Project D"]
end
end</code></pre></details></div>
그룹의 서브그룹 보기#
사전 조건:
- 비공개 중첩 서브그룹을 보려면 해당 비공개 서브그룹의 직접 또는 상속된 멤버여야 합니다.
그룹의 서브그룹을 보려면:
- 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 서브그룹 및 프로젝트 탭을 선택합니다.
- 보려는 서브그룹을 선택합니다.
중첩된 서브그룹을 보려면 서브그룹을 확장([chevron-down])합니다.
공개 상위 그룹의 비공개 서브그룹#
계층 구조 목록에서 비공개 서브그룹을 가진 공개 그룹에는 확장 옵션([chevron-down])이
있으며, 이는 해당 그룹이 중첩된 서브그룹을 가지고 있음을 나타냅니다. 모든 사용자가 확장 옵션([chevron-down])을 볼 수 있지만, 비공개 서브그룹의 직접 또는 상속된 멤버만 비공개 그룹을 볼 수 있습니다.
중첩된 서브그룹의 존재에 대한 정보를 비공개로 유지하려면
비공개 상위 그룹에만 비공개 서브그룹을 추가해야 합니다.
서브그룹 만들기#
사전 조건:
- 다음 중 하나여야 합니다:
- 그룹에 대한 Maintainer 또는 Owner 역할.
- 설정으로 결정된 역할. 이 사용자들은 그룹 생성이
사용자 설정에서 관리자에 의해 비활성화된 경우에도
서브그룹을 만들 수 있습니다.
Note
GitLab Pages 서브그룹 웹사이트를 최상위 도메인 이름으로 호스팅할 수 없습니다. 예: subgroupname.example.io.
서브그룹을 만들려면:
- 상단 표시줄에서 검색 또는 이동을 선택하고 서브그룹을 만들 그룹을 찾습니다.
- 상위 그룹 개요 페이지에서 오른쪽 상단 모서리의 새 서브그룹을 선택합니다.
- 필드를 입력합니다. 그룹 이름으로 사용할 수 없는 예약된 이름 목록을 확인하세요.
- 서브그룹 만들기를 선택합니다.
서브그룹을 만들 수 있는 사용자 변경#
사전 조건:
- 그룹의 설정에 따라 그룹에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.
그룹에서 서브그룹을 만들 수 있는 사용자를 변경하려면:
- 그룹에 대해 Owner 역할을 가진 사용자로서:
- 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 설정 > 일반을 선택합니다.
- 권한 및 그룹 기능을 확장합니다.
- 서브그룹을 만들 수 있는 역할에서 옵션을 선택합니다.
- 변경 사항 저장을 선택합니다.
- 관리자로서:
- 오른쪽 상단 모서리에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 개요 > 그룹을 선택하고 그룹을 찾습니다.
- 그룹 행에서 편집을 선택합니다.
- 서브그룹을 만들 수 있는 사용자 드롭다운 목록에서 옵션을 선택합니다.
- 변경 사항 저장을 선택합니다.
자세한 내용은 권한 테이블을 참조하세요.
서브그룹 멤버십#
히스토리
- GitLab 16.10에서
webui_members_inherited_users라는 플래그와 함께 Members 페이지의 Members 탭에 초대된 그룹 멤버를 표시하도록 변경됨. 기본적으로 비활성화.
- GitLab 17.0에서 GitLab.com 및 GitLab Self-Managed에 활성화됨.
- GitLab 17.4에서
webui_members_inherited_users 기능 플래그 제거됨. 초대된 그룹의 멤버가 기본적으로 표시됨.
그룹에 멤버를 추가하면 해당 멤버는 해당 그룹의 모든 서브그룹에도 추가됩니다.
멤버의 권한은 그룹에서 모든 서브그룹으로 상속됩니다.
서브그룹 멤버는 다음이 될 수 있습니다:
- 서브그룹의 직접 멤버.
- 서브그룹 상위 그룹에서 서브그룹의 상속된 멤버.
- 서브그룹의 최상위 그룹과 공유된 그룹의 멤버.
- 간접 멤버는 상속된 멤버와 서브그룹 또는 그 상위에 초대된 그룹의 멤버를 포함합니다.
Mermaid 다이어그램 (25줄)소스 코드 보기
%%{init: { "fontFamily": "GitLab Sans" }}%%
flowchart RL
accTitle: Subgroup membership
accDescr: How users become members of a subgroup - through direct, indirect, or inherited membership.
subgraph Group A
A(Direct member)
B{{Shared member}}
subgraph Subgroup A
H(1#46; Direct member)
C{{2#46; Inherited member}}
D{{Inherited member}}
E{{3#46; Shared member}}
end
A-->|Direct membership of Group A\nInherited membership of Subgroup A|C
end
subgraph Group C
G(Direct member)
end
subgraph Group B
F(Direct member)
end
F-->|Group B\nshared with\nGroup A|B
B-->|Inherited membership of Subgroup A|D
G-->|Group C shared with Subgroup A|E
그룹 권한은 다음에 의해서만 변경할 수 있습니다:
- 그룹에서 Owner 역할을 가진 사용자.
- 멤버가 추가된 그룹의 구성 변경.
멤버십 상속 확인#
멤버가 상위 그룹에서 권한을 상속받았는지 확인하려면:
- 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 관리 > 멤버를 선택합니다.
멤버의 상속 정보가 소스 열에 표시됩니다.
예시 서브그룹 Four의 멤버 목록:
이전 스크린샷에서:
- 5명의 멤버가 그룹 Four에 액세스할 수 있습니다.
- User 0은 그룹 Four에서 Reporter 역할을 가지며, 그룹 One에서 권한을 상속받았습니다:
- User 0은 그룹 One의 직접 멤버입니다.
- 그룹 One은 계층 구조에서 그룹 Four 위에 있습니다.
- User 1은 그룹 Four에서 Developer 역할을 가지며, 그룹 Two에서 권한을 상속받았습니다:
- User 0은 그룹 One의 서브그룹인 그룹 Two의 직접 멤버입니다.
- 그룹 One / Two는 계층 구조에서 그룹 Four 위에 있습니다.
- User 2는 그룹 Four에서 Developer 역할을 가지며, 그룹 Three에서 권한을 상속받았습니다:
- User 0은 그룹 Two의 서브그룹인 그룹 Three의 직접 멤버입니다. 그룹 Two는 그룹
One의 서브그룹입니다.
- 그룹 One / Two / Three는 계층 구조에서 그룹 Four 위에 있습니다.
- User 3은 그룹 Four의 직접 멤버입니다. 즉, 그룹 Four에서 직접 Maintainer 역할을 받습니다.
- 관리자는 그룹 Four에서 Owner 역할을 가지며 모든 서브그룹의 멤버입니다. 따라서 User 3과 마찬가지로
소스 열에 직접 멤버로 표시됩니다.
멤버는 상속된 또는 직접 멤버십으로 필터링할 수 있습니다.
상위 그룹 멤버십 재정의#
서브그룹에서 Owner 역할을 가진 사용자는 서브그룹에 멤버를 추가할 수 있습니다.
상위 그룹에서 사용자가 가진 역할보다 낮은 역할을 서브그룹에서 부여할 수는 없습니다.
상위 그룹에서 사용자의 역할을 재정의하려면 더 높은 역할로 서브그룹에 사용자를 다시 추가하세요.
예시:
- User 1이 Developer 역할로 그룹 Two에 추가되면, User 1은 그룹 Two의 모든 서브그룹에서
해당 역할을 상속받습니다.
- One / Two / Three 아래 그룹 Four에서 User 1에게 Maintainer 역할을 부여하려면,
Maintainer 역할로 User 1을 다시 그룹 Four에 추가하세요.
- User 1이 그룹 Four에서 제거되면, 사용자의 역할은 그룹 Two에서의 역할로 돌아갑니다.
User 1은 다시 그룹 Four에서 Developer 역할을 갖게 됩니다.
서브그룹 언급#
에픽, 이슈, 커밋, 머지 리퀘스트에서 서브그룹(@<subgroup_name>)을 언급하면
해당 그룹의 모든 직접 멤버에게 알림이 전송됩니다. 서브그룹의 상속된 멤버는 언급으로 알림을 받지 않습니다.
언급은 프로젝트 및 그룹과 동일하게 작동하며, 알림을 받을 멤버 그룹을 선택할 수 있습니다.