GitLab에서는 그룹을 사용하여 하나 이상의 관련 프로젝트를 동시에 관리합니다.

그룹을 사용하여 모든 그룹 멤버와 소통하고 프로젝트에 대한 권한을 관리할 수 있습니다. 누군가 그룹에 액세스할 수 있으면 그룹의 모든 프로젝트에 액세스할 수 있습니다.

그룹의 프로젝트에 대한 모든 이슈 및 머지 리퀘스트와 그룹 활동에 대한 분석도 볼 수 있습니다.

더 큰 조직의 경우 하위 그룹도 만들 수 있습니다.

그룹 생성 및 관리에 대한 자세한 내용은 그룹 관리를 참조하세요.

그룹 계층#

그룹은 트리 구조로 구성됩니다:

• 최상위 그룹은 조직의 "루트"에 만들어진 그룹입니다. 조직에는 하나 이상의 최상위 그룹이 있을 수 있습니다. 최상위 그룹에는 하나 이상의 하위 그룹이 포함될 수 있습니다.
• 상위 그룹은 하나 이상의 하위 그룹을 포함하는 그룹입니다.
• 하위 그룹은 다른 그룹의 일부인 그룹입니다.

예를 들어, 다음 다이어그램에서:

• 조직에는 네 개의 그룹이 있습니다: 하위 그룹 G를 포함하는 최상위 그룹 T 하나, G 내에 두 개의 하위 그룹(A 및 B).
• T는 최상위 그룹이자 G의 상위 그룹입니다.
• G는 T의 하위 그룹(자식)이자 A와 B의 상위 그룹입니다.
• A와 B는 G의 하위 그룹(자식)입니다.

%%{init: { "fontFamily": "GitLab Sans", 'theme':'neutral' }}%%
flowchart TD
  accTitle: Group hierarchy
  accDescr: Example of a group hierarchy in an organization
subgraph Organization
T[Group T] --> G[Group G]
G --> A[Group A]
G --> B[Group B]
end

그룹 구조#

그룹을 설정하는 방법은 사용 사례, 팀 규모 및 액세스 요구 사항에 따라 다릅니다. 다음 표는 그룹 구조화의 가장 일반적인 모델을 설명합니다.

그룹 가시성#

프로젝트와 마찬가지로, 그룹은 다음에게 표시되도록 구성할 수 있습니다:

• 익명 사용자.
• 모든 인증된 사용자.
• 명시적 그룹 멤버만.

애플리케이션 설정 수준에서 가시성 수준에 대한 제한은 그룹에도 적용됩니다. 내부로 설정된 경우 익명 사용자의 탐색 페이지가 비어 있습니다. 그룹 페이지에는 가시성 수준 아이콘이 표시됩니다.

사용자는 직계 상위 그룹보다 높은 가시성 수준의 하위 그룹이나 프로젝트를 만들 수 없습니다.

그룹 탐색#

모든 공개 또는 내부 그룹을 탐색하려면:

1. 상단 바에서 검색 또는 이동을 선택합니다.
2. 드롭다운에서 탐색을 선택합니다.
3. 왼쪽 사이드바에서 그룹을 선택합니다.

멤버인 그룹 보기#

직접 또는 간접 멤버십이 있는 그룹을 보려면:

1. 상단 바에서 검색 또는 이동을 선택합니다.
2. 드롭다운에서 모든 내 그룹 보기를 선택합니다.

이 페이지는 다음을 통해 멤버인 그룹을 표시합니다:

• 하위 그룹의 상위 그룹 멤버십.
• 그룹 또는 하위 그룹의 프로젝트의 직접 또는 상속된 멤버십.

비활성 그룹 보기#

그룹은 삭제 대기 중이거나 아카이브된 경우 비활성 상태입니다.

모든 비활성 그룹을 보려면:

1. 상단 바에서 검색 또는 이동을 선택합니다.
2. 드롭다운에서 다음 중 하나를 선택합니다:
   • 모든 내 그룹 보기: 멤버인 그룹을 필터링합니다.
   • 탐색: 공개 또는 내부 그룹을 필터링합니다.
3. 비활성 탭을 선택합니다.

목록의 각 비활성 그룹은 그룹이 아카이브되었는지 삭제 대기 중인지를 나타내는 배지를 표시합니다.

그룹이 삭제 대기 중인 경우 목록에는 다음도 표시됩니다:

• 최종 삭제가 예약된 시간.
• 복원 작업. 그룹을 복원하면:
  • 삭제 대기 중 레이블이 제거됩니다. 그룹이 더 이상 삭제 예약되지 않습니다.
  • 그룹이 비활성 탭에서 제거됩니다.

그룹 보기#

그룹 개요 페이지는 다음과 같은 그룹 및 그 멤버, 하위 그룹, 프로젝트에 대한 정보를 표시합니다:

• 그룹 설명
• 최근 활동
• 생성된 머지 리퀘스트 및 이슈 수
• 추가된 멤버 수
• 하위 그룹 및 프로젝트
• 공유 프로젝트
• 아카이브된 프로젝트

그룹을 보려면:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.

그룹의 하위 그룹 및 프로젝트를 검색하고 오름차순 또는 내림차순으로 정렬할 수 있습니다.

https://gitlab.example.com/-/g/<id>에서 이름 대신 ID를 사용하여 그룹에 액세스할 수 있습니다. 예를 들어, 그룹 example-group의 ID가 123456인 경우 https://gitlab.example.com/example-group 또는 https://gitlab.example.com/-/g/123456에서 그룹에 액세스할 수 있습니다.

그룹 ID 찾기#

GitLab API를 사용하여 그룹과 상호 작용하려면 그룹 ID가 필요할 수 있습니다.

그룹 ID를 찾으려면:

1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 그룹 개요 페이지의 오른쪽 상단에서 작업(⋮)을 선택합니다.
3. 그룹 ID 복사를 선택합니다.

그룹 활동 보기#

그룹의 활동을 보려면:

1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.

2. 왼쪽 사이드바에서 관리 > 활동을 선택합니다.

3. 선택사항. 기여 유형별로 활동을 필터링하려면 탭을 선택합니다:

   • 전체: 그룹 및 그룹 프로젝트의 그룹 멤버에 의한 모든 기여.
   • 푸시 이벤트: 그룹 프로젝트의 푸시 이벤트.
   • 머지 이벤트: 그룹 프로젝트에서 수락된 머지 리퀘스트.
   • 이슈 이벤트: 그룹 프로젝트에서 열리고 닫힌 이슈.
   • 댓글: 그룹 프로젝트에서 그룹 멤버가 게시한 댓글.
   • 위키: 그룹의 위키 페이지 업데이트.
   • 디자인: 그룹 프로젝트에서 추가, 업데이트 및 제거된 디자인.
   • 팀: 그룹 프로젝트에 합류하고 떠난 그룹 멤버.

그룹 만들기#

그룹을 만들려면:

1. 오른쪽 상단에서 새로 만들기(+)와 새 그룹을 선택합니다.
2. 그룹 만들기를 선택합니다.
3. 그룹 이름 텍스트 상자에 그룹 이름을 입력합니다. 그룹 이름으로 사용할 수 없는 단어 목록은 예약된 이름을 참조하세요.
4. 그룹 URL 텍스트 상자에 네임스페이스에 사용되는 그룹 경로를 입력합니다.
5. 그룹의 가시성 수준을 선택합니다.
6. 선택사항. GitLab 경험을 개인화하려면:
   • **이 그룹을 누가 사용할 것입니까?**에서 옵션을 선택합니다.
   • 이 그룹을 무엇에 사용할 것입니까? 드롭다운 목록에서 옵션을 선택합니다.
7. 선택사항. 그룹에 멤버를 초대하려면 이메일 1 텍스트 상자에 초대할 사용자의 이메일 주소를 입력합니다. 더 많은 사용자를 초대하려면 다른 멤버 초대를 선택하고 사용자의 이메일 주소를 입력합니다.
8. 그룹 만들기를 선택합니다.

그룹에 대한 자세한 내용은 GitLab 네임스페이스(사용자, 그룹 및 하위 그룹)를 참조하세요.

그룹 이름, 설명 및 아바타 편집#

그룹 일반 설정에서 그룹 세부 정보를 편집할 수 있습니다.

사전 요구사항:

• 그룹에 대한 Owner 역할이 있어야 합니다.

그룹 세부 정보를 편집하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
3. 그룹 이름 텍스트 상자에 그룹 이름을 입력합니다. 그룹 이름 제한을 참조하세요.
4. 선택사항. 그룹 설명(선택사항) 텍스트 상자에 그룹 설명을 입력합니다. 설명은 500자로 제한됩니다.
5. 선택사항. 그룹 아바타에서 파일 선택을 선택한 다음 이미지를 선택합니다. 이상적인 이미지 크기는 192 x 192픽셀이며 허용되는 최대 파일 크기는 200KB입니다.
6. 변경 사항 저장을 선택합니다.

그룹 떠나기#

그룹을 떠나면:

• 더 이상 그룹, 하위 그룹 및 프로젝트의 멤버가 아니며 기여할 수 없습니다.
• 귀하에게 할당된 모든 이슈 및 머지 리퀘스트의 담당자가 해제됩니다.

그룹을 떠나려면:

1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 그룹 개요 페이지의 오른쪽 상단에서 작업(⋮)을 선택합니다.
3. 그룹 떠나기를 선택한 다음 다시 그룹 떠나기를 선택합니다.

삭제를 위해 그룹 예약#

기본적으로 그룹을 처음 삭제하면 삭제 대기 상태로 전환됩니다. 다시 삭제하면 즉시 제거됩니다.

사전 요구사항:

• 그룹에 대한 Owner 역할이 있어야 합니다.
• 그룹에 프로젝트가 포함된 경우 소유자는 프로젝트 삭제가 허용되어야 합니다.

그룹과 그 내용을 삭제하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
3. 고급 섹션을 확장합니다.
4. 그룹 삭제 섹션에서 삭제를 선택합니다.
5. 확인 대화상자에서 그룹 경로를 입력하고 예, 그룹 삭제를 선택합니다.

그룹 대시보드에서도 그룹을 삭제할 수 있습니다:

1. 상단 바에서 검색 또는 이동 > 모든 내 그룹 보기를 선택합니다.
2. 삭제하려는 그룹의 (⋮)를 선택합니다.
3. 삭제를 선택합니다.
4. 확인 대화상자에서 그룹 경로를 입력하고 예, 그룹 삭제를 선택합니다.

이 작업은 삭제를 위해 그룹을 예약하는 백그라운드 job을 추가합니다. GitLab.com에서 그룹은 30일 후에 삭제됩니다. GitLab Self-Managed에서는 인스턴스 설정을 통해 보존 기간을 수정할 수 있습니다.

그룹이 삭제 예약되면 예약된 CI/CD 파이프라인이 중지됩니다.

삭제가 발생하기 전에 그룹 삭제를 예약한 사용자가 그룹에 대한 액세스를 잃으면(예: 그룹을 떠나거나, 역할이 다운그레이드되거나, 그룹에서 차단) 삭제 job이 대신 그룹을 복원하고 그룹은 더 이상 삭제 예약되지 않습니다.

그룹 즉시 삭제#

기다리지 않으려면 그룹을 즉시 삭제할 수 있습니다.

사전 요구사항:

• 그룹에 대한 Owner 역할이 있어야 합니다.
• 삭제를 위해 그룹을 예약했습니다.

삭제 예약된 그룹을 영구적으로 삭제하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
3. 고급을 확장합니다.
4. 그룹 삭제 섹션에서 영구적으로 삭제를 선택합니다.
5. 확인 대화상자에서 그룹 경로를 입력하고 예, 그룹 삭제를 선택합니다.

이 작업은 그룹, 하위 그룹, 프로젝트 및 이슈 및 머지 리퀘스트를 포함한 모든 관련 리소스를 삭제합니다.

그룹 복원#

삭제 예약된 그룹을 복원하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
3. 고급 섹션을 확장합니다.
4. 그룹 복원 섹션에서 그룹 복원을 선택합니다.

작업 메뉴로 그룹 관리#

모든 그룹 목록을 보고 작업 메뉴로 관리할 수 있습니다.

사전 요구사항:

• 그룹 떠나기를 제외한 모든 사용 가능한 작업에는 Owner 역할이 필요합니다.

그룹의 작업 메뉴에 액세스하려면:

1. 상단 바에서 검색 또는 이동 > 모든 내 그룹 보기를 선택합니다.
2. 그룹 페이지에서 그룹을 찾고 작업 메뉴(⋮)를 선택합니다.
3. 작업을 선택합니다.

다음 작업은 그룹 상태에 따라 사용 가능합니다:

그룹 액세스 요청#

사용자는 관리자가 허용하는 경우 그룹의 멤버가 되도록 요청할 수 있습니다.

1. 상단 바에서 검색 또는 이동 > 모든 내 그룹 보기를 선택합니다.
2. 오른쪽 상단에서 그룹 탐색을 선택합니다.
3. 검색 텍스트 상자에 가입하려는 그룹의 이름을 입력합니다.
4. 검색 결과에서 그룹 이름을 선택합니다.
5. 그룹 페이지의 그룹 이름 아래에서 액세스 요청을 선택합니다.

가장 최근에 활성화된 그룹 소유자 최대 10명이 귀하의 요청이 담긴 이메일을 받습니다. 모든 그룹 소유자가 요청을 승인하거나 거부할 수 있습니다.

요청이 승인되기 전에 마음이 바뀌면 액세스 요청 철회를 선택합니다.

그룹 멤버 보기#

그룹의 멤버를 보려면:

1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 관리 > 멤버를 선택합니다.

표에는 다음과 같은 멤버 정보가 표시됩니다:

• 계정 이름 및 사용자 이름.
• 멤버십의 출처. 투명성을 위해 GitLab은 그룹 멤버의 모든 멤버십 출처를 표시합니다. 여러 멤버십 출처를 가진 멤버는 별도의 멤버로 표시되고 계산됩니다.