그룹
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
GitLab에서는 그룹을 사용해 관련된 하나 이상의 프로젝트를 동시에 관리합니다. 그룹을 사용하면 모든 그룹 멤버와 소통하고 프로젝트의 권한을 관리할 수 있습니다. 그룹에 속한 프로젝트의 모든 이슈와 머지 리퀘스트, 그룹 활동에 대한 분석도 확인할 수 있습니다.
GitLab에서는 그룹을 사용해 관련된 하나 이상의 프로젝트를 동시에 관리합니다.
그룹을 사용하면 모든 그룹 멤버와 소통하고 프로젝트의 권한을 관리할 수 있습니다. 누군가에게 그룹에 대한 액세스 권한이 있으면 그룹의 모든 프로젝트에 대한 액세스 권한도 갖습니다.
그룹에 속한 프로젝트의 모든 이슈와 머지 리퀘스트, 그룹 활동에 대한 분석도 확인할 수 있습니다.
규모가 큰 조직이라면 하위 그룹도 만들 수 있습니다.
그룹을 만들고 관리하는 방법에 대한 자세한 내용은 그룹 관리를 참고합니다.
그룹 계층#
그룹은 트리 구조로 구성됩니다.
- 최상위 그룹은 조직의 "루트"에 만든 그룹입니다. 조직에는 최상위 그룹이 하나 이상 있을 수 있습니다. 최상위 그룹에는 하위 그룹이 하나 이상 포함될 수 있습니다.
- 상위 그룹은 하위 그룹을 하나 이상 포함하는 그룹입니다.
- 하위 그룹은 다른 그룹에 속한 그룹입니다.
예를 들어 다음 다이어그램의 구성은 다음과 같습니다.
- 조직에 그룹이 네 개 있습니다. 최상위 그룹 T 하나가 하위 그룹 G를 포함하고, 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
그룹 구조#
그룹을 설정하는 방법은 사용 사례, 팀 규모, 액세스 요구 사항에 따라 다릅니다. 다음 표는 그룹을 구성하는 가장 일반적인 모델을 설명합니다.
| 모델 | 구조 | 사용 사례 |
|---|---|---|
| 단순 | 모든 프로젝트를 하나의 그룹에 둡니다. | 원활한 협업과 리소스 액세스가 필요한 소규모 팀 또는 특정 솔루션(예: 마케팅 웹사이트) 작업. |
| 팀 | 팀 유형(예: 제품과 엔지니어링)에 따라 서로 다른 그룹 또는 하위 그룹을 둡니다. | 일부 팀이 자율적으로 일하거나, 중앙에서 관리하는 리소스가 필요하고 외부 팀원의 액세스를 제한해야 하는 대규모 조직 작업. |
| 클라이언트 | 클라이언트마다 하나의 그룹을 둡니다. | 서로 다른 리소스와 액세스 수준이 필요한 여러 클라이언트에 맞춤 솔루션 제공. |
| 기능 | 기능 유형(예: AI/ML)마다 하나의 그룹 또는 하위 그룹을 둡니다. | 특정 기능에 특정 리소스와 주제 전문가의 협업이 필요한 복잡한 제품 개발. |
GitLab Self-Managed에서 전체 조직의 개요를 보려면 최상위 그룹 하나를 만들어야 합니다. 모든 그룹을 아우르는 조직 뷰를 만들기 위한 작업에 대한 자세한 내용은 에픽 9266을 참고합니다. 최상위 그룹은 완전한 보안 대시보드 및 센터, 취약점 보고서, 컴플라이언스 센터, 가치 스트림 분석을 통해 전체 조직에 대한 인사이트를 제공합니다.
그룹 구조에 대한 권장 제한#
그룹에는 멤버십, 계층 깊이, 그룹 공유 수에 대해 강제되는 제한이 없습니다.
그러나 규모가 크거나 깊게 중첩된 구조는 성능을 떨어뜨릴 수 있습니다.
대시보드 로드가 느려지고, 권한 계산이 타임아웃되며, 일부 작업이 500 오류를 반환할 수 있습니다.
그룹의 응답성을 유지하려면 다음 권장 제한을 지킵니다.
| 구조 | 권장 제한 | 최대 제한 | 권장 제한을 넘어설 때 예상되는 증상 |
|---|---|---|---|
| 그룹당 멤버 수 | 1,000명 미만 | 없음 | 성능이 저하됩니다. 멤버가 1,500명 이상이면 작업이 타임아웃되거나 500 오류를 반환할 수 있습니다. |
| 상위 그룹당 하위 그룹 수 | 100개 미만 | 없음 | 탐색과 권한 계산이 느려집니다. |
| 계층 깊이 | 5단계 이하 | 20단계 | 데이터베이스 쿼리가 타임아웃될 수 있습니다. |
권장 제한은 최대 제한과 다릅니다. 최대 제한은 GitLab이 강제하는 기술적 상한입니다. 그룹이 권장 제한을 넘어서도 여전히 지원됩니다.
이러한 제한이 함께 겹칠 때 성능 문제가 가장 심각합니다. 예를 들어 깊은 중첩과 많은 하위 그룹을 동시에 가진 그룹은 두 조건 중 하나만 있을 때보다 데이터베이스 쿼리 타임아웃을 더 빨리 유발할 수 있습니다.
권장 제한은 현재의 성능 동작을 반영합니다. 규모가 크고 깊게 중첩된 구조에서 성능이 더 나은 구조로 이전하도록 돕기 위해 계획된 작업에 대한 자세한 내용은 에픽 21582를 참고합니다.
권장 제한 이내로 유지#
그룹이 권장 제한에 근접하거나 초과하는 경우 다음 해결 방법으로 성능 영향을 줄일 수 있습니다.
그룹 멤버십 규모가 큰 경우:
- 멤버가 1,000명을 넘는 그룹을 각각 500명 이하의 더 작은 기능별 그룹으로 분할합니다. 예를 들어 모든 엔지니어로 구성된 단일 그룹을 프론트엔드, 백엔드, 인프라 엔지니어별 그룹으로 나눕니다.
- 큰 그룹 하나를 공유하는 대신, 더 작은 각 그룹을 프로젝트와 그룹에 개별적으로 공유합니다.
- 멤버를 일괄 변경할 때는 그룹 멤버 API를 사용하고 요청 사이에 지연을 두어 멤버 관리 속도 제한을 넘지 않도록 합니다.
계층이 깊거나 넓은 경우:
- 계층은 5단계 이하로 유지합니다.
- 상속된 멤버십을 공유할 필요가 없는 조직 부문은 하나의 계층 아래에 모두 중첩하지 말고 별도의 최상위 그룹으로 둡니다.
- 하나의 상위 그룹 아래에 있는 직속 하위 그룹 수를 줄입니다.
그룹 공유의 경우:
- 개별 멤버 권한을 관리해야 할 때는 중첩된 그룹 공유를 거치지 말고 그룹을 프로젝트에 직접 추가합니다.
- 새 하위 그룹이 공유된 그룹의 권한을 상속하지 않으면, 공유에 지정된 권한을 다른 값으로 바꾼 다음 다시 되돌려 권한 재계산이 일어나도록 합니다.
- 일괄 작업이나 자동화처럼 그룹 공유 작업을 한 번에 많이 수행할 때는 전부 병렬로 실행하지 말고 하나씩 또는 제한된 동시성으로 실행합니다. 멤버십 규모가 큰 그룹에 동시 공유 작업이 많이 몰리면 데이터베이스 경합이 발생하고 인스턴스 응답성이 저하될 수 있습니다.
- 그룹 간(중첩) 공유로 부여된 액세스는 지연된 배치 업데이트로 적용되므로, 프로젝트에 직접 공유한 경우보다 전파에 더 오래 걸립니다.
ID 공급자에서 동기화한 대규모 계층의 경우:
- ID 공급자에서 속도 제한이 걸리지 않도록 LDAP 동기화 간격을 구성합니다. 동기화 중에 속도 제한 오류가 발생하면 사용자가 차단되거나 그룹 멤버십이 제거될 수 있습니다.
그룹 가시성#
프로젝트와 마찬가지로 그룹도 다음 대상에게 표시되도록 구성할 수 있습니다.
- 익명 사용자
- 인증된 모든 사용자
- 명시적으로 지정된 그룹 멤버만
애플리케이션 설정 수준의 가시성 수준 제한은 그룹에도 적용됩니다. internal로 설정하면 익명 사용자에게 탐색 페이지가 비어 있는 상태로 표시됩니다. 그룹 페이지에는 가시성 수준 아이콘이 있습니다.
사용자는 바로 위 상위 그룹보다 가시성 수준이 높은 하위 그룹이나 프로젝트를 만들 수 없습니다.
그룹 탐색#
모든 공개 그룹 또는 내부 그룹을 탐색하려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택합니다.
- 드롭다운에서 Explore를 선택합니다.
- 왼쪽 사이드바에서 Groups를 선택합니다.
멤버로 속한 그룹 보기#
히스토리
직접 멤버십 또는 간접 멤버십이 있는 그룹을 보려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택합니다.
- 드롭다운에서 View all my groups를 선택합니다.
이 페이지에는 다음을 통해 멤버로 속한 그룹이 표시됩니다.
- 하위 그룹의 상위 그룹 멤버십
- 그룹 또는 하위 그룹에 속한 프로젝트의 직접 멤버십 또는 상속된 멤버십
비활성 그룹 보기#
히스토리
그룹은 삭제 대기 중이거나 아카이브된 경우 비활성 상태입니다.
모든 비활성 그룹을 보려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택합니다.
- 드롭다운에서 다음 중 하나를 선택합니다.
- 멤버로 속한 그룹을 필터링하려면 View all my groups를 선택합니다.
- 공개 그룹 또는 내부 그룹을 필터링하려면 Explore를 선택합니다.
- Inactive 탭을 선택합니다.
목록의 각 비활성 그룹에는 그룹이 아카이브되었는지 삭제 대기 중인지 나타내는 배지가 표시됩니다.
그룹이 삭제 대기 중이면 목록에 다음도 표시됩니다.
- 그룹이 최종 삭제되도록 예약된 시간
- Restore 작업. 그룹을 복원하면 다음과 같이 동작합니다.
- Pending deletion 레이블이 제거됩니다. 그룹은 더 이상 삭제 예약 상태가 아닙니다.
- 그룹이 Inactive 탭에서 제거됩니다.
그룹 보기#
히스토리
- GitLab 17.5에서 그룹 ID로 그룹에 접근하는 기능 도입됨.
그룹 개요 페이지에는 그룹과 그룹의 멤버, 하위 그룹, 프로젝트에 대한 다음과 같은 정보가 표시됩니다.
- 그룹 설명
- 최근 활동
- 생성된 머지 리퀘스트와 이슈 수
- 추가된 멤버 수
- 하위 그룹과 프로젝트
- 공유된 프로젝트
- 아카이브된 프로젝트
그룹을 보려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
그룹의 하위 그룹과 프로젝트를 검색하고 오름차순 또는 내림차순으로 정렬할 수 있습니다.
이름 대신 ID를 사용해 https://gitlab.example.com/-/g/<id>에서 그룹에 접근할 수 있습니다.
예를 들어 example-group 그룹의 ID가 123456이면 https://gitlab.example.com/example-group 또는
https://gitlab.example.com/-/g/123456에서 그룹에 접근할 수 있습니다.
그룹 ID 찾기#
GitLab API로 그룹과 상호 작용하려면 그룹 ID가 필요할 수 있습니다.
그룹 ID를 찾으려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 그룹 개요 페이지의 오른쪽 상단 모서리에서 Actions(⋮)를 선택합니다.
- Copy Group ID를 선택합니다.
그룹 활동 보기#
그룹의 활동을 보려면 다음을 수행합니다.
-
상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
-
왼쪽 사이드바에서 Manage > Activity를 선택합니다.
-
선택 사항. 기여 유형별로 활동을 필터링하려면 탭을 선택합니다.
- All: 그룹과 그룹 프로젝트에서 그룹 멤버가 수행한 모든 기여입니다.
- Push events: 그룹 프로젝트의 푸시 이벤트입니다.
- Merge events: 그룹 프로젝트에서 수락된 머지 리퀘스트입니다.
- Issue events: 그룹 프로젝트에서 열리고 닫힌 이슈입니다.
- Comments: 그룹 프로젝트에서 그룹 멤버가 남긴 댓글입니다.
- Wiki: 그룹의 위키 페이지 업데이트입니다.
- Designs: 그룹 프로젝트에서 추가·업데이트·제거된 디자인입니다.
- Team: 그룹 프로젝트에 참여하고 떠난 그룹 멤버입니다.
그룹 만들기#
그룹을 만들려면 다음을 수행합니다.
- 오른쪽 상단 모서리에서 Create new(+)를 선택하고 New group을 선택합니다.
- Create group을 선택합니다.
- Group name 텍스트 박스에 그룹 이름을 입력합니다. 그룹 이름으로 사용할 수 없는 단어 목록은 예약된 이름을 참고합니다.
- Group URL 텍스트 박스에 네임스페이스에 사용할 그룹 경로를 입력합니다.
- 그룹의 Visibility level을 선택합니다.
- 선택 사항. GitLab 사용 환경을 개인화하려면 다음을 수행합니다.
- **Who will be using this group?**에서 옵션을 선택합니다.
- What will you use this group for? 드롭다운 목록에서 옵션을 선택합니다.
- 선택 사항. 그룹에 멤버를 초대하려면 Email 1 텍스트 박스에 초대할 사용자의 이메일 주소를 입력합니다. 사용자를 더 초대하려면 Invite another member를 선택하고 해당 사용자의 이메일 주소를 입력합니다.
- Create group을 선택합니다.
그룹에 대한 자세한 내용은 GitLab Namespaces (users, groups and subgroups)를 시청합니다.
그룹 이름, 설명, 아바타 편집#
그룹 일반 설정에서 그룹 세부 정보를 편집할 수 있습니다.
사전 요구 사항:
- 그룹에 대한 Owner 권한이 있어야 합니다.
그룹 세부 정보를 편집하려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- Group name 텍스트 박스에 그룹 이름을 입력합니다. 그룹 이름 제한 사항을 참고합니다.
- 선택 사항. Group description (optional) 텍스트 박스에 그룹 설명을 입력합니다. 설명은 500자로 제한됩니다.
- 선택 사항. Group avatar에서 Choose file을 선택한 다음 이미지를 선택합니다. 이미지 크기는 192 x 192 픽셀이 가장 적합하며, 허용되는 최대 파일 크기는 200 KB입니다.
- Save changes를 선택합니다.
그룹 떠나기#
그룹을 떠나면 다음과 같이 됩니다.
- 더 이상 그룹과 그 하위 그룹, 프로젝트의 멤버가 아니므로 기여할 수 없습니다.
- 본인에게 할당되어 있던 모든 이슈와 머지 리퀘스트의 할당이 해제됩니다.
그룹을 떠나려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 그룹 개요 페이지의 오른쪽 상단 모서리에서 Actions(⋮)를 선택합니다.
- Leave group을 선택한 다음 Leave group을 다시 선택합니다.
그룹 삭제 예약#
히스토리
- GitLab 18.0에서 GitLab Premium에서 GitLab Free로 이동됨.
기본적으로 그룹을 처음 삭제하면 그룹은 삭제 대기 상태가 됩니다. 그룹을 즉시 제거하려면 삭제를 한 번 더 수행합니다.
사전 요구 사항:
- 그룹에 대한 Owner 권한이 있어야 합니다.
- 그룹에 프로젝트가 있으면 소유자에게 프로젝트를 삭제할 수 있는 권한이 허용되어 있어야 합니다.
그룹과 그 콘텐츠를 삭제하려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 그룹 개요 페이지의 오른쪽 상단 모서리에서 Actions(⋮)를 선택합니다.
- Delete를 선택합니다.
- 확인 대화 상자에서 그룹 경로를 입력하고 Yes, delete group을 선택합니다.
그룹 대시보드에서도 그룹을 삭제할 수 있습니다.
- 상단 바에서 Search or go to > View all my groups를 선택합니다.
- 삭제할 그룹에서 (⋮)를 선택합니다.
- Delete를 선택합니다.
- 확인 대화 상자에서 그룹 경로를 입력하고 Yes, delete group을 선택합니다.
이 작업은 그룹 삭제를 예약하는 백그라운드 job을 추가합니다. GitLab.com에서는 30일 후에 그룹이 삭제됩니다. GitLab Self-Managed에서는 인스턴스 설정으로 보존 기간을 변경할 수 있습니다.
그룹이 삭제 예약 상태가 되면 예약된 CI/CD 파이프라인 실행이 중지됩니다.
그룹 삭제를 예약한 사용자가 삭제가 일어나기 전에 그룹에 대한 액세스 권한을 잃으면(예를 들어 그룹을 떠나거나, 권한이 하향되거나, 그룹에서 차단된 경우) 삭제 job은 그룹을 대신 복원하고, 그룹은 더 이상 삭제 예약 상태가 아닙니다.
그룹 삭제를 예약한 사용자가 job이 실행되기 전에 Owner 권한이나 관리자 액세스 권한을 다시 얻으면 job은 그룹을 영구적으로 제거합니다.
그룹 즉시 삭제#
히스토리
- GitLab 18.0에서 GitLab Premium에서 GitLab Free로 이동됨.
기다리지 않으려면 그룹을 즉시 삭제할 수 있습니다.
사전 요구 사항:
- 그룹에 대한 Owner 권한이 있어야 합니다.
- 그룹 삭제를 예약해 두어야 합니다.
삭제 예약된 그룹을 영구적으로 삭제하려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 그룹 개요 페이지의 오른쪽 상단 모서리에서 Actions(⋮)를 선택합니다.
- Delete permanently를 선택합니다.
- 확인 대화 상자에서 그룹 경로를 입력하고 Yes, delete group을 선택합니다.
이 작업은 그룹과 그 하위 그룹, 프로젝트, 그리고 이슈와 머지 리퀘스트를 포함한 모든 관련 리소스를 삭제합니다.
그룹 복원#
삭제 예약된 그룹을 복원하려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 그룹 개요 페이지의 오른쪽 상단 모서리에서 Actions(⋮)를 선택합니다.
- Restore를 선택합니다.
Actions 메뉴로 그룹 관리#
모든 그룹의 목록을 보고 Actions 메뉴로 그룹을 관리할 수 있습니다.
사전 요구 사항:
- 그룹 떠나기를 제외한 모든 작업에는 Owner 권한이 필요합니다.
그룹의 Actions 메뉴에 접근하려면 다음을 수행합니다.
- 상단 바에서 Search or go to > View all my groups를 선택합니다.
- Groups 페이지에서 그룹을 찾아 Actions 메뉴(⋮)를 선택합니다.
- 작업을 선택합니다.
그룹 상태에 따라 다음 작업을 사용할 수 있습니다.
| 그룹 상태 | 사용 가능한 작업 |
|---|---|
| 활성 | Edit, Archive, Transfer, Leave group, Delete |
| 아카이브됨 | Unarchive, Leave group, Delete |
| 삭제 대기 중 | Restore, Leave group |
그룹 액세스 요청#
관리자가 허용하면 사용자는 그룹의 멤버가 되기를 요청할 수 있습니다.
- 상단 바에서 Search or go to > View all my groups를 선택합니다.
- 오른쪽 상단에서 Explore groups를 선택합니다.
- Search 텍스트 박스에 가입하려는 그룹의 이름을 입력합니다.
- 검색 결과에서 그룹 이름을 선택합니다.
- 그룹 페이지의 그룹 이름 아래에서 Request access를 선택합니다.
가장 최근에 활동한 그룹 소유자 최대 10명이 요청 내용을 이메일로 받습니다. 그룹 소유자는 누구나 요청을 승인하거나 거절할 수 있습니다.
요청이 승인되기 전에 마음이 바뀌면 Withdraw access request를 선택합니다.
그룹 멤버 보기#
그룹의 멤버를 보려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Manage > Members를 선택합니다.
표에는 멤버의 다음 정보가 표시됩니다.
- Account 이름과 사용자 이름입니다.
- 멤버십의 Source입니다. 소스가 여러 개인 그룹 멤버는 Members 표에 두 번 표시되며 별개의 멤버로 계산됩니다. Owner나 Maintainer처럼 상위 권한을 가진 그룹 멤버는 하위 그룹과 프로젝트에서 더 제한적인 권한을 덮어씁니다. 예를 들어 Owner 권한을 가진 그룹 멤버는 하위 그룹이나 프로젝트에서 Developer 권한을 직접 할당받을 수 있습니다. 그러나 해당 멤버에게 Owner 권한도 할당되어 있으므로 Owner 범위의 권한을 갖습니다. 이슈 502458은 멤버의 소스에 가장 높은 유효 권한이 표시되도록 이 동작을 변경할 것을 제안합니다.
- 그룹에서의 Role입니다.
- 그룹 멤버십의 Expiration 날짜입니다.
- 계정과 관련된 Activity입니다.
네임스페이스의 모든 멤버와 각자가 점유한 시트를 보려면 최상위 네임스페이스에서 Usage quotas 페이지를 확인합니다.
그룹의 멤버 필터링 및 정렬#
그룹에서 멤버를 찾으려면 정렬, 필터링, 검색을 사용할 수 있습니다.
그룹 필터링#
그룹을 필터링해 멤버를 찾습니다. 기본적으로 그룹과 하위 그룹의 모든 멤버가 표시됩니다.
그룹 멤버 목록에서 각 항목에는 다음 배지가 표시될 수 있습니다.
- SAML: 해당 멤버에 연결된 SAML 계정이 있음을 나타냅니다.
- Enterprise: 최상위 그룹의 해당 멤버가 엔터프라이즈 사용자임을 나타냅니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Manage > Members를 선택합니다.
- 멤버 목록 위의 Filter members 텍스트 박스에 검색 조건을 입력합니다. 다음과 같이 확인합니다.
- 그룹의 직접 멤버를 보려면 Membership = Direct를 선택합니다.
- 그룹의 상속 멤버, 공유 멤버, 상속된 공유 멤버를 보려면 Membership = Indirect를 선택합니다.
- 2단계 인증이 활성화되거나 비활성화된 멤버를 보려면 2FA = Enabled 또는 2FA = Disabled를 선택합니다.
- 최상위 그룹의 엔터프라이즈 사용자를 보려면 Enterprise = true를 선택합니다.
그룹 검색#
이름, 사용자 이름 또는 공개 이메일로 멤버를 검색할 수 있습니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Manage > Members를 선택합니다.
- 멤버 목록 위의 Filter members 박스에 검색 조건을 입력합니다.
- Filter members 박스 오른쪽에서 돋보기 아이콘(🔍)을 선택합니다.
그룹의 멤버 정렬#
멤버는 Account, Access granted, Role 또는 Last sign-in 기준으로 정렬할 수 있습니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Manage > Members를 선택합니다.
- 멤버 목록 위 오른쪽 상단 모서리의 Account 목록에서 필터링할 기준을 선택합니다.
- 정렬을 오름차순과 내림차순 사이에서 전환하려면 Account 목록 오른쪽에서 화살표([sort-lowest] 또는 [sort-highest])를 선택합니다.
그룹에 사용자 추가#
히스토리
- GitLab 17.4에서 하위 그룹과 프로젝트의 직접 멤버에 대한 액세스 만료 날짜 제거됨.
그룹의 모든 프로젝트에 대한 액세스 권한을 사용자에게 부여할 수 있습니다.
사전 요구 사항:
- 그룹에 대한 Owner 권한이 있어야 합니다.
- GitLab Self-Managed 인스턴스의 경우:
- 새 사용자 계정 생성이 비활성화되어 있으면 관리자가 사용자를 추가해야 합니다.
- 사용자 초대가 허용되지 않으면 관리자가 사용자를 추가해야 합니다.
- 관리자 승인이 활성화되어 있으면 관리자가 초대를 승인해야 합니다.
-
상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
-
왼쪽 사이드바에서 Manage > Members를 선택합니다.
-
Invite members를 선택합니다.
-
사용자가 다음 중 어디에 해당하는지에 따라 입력합니다.
- GitLab 계정이 있으면 해당 사용자의 사용자 이름을 입력합니다.
- GitLab 계정이 없으면 해당 사용자의 이메일 주소를 입력합니다.
-
선택 사항. Access expiration date에 날짜를 입력하거나 선택합니다. 그 날짜부터 해당 사용자는 프로젝트에 더 이상 액세스할 수 없습니다.
액세스 만료 날짜를 입력하면 그룹 멤버는 액세스가 만료되기 7일 전에 이메일 알림을 받습니다.
[!warning] Maintainer는 권한이 만료될 때까지 모든 권한을 가지며, 자신의 액세스 만료 날짜를 연장할 수도 있습니다.
-
Invite를 선택합니다. 사용자를 초대한 방식에 따라 다음과 같이 동작합니다.
- GitLab 사용자 이름으로 초대하면 해당 사용자가 멤버 목록에 추가됩니다.
- 이메일 주소로 초대하면 해당 사용자가 이메일 초대를 받고 계정을 만들라는 안내를 받습니다. 초대가 수락되지 않으면 GitLab은 2일, 5일, 10일 후에 알림 이메일을 보냅니다. 수락되지 않은 초대는 90일 후에 자동으로 삭제됩니다.
자동으로 추가되지 않은 멤버는 Invited 탭에 표시됩니다. 이 탭에는 다음에 해당하는 사용자가 포함됩니다.
- 아직 초대를 수락하지 않은 사용자
- 관리자 승인을 기다리는 사용자
- 그룹 사용자 상한을 초과한 사용자
승격 대기 중인 사용자 보기#
권한 승격에 대한 관리자 승인이 켜져 있으면, 기존 사용자를 청구 대상 권한으로 승격하는 멤버십 요청에는 관리자 승인이 필요합니다.
승격 대기 중인 사용자를 보려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Manage > Members를 선택합니다.
- Role promotions 탭을 선택합니다.
Role promotions 탭이 표시되지 않으면 그룹에 대기 중인 승격이 없습니다.
그룹에서 멤버 제거#
사전 요구 사항:
- Owner 권한이 있어야 합니다.
- 해당 멤버가 그룹에 직접 멤버십을 가지고 있어야 합니다. 멤버십이 상위 그룹에서 상속된 경우에는 상위 그룹에서만 해당 멤버를 제거할 수 있습니다.
그룹에서 멤버를 제거하려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Manage > Members를 선택합니다.
- 제거할 멤버 옆에서 세로 줄임표(⋮)를 선택합니다.
- Remove member를 선택합니다.
- 선택 사항. Remove member 확인 대화 상자에서 체크박스 하나 또는 둘 다를 선택합니다.
- Also remove direct user membership from subgroups and projects
- Also unassign this user from linked issues and merge requests
- Remove member를 선택합니다.
GitLab 관리자는 제거된 사용자가 스스로 다시 초대하지 못하도록 할 수도 있습니다.
그룹에 프로젝트 추가#
다음 두 가지 방법으로 그룹에 새 프로젝트를 추가할 수 있습니다.
-
그룹을 선택한 다음 New project를 선택합니다. 이어서 프로젝트 만들기를 계속 진행할 수 있습니다.
-
프로젝트를 만드는 중에 드롭다운 목록에서 그룹을 선택합니다.

그룹에 프로젝트를 추가할 수 있는 대상 지정#
기본적으로 최소한 다음 권한을 가진 사용자는 다음과 같이 할 수 있습니다.
- Developer 권한이 있으면 그룹 아래에 프로젝트를 만들 수 있습니다. 이 기본값은 변경할 수 있습니다.
- Maintainer 권한이 있으면 그룹으로 프로젝트를 포크할 수 있습니다. 이 기본값은 Developer 권한을 가진 사용자가 보호된 브랜치가 포함된 프로젝트를 포크하지 못하게 하며, 변경할 수 없습니다.
그룹에서 어떤 권한으로 프로젝트를 만들 수 있는지 지정하려면 다음을 수행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- Permissions and group features 섹션을 확장합니다.
- Minimum role required to create projects에서 옵션을 선택합니다.
- Save changes를 선택합니다.
이 설정을 전역으로 변경하는 방법에 대한 자세한 내용은 프로젝트를 만들 수 있는 기본 최소 권한을 참고합니다.