• 그룹 구조
• 그룹 가시성
• 그룹 보기
• 그룹 보기
• 그룹 활동 보기
• 그룹 생성
• 그룹 이름, 설명, 및 아바타 편집
• 그룹 나가기
• 그룹 제거
• 즉시 그룹 제거
• 그룹 복원
• 그룹에 액세스 요청
• 그룹 구성원 보기
• 그룹 구성원 필터링 및 정렬
  • 그룹 필터링
  • 그룹 검색
  • 그룹의 구성원 정렬
• 그룹에 사용자 추가
• 그룹에서 멤버 삭제
• 그룹에 프로젝트 추가
  • 그룹에 프로젝트를 추가할 수 있는 사용자 지정
• 그룹 ID 가져오기

그룹

GitLab에서 그룹은 한 번에 하나 이상의 관련 프로젝트를 관리하는 데 사용됩니다.

그룹을 사용하여 그룹 구성원 전체와 커뮤니케이션하고 프로젝트의 권한을 관리할 수 있습니다. 누군가가 그룹에 액세스 권한이 있으면 해당 그룹의 모든 프로젝트에 액세스할 수 있습니다.

또한 그룹의 활동에 대한 모든 이슈 및 Merge Request을 볼 수 있으며, 그룹의 활동에 대한 분석도 할 수 있습니다.

대규상위 조직을 위해 서브그룹도 만들 수 있습니다.

그룹을 생성하고 관리하는 자세한 정보는 그룹 관리를 참조하십시오.

그룹 구조

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

그룹 가시성

프로젝트와 마찬가지로 그룹은 다음과 같이 가시성을 구성할 수 있습니다.

• 익명 사용자.
• 모든 인증된 사용자.
• 명시적인 그룹 구성원만.

응용 프로그램 설정 레벨에서의 가시성 수준에 대한 제한은 그룹에도 적용됩니다. 내부로 설정된 경우, 탐색 페이지는 익명 사용자에게 비어 있습니다. 그룹 페이지에는 가시성 수준 아이콘이 표시됩니다.

사용자는 즉시 부모 그룹보다 더 높은 가시성 수준의 서브그룹 또는 프로젝트를 생성할 수 없습니다.

그룹 보기

소속된 모든 공개 그룹을 살펴보려면:

1. 왼쪽 사이드 바에서 검색 또는 이동을 선택합니다.
2. 내 그룹 모두 보기를 선택합니다.
3. 오른쪽 상단에서 그룹 검색을 선택합니다.

직접 또는 간접적으로 소속된 그룹을 보려면:

1. 왼쪽 사이드 바에서 검색 또는 이동을 선택합니다.
2. 내 그룹 모두 보기를 선택합니다.

이 페이지에서는 다음을 통해 소속된 그룹이 표시됩니다:

• 서브그룹의 상위 그룹의 구성원.
• 그룹이나 서브그룹의 프로젝트에 대한 직접 또는 상속된 구성원.

그룹 보기

그룹 개요 페이지에는 그룹 및 그룹의 구성원, 서브그룹, 프로젝트 등에 대한 정보가 표시됩니다.

• 그룹 설명
• 최근 활동
• 작성된 Merge Request 및 이슈 수
• 추가된 구성원 수
• 서브그룹 및 프로젝트
• 공유 프로젝트
• 보관된 프로젝트

그룹을 보려면:

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

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

그룹 활동 보기

그룹의 활동을 보려면:

1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
2. 관리 > 활동을 선택합니다.

3. 선택적으로 기여 유형에 따라 활동을 필터링하려면 탭을 선택합니다:

   • 모두: 그룹 구성원의 그룹 및 프로젝트에서의 모든 기여.
   • Push 이벤트: 그룹의 프로젝트에서의 푸시 이벤트.
   • Merge 이벤트: 그룹의 프로젝트에서 수락된 Merge Request.
   • 이슈 이벤트: 그룹의 프로젝트에서 개설 및 닫힌 이슈.
   • 댓글: 그룹의 프로젝트에 게시된 댓글.
   • 위키: 그룹의 위키 페이지 업데이트.
   • 디자인: 그룹의 프로젝트에 추가, 업데이트 및 제거된 디자인.
   • 팀: 그룹 구성원 중 그룹의 프로젝트에 참여하거나 떠난 사람들.

그룹 생성

그룹을 생성하려면:

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

그룹에 대한 자세한 정보는 GitLab 네임스페이스(사용자, 그룹 및 서브그룹)를 시청하십시오.

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

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

필수 사항:

• 그룹의 소유자 역할이 있어야 합니다.

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

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

그룹 나가기

• GitLab 16.7에서 그룹을 나가는 버튼은 이동되었습니다.

그룹을 나가면:

• 그룹, 서브그룹 및 프로젝트의 구성원이 아니게 되며, 기여할 수 없게 됩니다.
• 할당된 모든 이슈 및 Merge Request이 할당 해제됩니다.

그룹을 나가려면:

1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
2. 그룹 개요 페이지에서 오른쪽 상단에 있는 조치()을 선택합니다.
3. 그룹 나가기, 그런 다음 다시 그룹 나가기를 선택합니다.

그룹 제거

• GitLab 16.0에서 GitLab.com 및 셀프매니지드에서 지연된 삭제 기능을 기본으로 활성화하고 즉시 삭제 옵션을 제거했습니다.

그룹과 해당 콘텐츠를 제거하려면:

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

또한 그룹을 그룹 대시보드에서 제거할 수 있습니다:

1. 좌측 사이드바에서 검색 또는 이동을 선택합니다.
2. 내 그룹 모두 보기를 선택합니다.
3. 삭제하려는 그룹 옆에 ()를 선택합니다.
4. 삭제를 선택합니다.
5. 그룹 제거 섹션에서 그룹 제거를 선택합니다.
6. 확인 대화상자에서 그룹 이름을 입력하고 확인을 선택합니다.

Premium 및 Ultimate에서 이 작업은 그룹을 삭제할 때 백그라운드 작업을 추가합니다. 기본적으로 작업은 미래 7일 후에 삭제를 예약합니다. 이 보유 기간은 인스턴스 설정을 통해 수정할 수 있습니다.

삭제를 설정한 사용자가 삭제가 발생하기 전에 그룹에서 제거되면 작업이 취소되어 그룹이 더 이상 삭제 예정이 아닙니다.

즉시 그룹 제거

• GitLab 16.0에서 GitLab.com 및 셀프매니지드에서 지연된 삭제 기능을 기본으로 활성화하고 즉시 삭제 옵션을 제거했습니다.

기다리기 원하지 않는 경우 그룹을 즉시 제거할 수 있습니다.

필수 조건:

• 그룹의 소유자 역할이 있어야 합니다.
• 그룹을 삭제 예정으로 표시했어야 합니다.

삭제 예정으로 표시된 그룹을 즉시 제거하려면:

1. 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 설정 > 일반을 선택합니다.
3. 고급을 확장합니다.
4. 영구적으로 그룹 제거 섹션에서 그룹 제거를 선택합니다.
5. 요청 시 작업을 확인합니다.

이 작업은 그룹, 하위 그룹, 프로젝트 및 모든 관련 리소스(이슈 및 Merge Request 포함)를 삭제합니다.

그룹 복원

삭제 예정으로 표시된 그룹을 복원하려면:

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

그룹에 액세스 요청

사용자로서 관리자가 허용하는 경우 그룹의 구성원이 될 수 있도록 요청할 수 있습니다.

1. 좌측 사이드바에서 검색 또는 이동을 선택합니다.
2. 내 그룹 모두 보기를 선택합니다.
3. 오른쪽 상단에서 그룹 찾아보기를 선택합니다.
4. 이름으로 검색 텍스트 상자에 참여하고자 하는 그룹의 이름을 입력합니다.
5. 검색 결과에서 그룹의 이름을 선택합니다.
6. 그룹 페이지에서 그룹 이름 아래 액세스 요청을 선택합니다.

최근 활동이 많은 그룹 소유자 중 최대 열 명이 당신의 요청과 함께 이메일을 받습니다. 그룹 소유자는 요청을 승인하거나 거절할 수 있습니다.

요청이 승인되기 전에 신청을 철회하려면 액세스 요청 철회를 선택합니다.

그룹 구성원 보기

그룹의 직접 및 상속된 구성원을 보려면:

1. 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 구성원을 선택합니다.

테이블에 구성원의 다음 정보가 표시됩니다:

• 계정 이름 및 사용자 이름.
• 멤버십의 소스. 투명성을 위해 GitLab은 그룹 구성원의 모든 멤버십 소스를 표시합니다. 여러 멤버십 소스가 있는 구성원은 별도의 구성원으로 표시되어 계산됩니다. 예를 들어, 그룹에 직접으로 추가되고 상속을 통해 추가된 구성원은 두 번 표시되어 다른 소스로 표시되며 그룹의 개별 구성원으로 계산됩니다.
• 그룹 내에서의 최대 역할.
• 그룹 멤버십의 만료일.
• 계정과 관련된 활동.

모든 네임스페이스 구성원(및 해당 차지된 좌석)을 보려면 최상위 네임스페이스에서 사용량 할당 페이지를 확인하십시오.

그룹 구성원 필터링 및 정렬

그룹의 구성원을 찾기 위해 정렬, 필터링 또는 검색할 수 있습니다.

그룹 필터링

구성원을 찾기 위해 그룹을 필터링합니다. 기본적으로 그룹 및 하위 그룹의 모든 구성원이 표시됩니다.

그룹 구성원 디렉터리에서 항목은 다음 배지를 표시할 수 있습니다:

• SAML 계정이 연결된 구성원을 나타내는 SAML.
• 최상위 그룹의 멤버가 엔터프라이즈 사용자임을 나타내는 엔터프라이즈.

1. 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 구성원을 선택합니다.
3. 구성원 디렉터리 상단에서 구성원 필터링 텍스트 상자에 검색 기준을 입력합니다. 다음을 보려면:
   • 그룹의 직접 구성원을 보려면 멤버십 = 직접을 선택합니다.
   • 그룹 및 하위 그룹의 구성원을 보려면 멤버십 = 상속을 선택합니다.
   • 이중 인수 인증이 활성화되거나 비활성화된 구성원을 보려면 2FA = 활성화됨 또는 2FA = 비활성화됨을 선택합니다.
   • 최상위 그룹의 엔터프라이즈 사용자를 보려면 엔터프라이즈 = true를 선택합니다.

그룹 검색

이름, 사용자 이름 또는 공개 이메일로 구성원을 검색할 수 있습니다.

1. 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 구성원을 선택합니다.
3. 구성원 디렉터리 상단에서 구성원 필터링 상자에 검색 기준을 입력합니다.
4. 구성원 필터링 상자 오른쪽에서 돋보기({검색})를 선택합니다.

그룹의 구성원 정렬

계정, 허가된 액세스, 최대 역할, 또는 마지막 로그인으로 구성원을 정렬할 수 있습니다.

1. 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 구성원을 선택합니다.
3. 구성원 디렉터리 상단에서 오른쪽 상단 모서리에서 계정 디렉터리에서 필터링 기준을 선택합니다.
4. 오름차순과 내림차순 사이를 전환하려면 계정 디렉터리 오른쪽에서 화살표( 또는 )를 선택합니다.

그룹에 사용자 추가

• 만료된 액세스 이메일 알림은 GitLab 16.2에서 도입되었습니다.

그룹의 모든 프로젝트에 대한 사용자 액세스 권한을 부여할 수 있습니다.

필수 사항:

• 그룹의 소유자 역할이 있어야 합니다.

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 멤버를 선택합니다.
3. 멤버 초대를 선택합니다.
4. 사용자가:
   • GitLab 계정이 있는 경우 사용자명을 입력합니다.
   • GitLab 계정이 없는 경우 사용자의 이메일 주소를 입력합니다.
5. 기본 역할 또는 사용자 지정 역할을 선택합니다.

6. 선택 사항. 액세스 만료 날짜에 날짜를 입력하거나 선택합니다. 해당 날짜 이후로 사용자는 더 이상 프로젝트에 액세스할 수 없습니다.

   액세스 만료 날짜를 입력하면 그룹 멤버는 액세스가 만료되기 일주일 전에 이메일 알림을 받게 됩니다.

   멤버에게 유지자 역할을 부여하고 만료 날짜를 입력하면 해당 멤버는 역할을 유지하는 한 모든 권한이 있습니다. 이러한 권한에는 멤버의 자체 유지자 역할 기간을 연장할 수 있는 권한도 포함됩니다.

7. 초대를 선택합니다. 사용자를 다음 중 하나로 초대하는 경우:

   • GitLab 사용자명인 경우, 사용자가 멤버 디렉터리에 추가됩니다.
   • 이메일 주소인 경우, 사용자는 이메일로 초대를 수신하고 계정을 생성하도록 안내받습니다. 초대가 수락되지 않으면 GitLab은 2, 5, 10일 후에 알림 이메일을 보냅니다. 초대가 90일 후에 자동으로 삭제됩니다.

자동으로 추가되지 않은 멤버는 초대됨 탭에 표시됩니다. 이 탭에는 다음이 포함됩니다:

• 아직 초대를 수락하지 않은 사용자
• 관리자의 승인을 기다리는 사용자
• 그룹 사용자 한도를 초과하는 사용자.

그룹에서 멤버 삭제

필수 사항:

• 소유자 역할이 있어야 합니다.
• 멤버가 그룹에 직접 소속되어 있어야 합니다. 멤버십이 상위 그룹에서 상속된 경우 해당 멤버는 상위 그룹에서만 제거할 수 있습니다.

그룹에서 멤버를 제거하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 멤버를 선택합니다.
3. 제거하려는 멤버 옆에서 수직 타원 모양 ()을 선택합니다.
4. 멤버 제거를 선택합니다.
5. 선택 사항. 멤버 제거 확인 대화상자에서 다음 중 하나 이상을 선택합니다:
   • 하위 그룹 및 프로젝트의 직접 사용자 멤버십도 제거
   • 이 사용자를 연결된 이슈 및 Merge Request에서도 제거
6. 멤버 제거를 선택합니다.

GitLab 관리자는 또한 제거된 사용자가 스스로 다시 초대할 수 없도록 할 수 있습니다.

그룹에 프로젝트 추가

그룹에 새 프로젝트를 추가하는 방법은 두 가지입니다:

• 그룹을 선택한 후 새 프로젝트를 선택합니다. 그런 다음 프로젝트를 만들기 계속할 수 있습니다.

• 프로젝트를 만드는 동안 드롭다운 디렉터리에서 그룹을 선택합니다.

  

그룹에 프로젝트를 추가할 수 있는 사용자 지정

기본적으로 다음 역할을 최소한으로 가진 사용자는:

• 개발자 역할은 그룹 아래에 프로젝트를 만들 수 있습니다. 이 기본 설정은 변경할 수 있습니다.
• 유지자 역할은 그룹에 프로젝트를 복제할 수 있습니다. 이 기본 설정은, 보호된 브랜치를 포함하는 프로젝트를 개발자 역할이 포함된 사용자가 포크할 수 없게 합니다.

그룹 아래에 프로젝트를 만들 수 있는 역할을 변경하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 설정 > 일반을 선택합니다.
3. 권한 및 그룹 기능 섹션을 펼칩니다.
4. 프로젝트를 만들 수 있는 역할에서 옵션을 선택합니다.
5. 변경 사항 저장을 선택합니다.

이 설정을 전역적으로 변경하려면 기본 프로젝트 생성 보호를 참조하십시오.

그룹 ID 가져오기

• 그룹 ID는 GitLab 16.7에서 작업 메뉴로 이동되었습니다.

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

그룹 ID를 복사하려면:

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