브랜치 규칙

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

GitLab은 개별 브랜치를 보호하는 여러 가지 방법을 제공합니다. 이러한 방법은 브랜치가 생성되는 순간부터 삭제될 때까지 감독 및 품질 검사를 받도록 보장합니다:

  • 프로젝트의 기본 브랜치에 대한 보안 및 보호를 강화합니다.
  • 보호된 브랜치를 구성하여:
    • 누가 브랜치로 푸시하고 병합할 수 있는지를 제한합니다.
    • 사용자가 브랜치에 강제로 푸시할 수 있는지 관리합니다.
    • CODEOWNERS 파일에 나열된 파일의 변경 사항이 브랜치에 직접 푸시될 수 있는지 관리합니다.
  • 승인 규칙을 구성하여 검토 요구 사항을 관리하고 보안 관련 승인을 구현합니다.
  • 서드파티 상태 확인과 통합하여 브랜치의 내용이 정의된 품질 기준을 충족하는지 확실히 합니다.

브랜치를 관리할 수 있습니다:

  • GitLab 사용자 인터페이스를 사용하여.
  • 명령줄에서 Git를 사용하여.
  • Branches API를 사용하여.

브랜치 규칙 보기

  • GitLab 15.1에서 branch_rules라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 15.11에서 self-managed에서 활성화되었습니다.
  • GitLab 16.1에서 일반적으로 사용할 수 있습니다. 기능 플래그 branch_rules가 제거되었습니다.

브랜치 규칙 개요 페이지는 구성된 모든 보호와 보호 방법이 있는 브랜치를 보여줍니다:

구성이 구성된 브랜치 예시

전제 조건:

  • 프로젝트에 대해 최소한 Maintainer 역할을 가지고 있어야 합니다.

브랜치 규칙 개요 목록을 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 리포지토리를 선택합니다.
  3. 브랜치 규칙을 확장하여 모든 보호된 브랜치를 봅니다.

브랜치 규칙 세부정보 보기

단일 브랜치에 대한 브랜치 규칙과 보호를 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 리포지토리를 선택합니다.
  3. 브랜치 규칙을 확장하여 모든 보호된 브랜치를 봅니다.
  4. 원하는 브랜치를 식별하고 세부정보 보기를 선택합니다.

브랜치 규칙 만들기


이 기능의 사용 가능성은 기능 플래그에 의해 제어됩니다.
자세한 내용은 역사 기록을 참조하세요.

전제 조건:

  • 프로젝트에 대해 최소한 Maintainer 역할을 가지고 있어야 합니다.

브랜치 규칙을 만들려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 리포지토리를 선택합니다.
  3. 브랜치 규칙을 확장합니다.
  4. 브랜치 규칙 추가를 선택합니다.
  5. 다음 옵션 중 하나를 선택합니다:
    • 특정 브랜치 이름이나 패턴을 입력하려면:
      1. 브랜치 이름 또는 패턴을 선택합니다.
      2. 브랜치 규칙 생성 드롭다운 목록에서 브랜치 이름을 선택하거나 *를 입력하여 와일드카드를 생성합니다.
    • 프로젝트의 모든 브랜치를 보호하려면:
      1. 모든 브랜치를 선택합니다.
      2. 규칙 세부정보 페이지에서 머지 요청 승인 하에 규칙에 필요한 승인 수를 입력합니다.
    • 이미 보호된 것으로 지정된 프로젝트의 모든 브랜치를 보호하려면:
      1. 모든 보호된 브랜치를 선택합니다.
      2. 규칙 세부정보 페이지에서 머지 요청 승인 하에 규칙에 필요한 승인 수를 입력합니다.

브랜치 규칙 보호 추가하기

note
모든 브랜치에 대해 사용할 수 없습니다.

새 브랜치에 보호를 추가하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 리포지토리를 선택합니다.
  3. 브랜치 규칙을 확장합니다.
  4. 브랜치 규칙 추가를 선택합니다.
  5. 모든 보호된 브랜치 또는 브랜치 이름 또는 패턴 중 하나를 선택합니다.
  6. 보호된 브랜치 생성을 선택합니다.

승인 규칙 추가하기

Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
note
모든 브랜치에 대해 사용할 수 없습니다.

사전 요구 사항:

  • 프로젝트에 대해 적어도 유지 관리자 역할이 있어야 합니다.

병합 요청 승인 규칙을 추가하려면:

  1. 브랜치 규칙 세부정보 페이지에서 병합 요청 승인 섹션으로 이동합니다.
  2. 승인 규칙 섹션에서 승인 규칙 추가를 선택합니다.
  3. 오른쪽 사이드바에서 필드를 작성합니다:
    • 규칙 이름을 입력합니다.
    • 필요한 승인 수에서 값을 입력합니다(0-100).

      0의 값은 규칙을 선택 사항으로 만듭니다 그리고 0보다 큰 숫자는 필수 규칙을 생성합니다.
      필요한 승인 수의 최대 값은 100입니다.

    • 승인할 수 있는 사용자 또는 그룹을 선택합니다.
      승인 자격이 있는 사람들입니다.
      GitLab은 병합 요청으로 변경된 파일의 이전 작성자를 기준으로 승인자를 제안합니다.
  4. 변경 사항 저장을 선택합니다.

추가 정보는 승인 규칙을 참조하세요.

상태 확인 서비스 추가하기

Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
note
모든 보호된 브랜치에 대해 사용할 수 없습니다.

상태 확인 서비스를 추가하려면:

  1. 브랜치 규칙 세부정보 페이지에서 상태 확인 섹션으로 이동합니다.
  2. 상태 확인 추가를 선택합니다.
  3. 서비스 이름을 입력합니다.
  4. 확인할 API 필드에 URL을 입력합니다.

    HTTPS URL을 사용하여 병합 요청 데이터를 전송 중에 보호해야 합니다.

브랜치 규칙 상태 확인

자세한 내용은 외부 상태 확인을 참조하세요.

브랜치 규칙 대상 수정하기


이 기능의 사용 가능성은 기능 플래그에 의해 제어됩니다.
자세한 내용은 기록을 참조하세요.

사전 요구 사항:

  • 프로젝트에 대해 적어도 유지 관리자 역할이 있어야 합니다.

브랜치 규칙 대상을 수정하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 리포지토리를 선택합니다.
  3. 보호된 모든 브랜치를 보기 위해 브랜치 규칙을 확장합니다.
  4. 원하는 브랜치를 식별하고 세부정보 보기를 선택합니다.
  5. 규칙 대상 섹션에서 수정을 선택합니다.
  6. 필요에 따라 정보를 수정합니다.
  7. 업데이트를 선택합니다.

브랜치 규칙 보호 편집

note
모든 브랜치에 대해 사용할 수 없습니다.

브랜치 규칙 보호를 편집하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 저장소를 선택합니다.
  3. 브랜치 규칙을 확장하여 보호된 모든 브랜치를 확인합니다.
  4. 원하는 브랜치를 식별하고 상세 정보 보기를 선택합니다.
  5. 브랜치 보호 섹션에서 다음 옵션 중 하나를 선택합니다:
    • 병합 허용에서 편집을 선택합니다.
      1. 이 브랜치로 병합할 수 있는 역할을 선택합니다.
      2. 변경 사항 저장을 선택합니다.
    • 푸시 및 병합 허용에서 편집을 선택합니다.
      1. 이 브랜치로 병합할 수 있는 역할을 선택합니다.
      2. 원할 경우 배포 키를 추가하려고 검색합니다.
      3. 변경 사항 저장을 선택합니다.
note
GitLab Premium 및 Ultimate에서는 병합 허용푸시 및 병합 허용에 그룹 또는 개별 사용자를 추가할 수도 있습니다.

브랜치 보호 제어에 대한 추가 정보는 보호된 브랜치를 참조하세요.

브랜치 규칙 삭제


이 기능의 사용 가능성은 기능 플래그에 의해 제어됩니다.
자세한 내용은 기록을 참조하세요.

前提条件:

  • 프로젝트에 대한 최소 유지 관리 역할을 보유해야 합니다.

브랜치 규칙을 삭제하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 저장소를 선택합니다.
  3. 브랜치 규칙을 확장합니다.
  4. 삭제하려는 규칙 옆에서 상세 정보 보기를 선택합니다.
  5. 오른쪽 상단 모서리에서 규칙 삭제를 선택합니다.
  6. 확인 대화 상자에서 브랜치 규칙 삭제를 선택합니다.