그룹 관리

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

note
Self-Managed형 고객들에게는 전체 조직의 개요를 볼 수 있는 상위 그룹을 하나 만드는 것이 유용할 수 있습니다. 모든 그룹에 대한 조직 보기를 만드는 노력에 대한 자세한 내용은 에픽 9266을 참조하세요. 하나의 상위 그룹은 완벽한 보안 대시보드 및 센터, 취약점, 컴플라이언스 센터, 및 Value Stream Analytics를 통해 전체 조직을 이해할 수 있도록 도와줍니다.

그룹 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 변경을 선택합니다.
caution
컨테이너 레지스트리 태그를 포함하는 프로젝트가 있으면 네임스페이스의 이름을 변경할 수 없습니다.
caution
수천 개의 하위 그룹이 있는 그룹을 올바르게 처리하려면 경로 변경을 테스트하는 것이 좋습니다. 일시적으로 Puma 워커 제한 시간을 늘리는 것도 고려해야 합니다. 이 시간 초과 리스크를 완화하기 위한 솔루션에 대한 자세한 내용은 이슈 432065를 참조하세요.

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

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

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

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

초기 브랜치의 사용자 지정 이름 사용

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, Self-Managed, GitLab Dedicated

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

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

결과에는 선택한 그룹에서 직접적으로 추가된 멤버와 상위 그룹에서 상속된 멤버가 나열되어 있습니다. 선택한 그룹에서 최소한의 접근권한(Minimal Access)을 가진 멤버는 그룹으로의 멤버십을 통해 파생된 최대 역할(Max Role) 및 소스(Source)를 가져옵니다. 그룹 멤버 CSV 내보내기 디렉터리이 UI 멤버 디렉터리과 일치하지 않는 사항에 대한 토론은 이슈 390358에서 추적합니다.

그룹 사용자 제한

  • 기본적으로 비활성화된 saas_user_caps라는 피처 플래그 사용됨.
  • GitLab 16.3에서 GitLab.com에서 사용 가능해짐.

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

과금되는 멤버 수가 사용자 제한에 도달하면 그룹 소유자의 승인 없이 새로운 사용자를 그룹에 추가할 수 없습니다.

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

그룹의 사용자 제한 지정

전제 조건:

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

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다. 최상위 그룹에만 제한을 설정할 수 있습니다.
  2. 설정 > 일반을 선택합니다.
  3. 권한 및 그룹 기능을 펼쳐주세요.
  4. 사용자 제한 상자에 원하는 사용자 수를 입력합니다.
  5. 변경 사항 저장을 선택합니다.

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

사용자 제한을 늘리면 보류 중인 멤버가 승인되지 않습니다.

그룹의 사용자 제한 제거

그룹에 사용자 제한을 제거하여 그룹에 추가할 수 있는 멤버 수를 제한 없이 설정할 수 있습니다.

전제 조건:

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

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 권한 및 그룹 기능을 펼쳐주세요.
  4. 사용자 제한 상자의 값을 삭제합니다.
  5. 변경 사항 저장을 선택합니다.

사용자 제한을 줄이더라도 보류 중인 멤버가는 승인되지 않습니다.

그룹의 보류 중인 멤버 승인

과금되는 사용자 수가 사용자 제한에 도달하면 새로운 사용자는 보류 상태가 되어 승인되어야 합니다.

보류 중인 멤버는 과금되는 사용자로 카운트되지 않습니다. 멤버는 보류 중인 상태에서 승인되기 전까지만 과금되는 사용자로 카운트됩니다.

전제 조건:

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

사용자 제한을 초과하여 보류 중인 멤버를 승인하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
  2. 설정 > 사용량 할당을 선택합니다.
  3. 좌석(Seats) 탭에서 알림 아래 보류 중 승인 보기를 선택합니다.
  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이 Merge되는 것을 방지합니다.
  5. 변경 사항 저장을 선택합니다.

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

건너 뛴 파이프라인이 Merge Request이 Merge되는 것을 방지하는 것을 설정할 수 있습니다.

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

실행 조건:

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

이 동작을 변경하려면:

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

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

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

실행 조건:

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

이 설정을 활성화하려면:

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

그룹 Merge Request 승인 설정

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

그룹 승인 설정은 상위 그룹에 속하는 모든 프로젝트에 대한 프로젝트 Merge Request 승인 설정을 관리합니다. 이 설정은 그룹에 속하는 모든 프로젝트에 계층적으로 적용됩니다.

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

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

승인 설정은 승인 규칙과 혼동되어서는 안 됩니다. 그룹에 대한 Merge Request 승인 규칙을 설정하는 기능은 에픽 4367에서 추적됩니다.

실험 및 베타 기능 활성화

Tier: Premium, Ultimate Offering: GitLab.com, Self-Managed
caution
실험 및 베타 기능은 예상치 못한 결과를 초래할 수 있습니다(예: 결과물이 저품질, 불완전, 일관성이 없음, 무례하거나 민감할 수 있으며, 보안 코드 또는 실패한 파이프라인이 포함될 수 있음).

상위 그룹의 모든 사용자에게 실험 및 베타 기능 액세스를 부여할 수 있습니다. 이 설정은 그룹에 속하는 모든 프로젝트에 상속됩니다.

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

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

그룹 활동 분석

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

그룹에서 지난 90일간 생성된 Merge Request, 이슈, 및 멤버 수를 볼 수 있습니다.

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

그룹 활동 보기

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

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

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