그룹 관리

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

note
Self-managed 고객의 경우 하나의 최상위 그룹을 생성하여 전체 조직의 개요를 볼 수 있는 것이 유익할 수 있습니다. 모든 그룹에 대한 조직 뷰를 만드는 노력에 대한 자세한 정보는 에픽 9266을 참조하십시오. 단일 최상위 그룹을 통해 보안 대시보드 및 센터, 취약점와 컴플라이언스 센터, 그리고 가치 스트림 분석을 통해 전체 조직의 통찰력을 제공합니다.

그룹 README 추가

그룹 소유자 또는 구성원으로서 README를 사용하여 팀에 대한 자세한 정보를 제공하고 사용자들을 프로젝트에 기여하도록 초대할 수 있습니다. README는 그룹 개요 페이지에 표시되며, 그룹 설정에서 변경할 수 있습니다. 모든 그룹 구성원이 README를 편집할 수 있습니다.

전제 조건:

  • 그룹 설정에서 README를 생성하려면 그룹의 소유자 역할이 있어야 합니다.

그룹 README를 추가하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 그룹 README 섹션에서 README 추가를 선택합니다. 이 작업은 README.md 파일을 포함하는 새 프로젝트 gitlab-profile을 만듭니다.
  4. README를 만들라는 프롬프트에서 README 만들고 추가를 선택합니다. 이동하면 웹 IDE로 이동하여 README 파일이 생성됩니다.
  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
수천 개의 하위 그룹이 있는 그룹의 경우 경로 변경을 테스트하는 것이 좋습니다. 일시적으로 Puma 워커 타임아웃을 늘리는 것을 고려하십시오. 이 타임아웃 리스크를 완화하기 위한 솔루션에 대한 자세한 내용은 이슈 432065을 참조하십시오.

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

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

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

전역 수준에서이 설정을 변경하려면 초기 기본 브랜치 보호를 참조하십시오.

note
GitLab Premium 또는 Ultimate에서 GitLab 관리자는 기본 브랜치 보호 업데이트 방지를 선택할 수 있습니다.

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

GitLab에서 새 프로젝트를 만들 때 첫 번째 푸시로 기본 브랜치가 생성됩니다. 그룹 소유자는 그룹의 프로젝트에 대해 초기 브랜치 이름 사용자 정의 할 수 있습니다.

다른 그룹과 그룹 공유

프로젝트를 다른 그룹과 공유하는 방법과 유사하게 그룹을 다른 그룹에 초대하여 공유할 수 있습니다. 공유 조건 및 동작에 대한 자세한 정보는 프로젝트 및 그룹 공유를 참조하십시오.

전제 조건:

  • 초대된 그룹 및 초대하는 그룹의 구성원이어야 합니다.

그룹을 그룹에 초대하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 관리 > 구성원을 선택합니다.
  3. 그룹 초대를 선택합니다.
  4. 초대할 그룹 선택 디렉터리에서 초대하려는 그룹을 선택합니다.
  5. 최대 액세스 수준으로 역할을 선택합니다.
  6. 초대를 선택합니다.

초대된 그룹 제거

초대된 그룹을 제거하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 관리 > 멤버를 선택합니다.
  3. 그룹 탭을 선택합니다.
  4. 제거하려는 계정 옆에서 그룹 제거를 선택합니다 ().

그룹에서 초대된 그룹을 제거하면:

  • 초대된 그룹의 직접 멤버는 더 이상 초대받은 그룹에 액세스할 수 없습니다.
  • 초대된 그룹의 멤버는 더 이상 초대받은 그룹의 과금 대상 멤버로 계산되지 않습니다.

그룹 이전

그룹을 이전하면 동일한 GitLab 인스턴스의 다른 위치로 이동됩니다. 다음을 수행할 수 있습니다:

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

다른 GitLab 인스턴스로 그룹을 복사해야 하는 경우, 직접 전송을 통해 그룹 이전합니다.

그룹을 이전할 때 주의해야 할 사항:

  • 그룹의 상위 항목을 변경하면 의도치 않은 부작용이 발생할 수 있습니다. 리포지터리 경로가 변경될 때의 영향을 참조하십시오.
  • 소스 및 대상 그룹에서 소유자 역할이 있어야 합니다.
  • 로컬 리포지터리를 새 위치를 가리키도록 업데이트해야 합니다.
  • 즉시 상위 그룹의 가시성이 현재 그룹의 가시성보다 낮으면 서브그룹 및 프로젝트의 가시성 수준이 새 상위 그룹의 가시성에 맞게 변경됩니다.
  • 명시적 그룹 멤버십만 전송되며, 상속된 멤버십은 전송되지 않습니다. 그룹 소유자가 상속된 멤버십만 있는 경우 이로 인해 그룹에 소유자가 없게 됩니다. 이 경우 그룹을 이전하는 사용자가 그룹의 소유자가 됩니다.
  • npm 패키지가 그룹의 프로젝트 중 하나에 존재하거나 서브그룹 중 하나에 있다면 전송이 실패합니다.
  • 기존 패키지를 사용하는 경우 그룹 수준 엔드포인트(Maven, NuGet, PyPI, Composer, 및 Debian)가 패키지의 단계에 따라 업데이트되어야 합니다.
  • 패키지가 인스턴스 수준 엔드포인트를 사용하는 경우 패키지 이름을 새로고쳐야 합니다 (Maven, npm, Conan), 그리고 그룹이 다른 루트 수준 네임스페이스로 이동된 경우.
  • Maven 패키지는 그룹 전송 후 그룹 수준 엔드포인트에서 해당 패키지를 설치하거나 게시하는 것을 방지하는 네이밍 규칙을 따릅니다.
  • GitLab.com에서 구독하는 최상위 그룹을 이전할 수 없습니다. 이전을 가능하게 하려면 최상위 그룹의 구독을 먼저 제거해야 합니다. 그런 다음 최상위 그룹을 다른 최상위 그룹의 서브그룹으로 이전할 수 있습니다.

그룹을 이전하려면:

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

이메일 알림 비활성화

그룹과 관련된 모든 이메일 알림을 비활성화할 수 있습니다. 이는 해당 그룹의 서브그룹 및 프로젝트를 포함합니다.

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 권한 및 그룹 기능 섹션을 확장합니다.
  4. 이메일 알림이 비활성화됨을 선택합니다.
  5. 변경 사항 저장을 선택합니다.

그룹 멘션 비활성화

특정 사용자가 멤버인 그룹이 언급될 때 해당 사용자를 대화에 추가하고 알림을 받는 것을 방지할 수 있습니다. 그룹 멸션을 비활성화하면 자동완성 드롭다운 디렉터리에서 해당 그룹이 적절하게 표시됩니다.

이는 사용자 수가 많은 그룹에 특히 유용합니다.

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 권한 및 그룹 기능 섹션을 확장합니다.
  4. 그룹 멘션 비활성화됨을 선택합니다.
  5. 변경 사항 저장을 선택합니다.

멤버를 CSV로 내보내기

Tier: Premium, Ultimate Offering: GitLab.com, 자체관리, GitLab Dedicated

그룹 또는 서브그룹의 멤버 디렉터리을 CSV로 내보낼 수 있습니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹이나 서브그룹을 찾습니다.
  2. 관리 > 멤버를 선택합니다.
  3. CSV로 내보내기를 선택합니다.
  4. CSV 파일이 생성되면 요청한 사용자에게 첨부 파일로 이메일로 보내집니다.

결과에는 해당 그룹에서 직접적으로 멤버이거나 조상 그룹에서 상속된 멤버인 디렉터리이 포함됩니다. 이슈 390358에서는 그룹 멤버 CSV 내보내기 디렉터리이 UI 멤버 디렉터리과 일치하지 않는 논의를 추적합니다.

그룹의 사용자 제한

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

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

템플릿 소스로써 그룹 내 프로젝트만 선택할 수 있습니다. 이는 그룹과 공유된 프로젝트에 포함되지만, 상위 그룹 또는 서브그룹 내의 프로젝트는 제외됩니다.

이 기능을 그룹 및 즉시 상위 그룹에 대해 구성할 수 있습니다. 서브그룹 내의 프로젝트는 해당 서브그룹과 즉시 상위 그룹에 대한 템플릿에 액세스합니다.

이슈 및 Merge Request을 위한 템플릿을 생성하는 방법은 설명 템플릿을 참조하십시오.

그룹을 템플릿 소스로 설정함으로써 그룹 수준에서 프로젝트 템플릿을 정의하려면 더 많은 정보를 보려면 그룹 수준 프로젝트 템플릿을 참조하십시오.

그룹 파일 템플릿 활성화

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

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 템플릿 섹션을 확장합니다.
  4. 템플릿 리포지터리로 작동할 프로젝트를 선택합니다.
  5. 변경 사항 저장을 선택합니다.

그룹 Merge 확인 설정

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이 제거되었습니다.

그룹 소유자는 모든 서브그룹 및 프로젝트에 적용되는 Merge Request 확인을 설정할 수 있습니다.

설정이 서브그룹 또는 프로젝트에 상속되는 경우에는 해당 서브그룹이나 프로젝트에서 변경할 수 없습니다.

Merge을 위한 성공한 파이프라인 필요

그룹 내 모든 자식 프로젝트를 구성하여 Merge하기 전에 완료된 성공한 파이프라인을 필요로 하는 설정을 할 수 있습니다.

또한 프로젝트 수준 설정을 참조하십시오.

전제 조건:

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

이 설정을 활성화하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. Merge Request을 확장합니다.
  4. Merge 확인 아래에서 파이프라인은 반드시 성공을 선택합니다. 이 설정은 파이프라인이 없을 경우 Merge Request을 방지합니다.
  5. 변경 사항 저장을 선택합니다.

건너뛴 파이프라인 후 Merge 허용

건너뛴 파이프라인으로 인해 Merge Request이 Merge되지 못하게 하는 것을 구성할 수 있습니다.

또한 프로젝트 수준 설정을 참조하십시오.

전제 조건:

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

이 동작을 변경하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. Merge Request을 확장합니다.
  4. Merge 확인 아래:
    • 파이프라인은 반드시 성공을 선택합니다.
    • 건너뛴 파이프라인은 성공으로 간주를 선택합니다.
  5. 변경 사항 저장을 선택합니다.

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

모든 스레드가 해결될 때까지 Merge Request을 방지할 수 있습니다. 이 설정이 활성화되면, 귀하의 그룹에 속한 모든 하위 프로젝트에 대해 Merge Request의 미해결 스레드 수가 하나 이상의 미해결 스레드가 남아있는 경우 주황색으로 표시됩니다.

필수 조건:

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

이 설정을 활성화하려면:

  1. 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. Merge Request을 확장합니다.
  4. Merge 확인 아래 모든 스레드가 해결되어야 함을 선택합니다.
  5. 변경 사항 저장을 선택합니다.

그룹 Merge Request 승인 설정

Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
  • GitLab 13.9에 도입되었습니다. 그룹 Merge Request 승인 설정 피처 플래그에 의해 배포되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 14.5에 기본적으로 활성화되었습니다.
  • GitLab 14.9에서 피처 플래그 group_merge_request_approval_settings_feature_flag가 제거되었습니다.

그룹 승인 설정은 최상위 그룹에 속한 모든 프로젝트에 대한 프로젝트 Merge Request 승인 설정을 관리합니다. 이러한 설정은 그룹에 속한 모든 프로젝트에 연이어 적용됩니다.

그룹의 Merge Request 승인 설정을 보려면:

  1. 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. Merge Request 승인 섹션을 확장합니다.
  4. 원하는 설정을 선택합니다.
  5. 변경 사항 저장을 선택합니다.

승인 설정은 승인 규칙과 혼동해서는 안됩니다. 그룹에 대한 Merge Request 승인 규칙 설정 지원은 에픽 4367에서 추적됩니다.

실험 및 베타 기능 활성화

Tier: Premium, Ultimate Offering: GitLab.com
caution
실험 및 베타 기능은 예상치 못한 결과(예: 결과가 저품질, 불완전, 불일치, 무례하거나 민감하며, 보안 코드나 실패한 파이프라인을 포함할 수 있음)를 발생시킬 수 있습니다.
note
GitLab Duo Chat은 Premium 티어에서만 사용할 수 있는 기능입니다.

최상위 그룹의 모든 사용자에게 실험 및 베타 기능에 액세스할 수 있습니다. 이 설정은 그룹에 속한 모든 프로젝트에 연이어 적용됩니다.

최상위 그룹에서 실험 기능을 활성화하려면:

  1. 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 권한 및 그룹 기능을 확장합니다.
  4. 실험 및 베타 기능 아래 실험 및 베타 기능 사용 확인란을 선택합니다.
  5. 변경 사항 저장을 선택합니다.

그룹 활동 분석

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

그룹에서는 최근 90일 동안 생성된 Merge Request, 이슈, 및 멤버 수를 확인할 수 있습니다.

이 그룹 활동 분석은 group_activity_analytics 피처 플래그로 활성화할 수 있습니다.

최근 그룹 활동

그룹 위키의 변경 사항은 그룹 활동 분석에 표시되지 않습니다.

그룹 활동 보기

그룹에서 최신 작업들을 브라우저 또는 RSS 피드에서 확인할 수 있습니다:

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

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