그룹 관리

하나 이상의 관련 프로젝트를 동시에 관리하려면 그룹을 사용하십시오.

참고: 자체 관리형 GitLab에서 전체 조직의 개요를 보려면 최상위 그룹을 만들어야 합니다. 모든 그룹에 대한 조직 뷰를 만드는 노력에 대한 자세한 정보는 에픽 9266을 참조하십시오. 최상위 그룹은 완전한 보안 대시보드 및 센터, 취약점 보고서, 컴플라이언스 센터 및 가치 스트림 분석을 통해 조직 전체에 대한 통찰력을 제공합니다.

그룹 README 추가

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

전제 조건:

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

그룹 README 추가 방법:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 그룹 README 섹션에서 README 추가를 선택합니다. 이 작업은 gitlab-profile이라는 새 프로젝트를 만들어 README.md 파일이 들어 있습니다.
  4. README를 만들기 위해 만들고 README 추가를 선택합니다. README 파일이 만들어진 Web IDE로 리디렉션됩니다.
  5. Web IDE에서 README.md 파일을 편집 및 커밋합니다.

그룹의 소유자 변경

그룹의 소유자를 변경할 수 있습니다. 각 그룹은 항상 최소한 하나의 소유자 역할을 가진 구성원이 있어야 합니다.

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

그룹의 경로 변경

그룹의 경로(그룹 URL)를 변경하면 의도치 않은 부작용이 발생할 수 있습니다. 리디렉트 동작에 대해 프로젝트 및 API에서 어떻게 작동하는지 읽은 후 진행하십시오.

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

원래 네임스페이스의 소유권을 유지하고 URL 리디렉트를 보호하려면 프로젝트를 새로 만들고 대신 그룹으로 프로젝트를 전송하십시오.

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 고급 섹션을 확장합니다.
  4. 그룹 URL 변경 아래에 새 이름을 입력합니다.
  5. 그룹 URL 변경을 선택합니다.

경고: 컨테이너 레지스트리 태그가 있는 프로젝트가 포함되어 있는 경우 네임스페이스의 이름을 바꿀 수 없습니다. 왜냐하면 프로젝트를 이동할 수 없기 때문입니다.

경고: 수천 개의 하위 그룹을 가진 그룹이 올바르게 처리되도록 하려면 경로 변경을 테스트 환경에서 테스트해야 합니다. 일시적으로 Puma 워커 시간 제한을 늘리는 것을 고려하십시오. 이 시간 제한 리스크를 완화하기 위한 저희의 솔루션에 대해 더 많은 정보는 이슈 432065에서 확인하십시오.

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

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

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

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

참고: GitLab 프리미엄 또는 얼티메이트에서 GitLab 관리자는 그룹 소유자가 기본 브랜치 보호를 업데이트하지 못하도록 설정하는 것을 선택할 수 있습니다.

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

GitLab에서 새 프로젝트를 생성하면 첫 번째 푸시와 함께 기본 브랜치가 생성됩니다. 그룹 소유자는 그룹의 프로젝트를 위한 초기 브랜치 이름을 사용자 정의 하여 그룹의 요구에 맞는 프로젝트를 만날 수 있습니다.

그룹 전송

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

  • 하위 그룹을 새 상위 그룹에 전송합니다.
  • 원하는 그룹으로 이동하여 최상위 그룹을 하위 그룹으로 변환합니다.
  • 현재 그룹에서 나가면서 하위 그룹을 최상위 그룹으로 변환합니다.

다른 GitLab 인스턴스로 그룹을 복사해야 하는 경우 직접 전송에 의한 그룹 이전을 수행하십시오.

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

  • 그룹의 부모를 변경하면 의도치 않은 부작용이 발생할 수 있습니다. 저장소 경로가 변경될 때 발생하는 일을 참조하십시오.
  • 소스 및 대상 그룹의 소유자 역할이 있어야 합니다.
  • 로컬 저장소를 새 위치를 가리키도록 업데이트해야 합니다.
  • 즉시 부모 그룹의 가시성이 그룹의 현재 가시성보다 낮은 경우 하위 그룹 및 프로젝트의 가시성 수준이 새 부모 그룹의 가시성과 일치하도록 변경됩니다.
  • 명시적인 그룹 멤버십만 전송되며 상속된 멤버십은 전달되지 않습니다. 그룹의 소유자가 상속된 멤버십만 가지고 있는 경우 이는 그룹에 소유자가 없이 남겨집니다. 이 경우 그룹을 전송한 사용자가 그룹의 소유자가 됩니다.
  • npm 패키지가 프로젝트의 어느 곳이나 하위 그룹에서 이름 규칙을 따르는 경우 전송이 실패합니다.
  • 전송하기 전에 보관된 프로젝트에서 container_registry 이미지를 삭제해야 합니다. 자세한 내용은 문제 해결 섹션을 참조하십시오.
  • 기존 패키지 이름을 사용하여 pkg 레벨 엔드포인트(Maven, NuGet, PyPI, Composer 및 Debian)가 존재하는 경우 그룹이 다른 최상위 그룹으로 이동한 경우에는 기존 패키지 이름을 업데이트해야 합니다.
  • 최상위 그룹이 GitLab.com에서 구독을 받는 경우 그룹을 전송할 수 없습니다. 전송이 가능하게 하려면 최상위 그룹의 구독을 먼저 제거해야 합니다. 그런 다음 최상위 그룹을 다른 최상위 그룹으로 하위 그룹으로 전송할 수 있습니다.

그룹을 전송하려면:

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

이메일 알림 비활성화

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

이메일 알림 비활성화 방법:

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

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

플래그: 이 기능의 가용성은 피처 플래그에 의해 제어됩니다. 자세한 정보는 히스토리를 참조하십시오.

병합 요청에 코드에 의견을 남길 때, GitLab은 참가자에 대한 이메일 알림에 차이의 몇 줄을 포함합니다. 일부 조직 정책은 이메일을 보안이 적은 시스템으로 다루거나, 이메일에 대한 자체 인프라를 제어하지 않을 수 있습니다. 이는 지적 재산권 또는 소스 코드의 액세스 제어에 위험을 초래할 수 있습니다.

필수 구성 요소:

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

그룹의 모든 프로젝트에 대해 차이 미리보기를 비활성화하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 권한 및 그룹 기능 섹션을 확장합니다.
  4. 차이 미리보기 포함을 해제합니다.
  5. 변경 사항 저장을 선택합니다.

그룹 언급 비활성화

누군가가 언급한 경우 대화에 추가되는 것과 알림을받는 것을 방지할 수 있습니다. 언급하는 그룹가 속한 사용자의 경우에는 그룹으로 시각화됩니다.

이 시각적인 신호는 많은 사용자가 있는 그룹에 특히 도움이 됩니다.

그룹 언급을 비활성화하려면:

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

회원을 CSV로 내보내기

Tier: 프리미엄, 얼티메이트 Offering: GitLab.com, 온프레미스, GitLab Dedicated

그룹 또는 하위 그룹의 회원 목록을 CSV 형식으로 내보낼 수 있습니다.

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

출력에서는 선택한 그룹의 직접 회원 및 상속된 회원이 목록화됩니다. 선택한 그룹에서 최소 액세스를 가진 회원의 경우, 최대 역할 및 출처가 하위 그룹의 회원 자격에 따라 파생됩니다. 그룹 회원 CSV 내보내기 목록이 UI 회원 목록과 일치하지 않는 문제는 이슈 390358에서 토론되고 있습니다.

그룹의 사용자 제한

GitLab Self-Managed의 사용자 제한에 대한 자세한 내용은 사용자 제한을 참조하십시오.

과금 가능 회원 수가 사용자 제한에 도달하면, 그룹 소유자의 승인이 필요합니다.

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

그룹에 사용자 제한 지정

필수 구성 요소:

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

사용자 제한을 지정하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 최상위 그룹에만 사용자 제한을 설정할 수 있습니다.
  2. 설정 > 일반을 선택합니다.
  3. 권한 및 그룹 기능을 확장합니다.
  4. 좌석 제어에서 사용자 제한 설정 확인란을 선택하고 필드에 사용자 수를 입력합니다.
  5. 변경 사항 저장을 선택합니다.

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

사용자 제한을 늘리는 것은 보류 중인 회원을 승인하지 않습니다.

그룹의 사용자 제한 제거

그룹에 추가할 수 있는 회원 수에 제한이 없도록 사용자 제한을 제거할 수 있습니다.

필수 구성 요소:

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

사용자 제한을 제거하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 권한 및 그룹 기능을 확장합니다.
  4. 좌석 제어에서 열린 액세스를 선택합니다.
  5. 변경 사항 저장을 선택합니다.

사용자 제한을 줄이는 것은 보류 중인 회원을 승인하지 않습니다.

그룹의 보류 중인 회원 승인

과금 가능 사용자 수가 사용자 제한에 도달하면, 새 회원은 보류 상태로 설정되어 있어 승인이 필요합니다.

보류 중인 회원은 과금 가능으로 계산되지 않습니다. 회원은 승인되어 보류 상태에서 벗어나야 비로 과금 가능으로 계산됩니다.

필수 구성 요소:

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

사용자 제한을 초과하여 보류 중인 회원을 승인하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 사용량 할당을 선택합니다.
  3. 좌석 탭에서 경고 아래에 보류 중인 승인 보기를 선택합니다.
  4. 승인하려는 각 회원에 대해 승인을 선택합니다.

알려진 문제

그룹, 하위 그룹 또는 프로젝트가 외부적으로 공유될 때 사용자 제한을 활성화할 수 없습니다. 그룹, 하위 그룹 또는 프로젝트가 외부적으로 공유되면 네임스페이스 계층에 관계없이 네임스페이스 외부에서 공유됩니다.

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

GitLab.com Ultimate에는 알려진 문제가 있어 과금 가능 사용자 수가 사용자 제한을 초과하면 게스트 사용자를 그룹에 추가할 수 없습니다. 예를 들어, 사용자 제한을 5로 설정하고 3명의 개발자와 2명의 게스트가 있는 경우, 추가로 2명의 개발자를 추가한 후에도 더 이상 사용자를 추가할 수 없습니다(과금 가능한 좌석을 소비하지 않는 게스트 사용자라 하더라도).

그룹 파일 템플릿

상세 정보: Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

그룹 파일 템플릿을 사용하여 그룹 내 모든 프로젝트에 일반 파일 형식의 템플릿 세트를 공유할 수 있습니다. 이는 인스턴스 템플릿 저장소와 유사합니다. 선택한 프로젝트는 해당 페이지에 문서화된 명명 규칙을 따라야 합니다.

템플릿 원본으로 그룹 내의 프로젝트만 선택할 수 있습니다. 이는 그룹과 공유된 프로젝트를 포함하지만, 그룹이 구성된 서브그룹이나 상위 그룹의 프로젝트는 제외됩니다.

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

이슈와 병합 요청용 템플릿을 생성하는 방법은 설명 템플릿을 참조하세요.

그룹을 템플릿 원본으로 설정하여 그룹 수준에서 프로젝트 템플릿을 정의하세요. 자세한 정보는 그룹 수준 프로젝트 템플릿을 참조하세요.

그룹 파일 템플릿 활성화

상세 정보: Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

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

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

그룹 병합 확인 설정

상세 정보: Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

그룹 소유자는 최상위 그룹에 병합 요청 확인을 설정할 수 있으며, 해당 설정은 모든 서브그룹과 프로젝트에 적용됩니다.

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

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

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

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

필수 사항:

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

이 설정을 활성화하려면:

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

건너뛴 파이프라인 후 병합 허용

건너뛴 파이프라인이 병합 요청이 병합되는 것을 방지하는 것을 구성할 수 있습니다.

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

필수 사항:

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

이 동작을 변경하려면:

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

일치되지 않은 쓰레드가 해결될 때까지 병합 방지

모든 쓰레드가 해결될 때까지 병합 요청이 병합되는 것을 방지할 수 있습니다. 이 설정이 활성화된 경우 그룹 내의 자식 프로젝트에서는 적어도 하나의 미해결 쓰레드가 있는 병합 요청의 경우 주황색으로 표시됩니다.

필수 사항:

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

이 설정을 활성화하려면:

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

그룹 병합 요청 승인 설정

상세 정보: Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

그룹 승인 설정은 최상위 그룹의 모든 프로젝트에 대한 프로젝트 병합 요청 승인 설정을 관리합니다. 이러한 설정은 그룹에 속하는 모든 프로젝트에 캐스케이드됩니다.

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

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

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

그룹 활동 분석

상세 정보: Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

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

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

그룹 활동 보기

그룹에서 최근의 활동을 브라우저나 RSS 피드에서 확인할 수 있습니다:

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

Atom 형식으로 활동 피드를 보려면 RSS () 아이콘을 선택하세요.