그룹 관리

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

note
자체 관리 GitLab에서 전체 조직에 대한 개요를 보려면 최상위 그룹을 하나 만들어야 합니다.

전체 그룹의 조직 뷰를 만들기 위한 노력에 대한 자세한 내용은
에픽 9266를 참조하세요.
최상위 그룹은 완전한
보안 대시보드 및 센터,
취약점 보고서,
준수 센터, 및
가치 흐름 분석을 통해 전체 조직에 대한 통찰력을 제공합니다.

그룹 README 추가

팀에 대한 정보를 제공하고 사용자를 초대하여 프로젝트에 기여하도록 README 파일을 추가할 수 있습니다.
README 파일은 그룹 개요 페이지에 표시됩니다. 모든 그룹 구성원이 README를 보고 편집할 수 있습니다.

필수 조건:

  • 그룹 설정에서 README를 생성하려면 그룹에 대한 소유자 역할을 가져야 합니다.

그룹 README를 추가하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 그룹 README 섹션에서 README 추가를 선택합니다. 이 작업은 README.md 파일을 포함하는 새 프로젝트 gitlab-profile을 생성합니다.
  4. README 생성을 위한 프롬프트에서 README 생성 및 추가를 선택합니다. 그러면 README 파일이 생성되는 웹 IDE로 리디렉션됩니다.
  5. 웹 IDE에서 README.md 파일을 편집하고 커밋합니다.

그룹 소유자 변경

그룹의 소유자를 변경할 수 있습니다. 각 그룹에는 항상 적어도 한 명의 소유자 역할을 가진 멤버가 있어야 합니다.

  • 관리자일 경우:
    1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
    2. 관리 > 멤버를 선택합니다.
    3. 다른 멤버에게 소유자 역할을 부여합니다.
    4. 페이지를 새로 고칩니다. 이제 원래 소유자에게서 소유자 역할을 제거할 수 있습니다.
  • 현재 그룹의 소유자로서:
    1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
    2. 관리 > 멤버를 선택합니다.
    3. 다른 멤버에게 소유자 역할을 부여합니다.
    4. 새 소유자가 로그인하여 당신에게서 소유자 역할을 제거합니다.

그룹 경로 변경

그룹의 경로(그룹 URL)를 변경하면 의도하지 않은 부작용이 발생할 수 있습니다.
진행하기 전에 프로젝트 및 API
의 리디렉션 동작을 읽어보세요.

다른 그룹이나 사용자가 청구할 수 있도록 경로를 변경하는 경우에도 그룹 이름을 변경해야 합니다.
두 이름과 경로는 고유해야 합니다.

원래 네임스페이스의 소유권을 유지하고 URL 리디렉션을 보호하려면 새 그룹을 생성하고 해당 그룹으로 프로젝트를 전송하세요.

그룹 경로(그룹 URL)를 변경하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 고급 섹션을 확장합니다.
  4. 그룹 URL 변경 아래에 새 이름을 입력합니다.
  5. 그룹 URL 변경을 선택합니다.
caution
프로젝트에 컨테이너 레지스트리 태그가 포함된 네임스페이스의 이름을 변경하는 것은 불가능합니다.
프로젝트를 이동할 수 없기 때문입니다.
caution
수천 개의 하위 그룹을 가진 그룹이 올바르게 처리되도록 하려면 테스트 환경에서 경로 변경을 테스트해야 합니다.
푸마 작업자 시간 초과를 임시로 증가시키는 것을 고려하세요.
이 시간 초과 위험을 완화하기 위한 솔루션에 대한 자세한 내용은 이슈 432065를 참조하세요.

그룹의 기본 브랜치 보호 변경

기본적으로 모든 그룹은 전역 수준에서 설정된 브랜치 보호를 상속받습니다.

특정 그룹에 대해 이 설정을 변경하려면 그룹 수준 기본 브랜치 보호를 참조하세요.

전역적으로 이 설정을 변경하려면 초기 기본 브랜치 보호를 참조하세요.

참고: GitLab Premium 또는 Ultimate의 경우, GitLab 관리자는 그룹 소유자가 기본 브랜치 보호를 업데이트하는 것을 비활성화할 수 있습니다.

초기 브랜치에 대한 사용자 정의 이름 사용

GitLab에서 새 프로젝트를 만들면 첫 번째 푸시와 함께 기본 브랜치가 생성됩니다. 그룹 소유자는 그룹의 필요에 맞게 초기 브랜치를 사용자 정의할 수 있습니다.

그룹 이동

그룹 전환은 같은 GitLab 인스턴스 내에서 한 장소에서 다른 장소로 그룹을 이동하는 것입니다. 다음을 수행할 수 있습니다:

  • 서브그룹을 새 상위 그룹으로 이동합니다.
  • 상위 그룹을 원하는 그룹으로 이동하여 서브그룹으로 변환합니다.
  • 서브그룹을 현재 그룹에서 이동하여 상위 그룹으로 변환합니다.

그룹을 다른 GitLab 인스턴스로 복사해야 하는 경우 직접 전송으로 그룹을 마이그레이션하세요.

그룹을 전송할 때 유의 사항:

  • 그룹의 상위를 변경하면 의도하지 않은 부작용이 발생할 수 있습니다. 저장소 경로 변경 시 발생하는 일을 참조하세요.
  • 소스 그룹과 대상 그룹 모두에 대해 소유자 역할이 있어야 합니다.
  • 로컬 저장소를 새 위치를 가리키도록 업데이트해야 합니다.
  • 즉각 상위 그룹의 가시성이 그룹의 현재 가시성보다 낮으면, 서브그룹 및 프로젝트의 가시성 수준이 새 상위 그룹의 가시성과 일치하도록 변경됩니다.
  • 명시적인 그룹 멤버십만 전송되며, 상속된 멤버십은 전송되지 않습니다. 그룹의 소유자가 상속된 멤버십만 가지고 있는 경우, 이는 그룹을 소유자 없이 남겨두게 됩니다. 이 경우 그룹을 전송하는 사용자가 그룹의 소유자가 됩니다.
  • 그룹이 최고 수준 그룹이고 이름 규칙을 따르는 npm 패키지가 그룹 내의 모든 프로젝트 또는 그 하위 그룹에 존재하면 전송이 실패합니다.
  • 보관된 프로젝트의 container_registry 이미지는 전송 전에 삭제해야 합니다. 자세한 내용은 문제 해결 섹션을 참조하세요.
  • 그룹 수준 엔드포인트(메이븐, NuGet, PyPI, 컴포저, 데비안)를 사용하는 기존 패키지는 그룹 수준 엔드포인트를 설정하는 패키지의 단계에 따라 업데이트해야 합니다.
  • 패키지가 인스턴스 수준 엔드포인트(Maven, npm, Conan)를 사용하는 경우 패키지 이름을 업데이트해야 하며, 그룹이 다른 상위 그룹으로 이동했습니다.
  • GitLab.com에서 구독이 있는 상위 그룹은 전송할 수 없습니다. 전송을 가능하게 하려면 먼저 상위 그룹의 구독을 제거해야 합니다. 그 후에 상위 그룹은 다른 상위 그룹의 서브그룹으로 전송될 수 있습니다.

그룹을 전송하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 고급 섹션을 확장합니다.
  4. 그룹 전송을 선택합니다.
  5. 드롭다운 메뉴에서 그룹 이름을 선택합니다.
  6. 그룹 전송을 선택합니다.

이메일 알림 비활성화

그룹과 해당 하위 그룹 및 프로젝트와 관련된 모든 이메일 알림을 비활성화할 수 있습니다.

이메일 알림을 비활성화하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾으세요.

  2. 설정 > 일반을 선택하세요.

  3. 권한 및 그룹 기능 섹션을 확장하세요.

  4. 이메일 알림 활성화 체크박스를 선택 해제하세요.

이메일 알림에서 diff 미리보기 비활성화

  • GitLab 15.6에서 diff_preview_in_email이라는 플래그와 함께 도입됨. 기본적으로 비활성화됨.
  • GitLab 17.1에서 GitLab.com, 자가 관리 및 GitLab Dedicated에서 diff_preview_in_email 플래그가 활성화됨.

기능 플래그는 이 기능의 가용성을 제어합니다.

자세한 정보는 역사 기록을 참조하세요.

병합 요청에서 코드에 코멘트를 작성하면, GitLab은 참여자에게 이메일 알림에서 diff의 몇 줄을 포함합니다.

일부 조직 정책에서는 이메일을 덜 안전한 시스템으로 간주하거나 이메일로 자신의 인프라를 제어하지 않을 수 있습니다. 이는 IP 또는 소스 코드에 대한 접근 제어에 위험을 초래할 수 있습니다.

전제 조건:

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

그룹의 모든 프로젝트에서 diff 미리보기를 비활성화하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾으세요.

  2. 설정 > 일반을 선택하세요.

  3. 권한 및 그룹 기능 섹션을 확장하세요.

  4. diff 미리보기 포함 선택 해제하세요.

  5. 변경 사항 저장을 선택하세요.

그룹 멘션 비활성화

사용자가 대화에 추가되거나 해당 사용자가 회원인 그룹을 멘션할 때 알림을 받지 않도록 할 수 있습니다.

멘션이 비활성화된 그룹은 자동 완성 드롭다운 목록에서 해당 방식으로 시각화됩니다.

이러한 시각적 신호는 많은 사용자가 있는 그룹에 특히 유용합니다.

그룹 멘션을 비활성화하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾으세요.

  2. 설정 > 일반을 선택하세요.

  3. 권한 및 그룹 기능 섹션을 확장하세요.

  4. 그룹 멘션이 비활성화됨을 선택하세요.

  5. 변경 사항 저장을 선택하세요.

구성원 CSV로 내보내기

Tier: Premium, Ultimate

Offering: GitLab.com, Self-managed, GitLab Dedicated

그룹 또는 하위 그룹의 구성원 목록을 CSV로 내보낼 수 있습니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹 또는 하위 그룹을 찾으세요.

  2. 관리 > 구성원을 선택하세요.

  3. CSV로 내보내기를 선택하세요.

  4. CSV 파일이 생성된 후, 요청한 사용자에게 이메일 첨부 파일로 전송됩니다.

출력은 직접 구성원과 조상 그룹에서 상속된 구성원 목록을 나열합니다.

선택한 그룹에서 최소 액세스(Minimal Access)가 있는 구성원의 경우, 그들의 최대 역할(Max Role)과 소스(Source)는 하위 그룹에서의 회원 자격에 따라 결정됩니다.

문제 390358에서는 그룹 구성원 CSV 내보내기 목록과 UI 구성원 목록이 일치하지 않는 논의가 추적되고 있습니다.

그룹에 대한 사용자 제한

  • GitLab 17.1에서 기능 플래그 saas_user_caps가 제거되면서 일반 사용 가능해졌습니다.

GitLab 자가 관리에 대한 사용자 제한에 대한 자세한 정보는 사용자 제한을 참조하세요.

청구할 수 있는 구성원 수가 사용자 제한에 도달하면, 그룹 소유자가 새로운 구성원의 승인을 요청해야 합니다.

사용자 제한 기능이 활성화된 그룹은 해당 그룹 및 하위 그룹에 대해 그룹 공유가 비활성화됩니다.

그룹에 대한 사용자 한도 지정

전제 조건:

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

사용자 한도를 지정하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 해당 그룹을 찾습니다.
    최상위 그룹에서만 한도를 설정할 수 있습니다.

  2. 설정 > 일반을 선택합니다.

  3. 권한 및 그룹 기능을 확장합니다.

  4. 좌석 제어에서 사용자 한도 설정 체크박스를 선택하고 필드에 사용자 수를 입력합니다.

  5. 변경 사항 저장을 선택합니다.

그룹에 이미 사용자 한도 값보다 더 많은 사용자가 있는 경우 사용자는 제거되지 않습니다. 그러나 승인이 없이는 더 이상 추가할 수 없습니다.

사용자 한도를 늘려도 대기 중인 구성원이 승인되지 않습니다.

그룹에 대한 사용자 한도 제거

사용자 한도를 제거할 수 있으므로 그룹에 추가할 수 있는 구성원 수에 제한이 없습니다.

전제 조건:

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

사용자 한도를 제거하려면:

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

  2. 설정 > 일반을 선택합니다.

  3. 권한 및 그룹 기능을 확장합니다.

  4. 좌석 제어에서 액세스 열기를 선택합니다.

  5. 변경 사항 저장을 선택합니다.

사용자 한도를 줄여도 대기 중인 구성원이 승인되지 않습니다.

대기 중인 구성원 승인

청구 가능한 사용자의 수가 사용자 한도에 도달하면 새로운 구성원은 대기 상태로 전환되며 승인되어야 합니다.

대기 중인 구성원은 청구 가능한 것으로 계산되지 않습니다. 구성원은 승인되고 더 이상 대기 상태가 아니게 된 후에만 청구 가능한 것으로 계산됩니다.

전제 조건:

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

사용자 한도를 초과하여 대기 중인 구성원을 승인하려면:

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

  2. 설정 > 사용량 할당량을 선택합니다.

  3. 좌석 탭에서 알림 아래 대기 중인 승인 보기를 선택합니다.

  4. 승인할 각 구성원에 대해 승인을 선택합니다.

알려진 문제

그룹, 하위 그룹 또는 프로젝트가 외부로 공유되는 경우 사용자 한도를 활성화할 수 없습니다. 그룹, 하위 그룹 또는 프로젝트가 외부로 공유되는 경우 이는 계층 내에서 공유되는 것이 아니라 계층 구조의 수준과 관계없이 공유됩니다.

그룹, 하위 그룹 또는 프로젝트가 외부로 공유될 때 사용자 한도가 적용되도록 하려면 최상위 네임스페이스에서만 그룹 공유를 제한하십시오. 최상위 네임스페이스 제한을 통해 동일한 네임스페이스에서 초대를 허용하고 외부 공유로부터 새로운 사용자(좌석) 추가를 방지합니다.

GitLab.com Ultimate에는 청구 가능한 사용자가 사용자 한도를 초과할 때 그룹에 게스트 사용자를 추가할 수 없는 알려진 문제가 있습니다. 예를 들어, 사용자 한도가 5이고, 3명의 개발자와 2명의 게스트가 있다고 가정해 보겠습니다. 개발자를 2명 더 추가한 후에는 청구 가능한 좌석을 소모하지 않는 게스트 사용자라도 더 이상 사용자를 추가할 수 없습니다.

그룹 파일 템플릿

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

그룹의 모든 프로젝트와 함께 사용할 수 있는 공통 파일 유형에 대한 템플릿 세트를 공유하려면 그룹 파일 템플릿을 사용합니다. 이는 인스턴스 템플릿 리포지토리와 유사합니다.
선택한 프로젝트는 해당 페이지에 문서화된 것과 동일한 명명 규칙을 따라야 합니다.

템플릿 소스로는 그룹 내의 프로젝트만 선택할 수 있습니다. 여기에는 그룹과 공유되는 프로젝트가 포함되지만, 하위 그룹이나 구성중인 그룹의 부모 그룹 내의 프로젝트는 제외됩니다.

이 기능은 하위 그룹과 즉각적인 부모 그룹 모두에 대해 구성할 수 있습니다. 하위 그룹의 프로젝트는 해당 하위 그룹 및 모든 즉각적인 부모 그룹의 템플릿에 접근할 수 있습니다.

문제 및 병합 요청에 대한 템플릿을 만드는 방법을 알아보려면 설명 템플릿을 참조하십시오.

그룹을 템플릿 소스로 설정함으로써 그룹 수준에서 프로젝트 템플릿을 정의할 수 있습니다. 자세한 내용은 그룹 수준 프로젝트 템플릿을 참조하세요.

그룹 파일 템플릿 활성화

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

그룹 파일 템플릿을 활성화하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Settings > General을 선택합니다.
  3. Templates 섹션을 확장합니다.
  4. 템플릿 저장소로 사용할 프로젝트를 선택합니다.
  5. Save changes를 선택합니다.

그룹 병합 체크 설정

Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
  • GitLab 15.9에서 도입됨 플래그 이름 support_group_level_merge_checks_setting으로. 기본적으로 비활성화되어 있습니다.
  • GitLab 16.9에서 일반 제공. 기능 플래그 support_group_level_merge_checks_setting이 제거되었습니다.

그룹 소유자는 최상위 그룹에 병합 요청 체크를 설정할 수 있으며, 이는 모든 하위 그룹 및 프로젝트에 적용됩니다.

설정이 하위 그룹이나 프로젝트에 상속되면, 상속된 하위 그룹이나 프로젝트에서 변경할 수 없습니다.

병합을 위한 성공적인 파이프라인 필요

그룹의 모든 하위 프로젝트가 병합 전에 완료되고 성공적인 파이프라인을 요구하도록 구성할 수 있습니다.

프로젝트 수준 설정도 참조하세요.

전제 조건:

  • 그룹의 소유자여야 합니다.

이 설정을 활성화하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Settings > General을 선택합니다.
  3. Merge requests를 확장합니다.
  4. Merge checks 아래에서 Pipelines must succeed를 선택합니다.
    이 설정은 파이프라인이 없을 경우 병합 요청이 병합되는 것을 방지합니다.
  5. Save changes를 선택합니다.

스킵된 파이프라인 후 병합 허용

스킵된 파이프라인으로 인해 병합 요청이 병합되지 않도록 방지할 수 있습니다.

프로젝트 수준 설정도 참조하세요.

전제 조건:

  • 그룹의 소유자여야 합니다.

이 동작을 변경하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Settings > General을 선택합니다.
  3. Merge requests를 확장합니다.
  4. Merge checks 아래에서:
    • Pipelines must succeed를 선택합니다.
    • Skipped pipelines are considered successful를 선택합니다.
  5. Save changes를 선택합니다.

모든 스레드가 해결될 때까지 병합 방지

모든 스레드가 해결될 때까지 병합 요청이 병합되지 않도록 설정할 수 있습니다. 이 설정이 활성화되면 그룹의 하위 프로젝트는 해결되지 않은 스레드가 하나 이상 있는 병합 요청에서 주황색으로 해결되지 않은 스레드 수를 표시합니다.

전제 조건:

  • 그룹의 소유자여야 합니다.

이 설정을 활성화하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Settings > General을 선택합니다.
  3. Merge requests를 확장합니다.
  4. Merge checks 아래에서 All threads must be resolved를 선택합니다.
  5. Save changes를 선택합니다.

그룹 병합 요청 승인 설정

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

그룹 승인 설정은 모든 프로젝트의 프로젝트 병합 요청 승인 설정을 관리합니다.

이 설정은 그룹에 속한 모든 프로젝트에 전파됩니다.

그룹의 병합 요청 승인 설정을 보려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Settings > General을 선택합니다.
  3. Merge request approvals 섹션을 확장합니다.
  4. 원하는 설정을 선택합니다.
  5. Save changes를 선택합니다.

승인 설정은 승인 규칙과 혼동해서는 안 됩니다. 그룹에 대한 병합 요청 승인 규칙 설정을 지원하는 것은 에픽 4367에서 추적됩니다.

그룹 활동 분석

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

그룹의 경우, 지난 90일 동안 생성된 병합 요청, 이슈 및 회원 수를 확인할 수 있습니다.

group wikis에 대한 변경 사항은 그룹 활동 분석에 나타나지 않습니다.

그룹 활동 보기

브라우저나 RSS 피드에서 그룹에서 수행된 가장 최근의 작업을 볼 수 있습니다:

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

Atom 형식으로 활동 피드를 보려면
RSS ( ) 아이콘을 선택합니다.