그룹 관리

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

참고: 자체 관리 고객에게는 전체 조직을 한눈에 볼 수 있는 단일 최상위 그룹을 만드는 것이 유용할 수 있습니다. 모든 그룹에 대한 조직적인 관점을 만드는 데 대한 자세한 내용은 epic 9266을 참조하십시오. 단일 최상위 그룹은 완전한 보안 대시 보드 및 센터, 취약점, 및 컴플라이언스 센터 및 가치 역류 분석를 통해 조직 전체에 대한 통찰력을 제공합니다.

그룹 README 추가

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

사전 요구 사항: - 그룹 설정에서 README를 만들려면 그룹의 소유자 역할이 있어야 합니다.

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

그룹 소유자 변경

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

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

그룹 경로 변경

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

다른 그룹이나 사용자에게서 요청될 수 있도록 경로를 변경하는 경우, 그룹 이름도 변경해야 합니다. 이름과 경로 모두 고유해야 합니다.

원래 네임스페이스의 소유권을 유지하고 URL 리디렉트를 보호하기 위해, 대신 프로젝트를 생성하고 프로젝트를 전송하여 새 그룹을 만드는 것이 좋습니다.

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

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

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

경고: 수천 개의 하위 그룹이 있는 그룹이 올바르게 처리되도록 하려면 테스트 환경에서 경로 변경을 테스트하는 것이 좋습니다. 일시적으로 퓨마 작업자 시간 제한을 늘리는 것을 고려해 보십시오. 이 시간 초과 위험을 완화하기 위한 저희의 솔루션에 대한 자세한 정보는 issue 432065을 참조하십시오.

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

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

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

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

참고: GitLab Premium 또는 Ultimate에서 GitLab 관리자는 그룹 소유자가 기본 브랜치 보호 업데이트를 제한하는 기능을 해제할 수 있습니다.

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

GitLab에서 새 프로젝트를 만들 때 첫 푸시로 기본 브랜치가 생성됩니다. 그룹 소유자는 그룹의 프로젝트에 맞는 초기 브랜치 이름을 사용자 정의하여 그룹의 필요에 맞게 설정할 수 있습니다.

다른 그룹과 그룹 공유

프로젝트를 그룹과 공유하는 방법과 유사하게 프로젝트를 그룹과 공유하는 방법으로 다른 그룹과 그룹을 초대하여 공유할 수 있습니다. 공유 조건 및 동작에 대한 자세한 내용은 프로젝트 및 그룹 공유를 참조하세요.

필수 조건:

  • 초대된 그룹 및 초대하는 그룹의 멤버여야 합니다.

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

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

초대된 그룹 제거

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

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

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

  • 초대된 그룹의 직접 멤버는 더 이상 초대하는 그룹에 액세스할 수 없습니다.
  • 초대된 그룹의 멤버는 더 이상 초대하는 그룹의 청구 가능 멤버로 계산되지 않습니다.

그룹 이전

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

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

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

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

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

그룹을 이전하려면:

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

이메일 알림 비활성화

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

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

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

그룹 멘션 비활성화

특정 사용자가 멤버인 그룹을 언급할 때 대화에 추가되지 않고 알림을받지 않도록 할 수 있습니다. 이는 해당 그룹이 언급될 때 사용자가 멤버인 경우에 시각적으로 표시됩니다.

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

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

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

멤버를 CSV로 내보내기

Tier: 프리미엄, 얼티메이트 Offering: GitLab.com, 셀프매니지드, GitLab 전용

그룹 또는 서브그룹의 멤버 목록을 CSV로 내보낼 수 있습니다.

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

결과는 상위 그룹에서 상속받은 직접 멤버와 멤버 목록을 나열합니다. 선택한 그룹에서 최소 액세스를 갖는 멤버의 경우, 그들의 최대 역할 및 소스는 서브그룹 멤버십에서 파생됩니다. Issue 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

각 프로젝트에 일반적인 파일 유형에 대한 템플릿 세트를 공유하기 위해 그룹 파일 템플릿을 사용하십시오. 이는 인스턴스 템플릿 저장소와 유사합니다. 선택한 프로젝트는 해당 페이지에 문서화된 것과 동일한 명명 규칙을 따라야 합니다.

템플릿 원본으로 프로젝트를 선택할 수 있습니다. 이는 그룹과 공유된 프로젝트에만 해당되며, 그룹이 구성 중인 서브그룹이나 상위 그룹의 프로젝트는 해당되지 않습니다.

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

이슈 및 병합 요청에 대한 템플릿을 생성하는 방법을 알아보려면 설명 템플릿을 참조하십시오.

그룹을 템플릿 원본으로 설정하여 그룹 수준에서 프로젝트 템플릿을 정의하십시오. 자세한 내용은 그룹 수준의 프로젝트 템플릿을 참조하십시오.

그룹 파일 템플릿 활성화

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

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾으십시오.
  2. Settings > General을 선택하십시오.
  3. 템플릿 섹션을 확장하십시오.
  4. 템플릿 저장소로 작동할 프로젝트를 선택하십시오.
  5. 변경 사항 저장을 선택하십시오.

그룹 병합 검사 설정

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. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾으십시오.
  2. Settings > General을 선택하십시오.
  3. 병합 요청을 확장하십시오.
  4. 병합 검사 아래에서 파이프라인이 성공해야 함을 선택하십시오. 이 설정은 또한 파이프라인이 없는 경우 병합 요청의 병합을 방지합니다.
  5. 변경 사항 저장을 선택하십시오.

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

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

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

전제 조건:

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

이 동작을 변경하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾으십시오.
  2. Settings > General을 선택하십시오.
  3. 병합 요청을 확장하십시오.
  4. 병합 검사 아래에서:
    • 파이프라인이 성공해야 함을 선택하십시오.
    • 건너뛴 파이프라인을 성공으로 간주함을 선택하십시오.
  5. 변경 사항 저장을 선택하십시오.

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

모든 쓰레드가 해결될 때까지 병합 요청을 방지할 수 있습니다. 이 설정이 활성화되면 귀하의 그룹 내 모든 자식 프로젝트에 대해 병합 요청의 미해결된 쓰레드 수가 최소 하나의 쓰레드가 미해결 상태일 때 주황색으로 표시됩니다.

전제 조건:

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

이 설정을 활성화하려면:

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

그룹 병합 요청 승인 설정

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

그룹 승인 설정은 상위 수준 그룹의 모든 프로젝트에 대한 프로젝트 병합 요청 승인 설정을 관리합니다. 이러한 설정은 그룹에 속한 모든 프로젝트에 계속 적용됩니다.

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

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

승인 설정은 승인 규칙과 혼동되어서는 안 됩니다. 그룹에 대한 병합 요청 승인 규칙 설정 지원은 epic 4367에서 추적합니다.

실험 및 베타 기능 활성화

Tier: Premium, Ultimate Offering: GitLab.com

경고: 실험 및 베타 기능은 예상치 못한 결과를 초래할 수 있습니다 (예: 결과물이 저품질, 불완전, 불일치, 모순적, 무례하거나 민감할 수 있으며, 보안 코드 또는 실패한 파이프라인이 포함될 수 있음).

참고: GitLab Duo 채팅은 프리미엄 티어에서만 제공되는 기능입니다.

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

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

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

그룹 활동 분석

Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
  • GitLab 12.10에서 베타 기능으로 도입됨](https://gitlab.com/gitlab-org/gitlab/-/issues/207164).

그룹에서 지난 90일간 생성된 병합 요청, 이슈, 및 멤버 수를 확인할 수 있습니다.

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

최근 그룹 활동

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

그룹 활동 보기

그룹에서 취해진 가장 최근 조치를 웹 브라우저나 RSS 피드에서 볼 수 있습니다:

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

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