그룹

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

GitLab에서는 한 번에 하나 이상의 관련 프로젝트를 관리하기 위해 그룹을 사용합니다.

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

또한 그룹의 프로젝트에 대한 이슈 및 병합 요청, 그룹의 활동에 대한 분석을 볼 수도 있습니다.

대규모 조직을 위해 하위 그룹도 만들 수 있습니다.

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

그룹 구조

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

모델 구조 사용 사례
Simple 모든 프로젝트에 대한 하나의 그룹 소규모 팀이나 원활한 협업과 자원 액세스를 필요로 하는 특정 솔루션(예: 마케팅 웹사이트)에서 작업할 때, 또는
Team 서로 다른 팀을 위한 다른 그룹 또는 하위 그룹 일부 팀이 자율적으로 작업하거나 외부 팀 구성원의 제한된 액세스와 중앙 집중식 자원이 필요한 대규모 조직에서 작업할 때
Client 각각의 클라이언트를 위한 하나의 그룹 다양한 자원 및 액세스 수준을 필요로 하는 여러 클라이언트에 대한 맞춤형 솔루션을 제공할 때
Functionality 기능 유형(예: AI/ML)별 하나의 그룹 또는 하위 그룹 하나의 기능이 특정 자원 및 전문가들의 협업이 필요한 복잡한 제품을 개발할 때
note
Self-managed GitLab에서 조직 전반의 개요를 보려면 최상위 그룹을 만들어야 합니다. 모든 그룹에 대한 조직적인 개요에 대한 자세한 정보는 epic 9266을 참조하세요. 최상위 그룹은 완전한 보안 대시보드 및 센터, 취약점 보고서, 준수 센터 및 value stream analytics를 통해 조직 전체에 대한 통찰력을 제공합니다.

그룹 가시성

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

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

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

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

그룹 보기

회원으로서 속한 모든 공개 그룹을 탐색하려면:

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

직접적이거나 간접적인 회원관계가 있는 그룹을 볼 때:

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

이 페이지에는 다음에서 속한 그룹이 표시됩니다:

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

그룹 보기

그룹 개요 페이지는 그룹과 그룹의 구성원, 하위 그룹 및 프로젝트에 관한 정보를 표시합니다:

  • 그룹 설명
  • 최근 활동
  • 만들어진 병합 요청 및 이슈 수
  • 추가된 멤버 수
  • 하위 그룹 및 프로젝트
  • 공유 프로젝트
  • 보관된 프로젝트

그룹을 보려면:

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

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

그룹 활동 보기

그룹의 활동을 보려면:

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

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

    • 모두: 그룹 구성원의 모든 기여사항 및 그룹의 프로젝트.
    • Push 이벤트: 그룹의 프로젝트에서 푸시 이벤트.
    • 병합 이벤트: 그룹의 프로젝트에서 승인된 병합 요청.
    • 이슈 이벤트: 그룹의 프로젝트에서 열리거나 닫힌 이슈.
    • 댓글: 그룹 구성원이 프로젝트에 게시한 댓글.
    • 위키: 그룹의 위키 페이지 업데이트.
    • 디자인: 그룹의 프로젝트에 추가되거나 업데이트된 디자인.
    • 팀: 그룹 구성원이 프로젝트에 참여한 날짜 및 나간 날짜.

그룹 ID를 사용하여 그룹에 액세스하기

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

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

그룹 ID를 복사하려면:

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

그룹 생성

그룹을 생성하려면:

  1. 왼쪽 사이드바에서 맨 위에 새로 만들기 (더하기 기호)를 선택한 다음 새 그룹을 선택합니다.
  2. 그룹 생성을 선택합니다.
  3. 그룹 이름 텍스트 상자에 그룹의 이름을 입력합니다. 그룹 이름으로 사용할 수 없는 단어 목록은 예약된 이름을 참조하세요.
  4. 그룹 URL 텍스트 상자에 네임스페이스에 사용되는 그룹 경로를 입력합니다.
  5. 가시성 레벨을 선택합니다.
  6. (선택 사항) GitLab 경험을 개인화하려면:
    • 역할 드롭다운 목록에서 역할을 선택합니다.
    • 누가 이 그룹을 사용하게 되나요?에서 옵션을 선택합니다.
    • 이 그룹을 어떻게 사용하게 되나요? 드롭다운 목록에서 옵션을 선택합니다.
  7. (선택 사항) 그룹에 멤버를 초대하려면, 이메일 1 텍스트 상자에 초대하려는 사용자의 이메일 주소를 입력합니다. 더 많은 사용자를 초대하려면 다른 멤버 초대를 선택한 다음 사용자의 이메일 주소를 입력합니다.
  8. 그룹 생성을 선택합니다.

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

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

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

전제 조건:

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

그룹 세부정보 편집 방법:

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

그룹 탈퇴

  • 그룹 탈퇴 버튼이 이동되었으며, GitLab 16.7에서 액션 메뉴로 이동되었습니다.

그룹을 탈퇴하면:

  • 그룹의 구성원이 아니게 되며, 하위 그룹 및 프로젝트에 대한 참여 및 기여가 불가능합니다.
  • 본인에게 할당된 모든 이슈 및 병합 요청이 할당 해제됩니다.

그룹을 탈퇴하려면:

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

그룹 삭제

  • 기본적으로 지연된 삭제가 활성화되고, 즉시 삭제하는 옵션이 제거되었습니다. (GitLab.com 및 자체 관리형) - GitLab 16.0에서

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

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

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

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

프리미엄 및 얼티밋 버전의 GitLab에서 해당 작업은 그룹을 삭제할 작업을 예약하는 백그라운드 작업을 추가합니다. 기본적으로 작업은 미래 7일 후에 삭제를 예약합니다. 이 보존 기간은 인스턴스 설정을 통해 수정할 수 있습니다.

그 삭제 작업을 설정한 사용자가 삭제가 발생하기 전에 그룹에서 제거되면 그룹 삭제 작업이 취소됩니다.

삭제 대기 중인 그룹 보기

Tier: 프리미엄, 얼티밋 Offering: GitLab.com, 자체 관리형, GitLab 전용

그룹 내에서 삭제를 대기 중인 하위 그룹 목록을 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 하위 그룹 및 프로젝트를 선택합니다.

삭제 대기 중인 그룹은 삭제 대기 중으로 표시됩니다.

즉시 그룹 삭제

Tier: 프리미엄, 얼티밋 Offering: GitLab.com, 자체 관리형, GitLab 전용
  • 기본적으로 지연된 삭제가 활성화되고, 즉시 삭제하는 옵션이 제거되었습니다. (GitLab.com와 자체 관리형) - GitLab 16.0에서

만약 기다리기를 원하지 않는다면 그룹을 즉시 삭제할 수 있습니다.

전제 조건:

삭제 대기 중인 그룹을 즉시 삭제하려면:

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

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

그룹 복원

Tier: 프리미엄, 얼티밋 Offering: GitLab.com, 자체 관리형, GitLab 전용

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

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

그룹 액세스 요청

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

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

최근 활동이 많은 그룹 소유자 최대 10명은 귀하의 요청에 대한 이메일을 받게됩니다. 그룹 소유자는 요청을 승인하거나 거절할 수 있습니다.

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

그룹 구성원 보기

그룹의 구성원을 보려면:

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

테이블에는 구성원의 다음과 관련된 정보가 표시됩니다:

  • 계정 이름 및 사용자 이름.
  • 멤버십의 원본. 투명성을 위해 GitLab은 그룹 구성원의 모든 멤버십 원본을 표시합니다. 여러 멤버십 원본을 갖는 구성원은 별도의 구성원으로 표시되어 계산됩니다. 예를 들어, 구성원이 직접 추가된 경우와 상속을 통해 추가된 경우, 구성원은 다른 원본으로 표시되며, 그룹의 구성원 테이블에는 두 번 표시되어 각기 다른 멤버로 계산됩니다.
  • 그룹 내에서의 역할할당.
  • 구성원의 그룹 멤버십 만료 날짜.
  • 계정과 관련된 활동.

참고: 그룹 구성원의 원본 표시가 일관되지 않을 수 있습니다. 추가 정보는 이슈 23020을 참조하세요.

모든 네임스페이스 구성원 및 해당 차지된 좌석에 대한 정보를 보려면, 최상위 네임스페이스에서 사용량 할당 페이지를 확인하세요.

그룹 내 멤버 필터링 및 정렬

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

그룹 필터링

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

그룹 멤버 목록에서 항목은 다음과 같은 뱃지를 표시할 수 있습니다:

  • SAML: SAML 계정이 해당 멤버에 연결되어 있음을 나타내는 뱃지.
  • Enterprise: 상위 그룹의 멤버가 기업 사용자임을 나타내는 뱃지.
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 관리 > 멤버를 선택합니다.
  3. 멤버 목록 상단에 있는 멤버 필터 텍스트 상자에 검색 기준을 입력합니다. 다음을 보려면:
    • 그룹의 직접 멤버를 보려면 멤버십 = 직접을 선택합니다.
    • 상속된, 공유, 및 상속된 공유 그룹의 멤버를 보려면 멤버십 = 간접을 선택합니다.
    • 이중 인증이 활성화되거나 비활성화된 멤버를 보려면 2FA = 활성화 또는 2FA = 비활성화를 선택합니다.
    • 상위 그룹의 기업 사용자를 보려면 Enterprise = true를 선택합니다.

그룹 검색

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

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

그룹 내 멤버 정렬

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

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

그룹에 사용자 추가

  • GitLab 16.2에서 소개된 기간 만료 액세스 이메일 알림.
  • GitLab 17.4에서 삭제된 서브그룹 및 프로젝트의 직접 멤버의 액세스 만료 날짜.

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

전제 조건:

  • 그룹에 대한 소유자 역할이 있어야 합니다.
  • 가입 비허용 상태라면, 관리자가 우선적으로 이메일을 통해 사용자를 추가해야 합니다.
  • 승진 관리가 활성화된 경우, 관리자가 초대를 승인해야 합니다.
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 관리 > 멤버를 선택합니다.
  3. 멤버 초대를 선택합니다.
  4. 사용자가:
    • GitLab 계정이 있는 경우 사용자 이름을 입력합니다.
    • GitLab 계정이 없는 경우 사용자 이메일 주소를 입력합니다.
  5. 기본 역할 또는 사용자 정의 역할을 선택합니다.

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

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

    경고: 유지자는 역할 만료 전까지(자신의 액세스 만료 날짜를 포함하여) 모든 권한을 가지며, 자신의 액세스 만료 날짜를 연장할 수 있는 능력을 포함하여 모든 권한을 가지게 됩니다.

  7. 초대를 선택합니다. 사용자를 초대한 경우:

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

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

승급 대기 중인 사용자 보기

승급 관리가 활성화된 경우, 구독에서 요금이 청구될 사용자의 멤버십 요청을 관리자가 승인해야 합니다.

승급 대기 중인 사용자를 보려면:

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

역할 승급 탭이 표시되지 않으면, 그룹에 승급 대기 중인 사용자가 없습니다.

그룹에서 멤버 제거

전제 조건:

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

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

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

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

그룹에 프로젝트 추가하기

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

  • 그룹을 선택한 후 새 프로젝트를 선택합니다. 그런 다음 프로젝트를 생성할 수 있습니다.

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

    그룹 선택

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

기본적으로 다음 권한을 가진 사용자는:

  • 개발자 역할은 그룹 내에 프로젝트를 생성할 수 있습니다. 이 기본값을 변경할 수 있습니다.
  • 관리자 역할은 프로젝트를 그룹 내로 복제할 수 있습니다. 이 기본값은 개발자 역할을 가진 사용자가 보호된 브랜치를 포함하는 프로젝트를 복제하지 못하도록 막습니다.

그룹 내에서 프로젝트를 생성할 수 있는 역할을 변경하려면:

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

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