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

그룹

GitLab에서 여러 관련 프로젝트를 동시에 관리하기 위해 그룹을 사용합니다.

그룹을 사용하여 모든 그룹 구성원과 소통하고 프로젝트의 권한을 관리할 수 있습니다. 그룹에 액세스 권한이 있는 경우 해당 그룹의 모든 프로젝트에 액세스할 수 있습니다.

또한 그룹의 활동에 대한 이슈 및 병합 요청 그리고 분석을 모두 볼 수 있습니다.

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

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

그룹 구조

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

참고: GitLab Self-Managed의 경우 조직 전체의 개요를 보려면 하나의 최상위 그룹을 만들어야 합니다. 모든 그룹에 대한 조직 전체의 개요에 대한 자세한 정보는 epic 9266를 참조하십시오. 단일 최상위 그룹은 완전한 보안 대시 보드 및 센터, 취약점 및 컴플라이언스 센터, 그리고 Value Stream Analytics를 통해 전체 조직에서의 통찰력을 제공합니다.

그룹 가시성

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

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

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

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

그룹 보기

가입한 모든 공개 그룹을 살펴보려면:

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

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

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

이 페이지는 다음을 통해 그룹의 구성원인 그룹을 보여줍니다:

• 하위 그룹의 부모 그룹의 멤버십.
• 그룹이나 하위 그룹의 프로젝트의 직접적 또는 상속받은 멤버십.

그룹 활동 보기

그룹의 활동을 보려면:

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

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

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

그룹 생성

그룹을 만들려면:

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

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

그룹 이름 및 설명 편집

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

필수 조건:

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

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

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 설정 > 일반을 선택합니다.
3. 그룹 이름 텍스트 상자에 그룹 이름을 입력합니다. 그룹 이름에 대한 제한 사항을 확인하세요.
4. 선택 사항입니다. 그룹 설명(선택 사항) 텍스트 상자에 그룹 설명을 입력합니다. 설명은 500자로 제한됩니다.
5. 변경 사항 저장을 선택합니다.

그룹 나가기

• GitLab 16.7에서 그룹을 나가는 버튼이 작업 메뉴로 이동되었습니다.

그룹을 나가면:

• 그룹과 그 하위 그룹 및 프로젝트의 구성원이 아니게 되며 기여할 수 없습니다.
• 할당된 모든 이슈와 병합 요청이 할당 해제됩니다.

그룹에서 나가려면:

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

그룹 삭제

• GitLab 16.0에서 GitLab.com에서 기본적으로 지연 삭제가 활성화되었으며 즉시 삭제 옵션이 제거되었습니다. 또한 Self-managed에서도 같은 작업이 이루어졌습니다.

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

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

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

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

GitLab 12.8 및 이후에서는 GitLab 프리미엄 및 얼티메이트에서 이 작업은 그룹을 삭제할 작업 배경 작업을 추가합니다. 기본적으로 작업은 미래에 7일 후에 삭제되도록 예약됩니다. 이 보존 기간을 인스턴스 설정을 통해 수정할 수 있습니다.

GitLab 13.6 및 이후에서는 삭제를 설정한 사용자가 삭제가 이루어지기 전에 그룹에서 제거된 경우 작업이 취소되어 그룹은 더 이상 삭제 예정이 아닙니다.

즉시 그룹 삭제

• GitLab 14.2에서 도입됨.
• GitLab 16.0에서 GitLab.com에서 기본적으로 지연 삭제가 활성화되었으며 즉시 삭제 옵션이 제거되었습니다. 또한 Self-managed에서도 같은 작업이 이루어졌습니다.

기다리기 원치 않으시면, 그룹을 즉시 삭제할 수 있습니다.

필수 조건:

• 그룹의 소유자 역할이어야 합니다.
• 그룹을 삭제로 표시했어야 합니다. (## 그룹 삭제 참조)

삭제로 표시된 그룹을 바로 삭제하려면:

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

이 작업은 그룹, 그 하위 그룹, 프로젝트 및 모든 관련 리소스, 즉 이슈 및 병합 요청을 삭제합니다.

그룹 복원

• GitLab 12.8에서 도입됨.

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

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

그룹에 액세스 요청

사용자로써, 관리자가 허용한다면 그룹의 멤버가 될 수 있도록 요청할 수 있습니다.

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

최근 활동이 가장 많은 그룹 소유자 최대 열 명은 귀하의 요청에 대한 이메일을 받습니다. 어떤 그룹 소유자든지 요청을 승인하거나 거절할 수 있습니다.

요청이 승인되기 전에 마음을 바꾸면 액세스 요청 취소를 선택합니다.

그룹 멤버 보기

그룹의 멤버를 보려면:

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

테이블에서 멤버의 다음 정보가 표시됩니다:

• 계정 이름과 사용자 이름
• 그들의 멤버십의 소스
• 그룹 내에서의 최대 역할
• 그룹 멤버십의 만료 날짜
• 그들의 계정에 대한 활동

참고: 그룹 멤버의 소스 표시가 일관되지 않을 수 있습니다. 더 많은 정보는 이슈 23020을 참조하십시오.

그룹 내 멤버 필터링 및 정렬

• GitLab 12.6에서 소개되었습니다.
• GitLab 13.7에서 개선되었습니다.
• GitLab 13.8에서 기능 플래그가 제거되었습니다.

그룹 내 멤버를 찾으려면 정렬, 필터링 또는 검색할 수 있습니다.

그룹 필터링

멤버를 찾기 위해 그룹을 필터링합니다. 기본적으로 그룹 및 하위 그룹의 모든 멤버가 표시됩니다.

그룹 멤버 목록에서 항목당 다음 배지가 표시될 수 있습니다:

• SAML 계정이 연결된 멤버를 나타내는 SAML
• 최상위 그룹의 멤버가 엔터프라이즈 사용자인 지를 나타내는 Enterprise

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

그룹 검색

이름, 사용자 이름 또는 공개 이메일로 멤버를 검색할 수 있습니다.

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 멤버를 선택합니다.
3. 멤버 목록 상단에서 멤버 필터링 상자에 검색 기준을 입력합니다.
4. 오른쪽에 있는 멤버 필터링 상자 옆에서 돋보기()를 선택합니다.

그룹 내 멤버 정렬

멤버를 계정, 액세스 승인, 최대 역할, 또는 마지막 로그인으로 정렬할 수 있습니다.

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 멤버를 선택합니다.
3. 멤버 목록 상단에서 우측 상단 모서리에 있는 계정 목록에서 필터링 기준을 선택합니다.
4. 오름차순 또는 내림차순으로 정렬을 전환하려면 계정 목록 오른쪽에 위치한 화살표( 또는 )를 선택합니다.

그룹에 사용자 추가

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

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

전제 조건:

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

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

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

   액세스 만료 날짜를 입력하면 그룹 멤버는 액세스 만료 7일 전에 이메일 알림을 받습니다.

   경고: 만약에 멤버에게 유지자 역할을 주고 액세스 만료 날짜를 입력하면 해당 멤버는 역할에 있을 때 모든 권한을 갖습니다. 이러한 권한은 멤버가 유지자 역할에 있는 동안 자신의 시간을 연장할 수 있는 능력을 포함합니다.

7. 초대를 선택합니다.
   • 사용자의 GitLab 사용자 이름으로 초대하면 사용자가 멤버 목록에 추가됩니다.
   • 이메일 주소로 초대하면 사용자가 이메일 초대를 받고 계정을 만들도록 안내를 받습니다. 초대가 수락되지 않으면 GitLab은 2일, 5일, 10일 후에 알림 이메일을 보냅니다. 초대가 90일 후에 자동으로 삭제됩니다.

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

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

그룹에서 멤버 제거하기

전제 조건:

• 소유자 역할이 있어야 합니다.
• 멤버는 그룹에 직접 멤버십이 있어야 합니다. 상위 그룹에서 상속 받은 멤버십인 경우 상위 그룹에서만 멤버를 제거할 수 있습니다.

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

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

GitLab 관리자는 또한 제거된 사용자가 스스로 다시 초대받지 못하도록 보장할 수 있습니다.

그룹에 프로젝트 추가하기

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

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

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

  

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

기본적으로 적어도 다음 역할을 가진 사용자들은 그룹 아래에 프로젝트를 만들 수 있습니다:

• 개발자 역할
• 해당 기본 설정은 변경할 수 있습니다.
• 메인테이너 역할을 가진 사용자들은 그룹에 프로젝트를 복제할 수 있습니다. 이 기본 설정은 보호된 브랜치를 포함하는 프로젝트를 복제할 수 없게 하며 변경할 수 없습니다.

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

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

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

그룹 ID 가져오기

• 그룹 ID가 이동되었습니다 GitLab 16.7의 작업 메뉴로.

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

그룹 ID를 복사하려면:

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