브랜치 규칙

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

GitLab은 각각의 브랜치를 보호하기 위한 여러 가지 방법을 제공합니다. 이러한 방법은 브랜치가 생성된 시점부터 삭제될 때까지 감독을 받고 품질 검사를 받을 수 있도록 합니다.

  • 프로젝트의 기본 브랜치에 향상된 보안 및 보호를 적용합니다.
  • 보호된 브랜치를 구성하여 다음을 수행할 수 있습니다:
    • 누가 브랜치로 푸시하거나 머지할 수 있는지 제한합니다.
    • 사용자가 브랜치로 강제로 푸시하는 것을 관리합니다.
    • CODEOWNERS 파일에 나열된 파일의 변경 사항을 브랜치로 직접 푸시할 수 있는지를 관리합니다.
  • 검토 요구 사항을 관리하고 보호된 브랜치에 대한 승인을 구현하는 데 필요한 승인 규칙을 구성합니다.
  • 외부 상태 확인을 통합하여 브랜치의 내용이 정의된 품질 기준을 충족하는지 확인합니다.

브랜치 관리는 다음과 같이 수행할 수 있습니다:

  • GitLab 사용자 인터페이스로.
  • 명령 줄의 Git으로.
  • 브랜치 API로.

브랜치 규칙 보기

  • 도입됨: 기본적으로 비활성화된 branch_rules 플래그를 포함하여 GitLab 15.1에서.
  • GitLab 15.11에서 Self-Managed에서 활성화됨.
  • GitLab 16.1에서 일반 사용 가능하게 됨. branch_rules 플래그 제거.

브랜치 규칙 개요 페이지에는 구성된 보호가 있는 모든 브랜치 및 보호 방법이 표시됩니다:

구성된 보호가 있는 브랜치의 예시

선행 요구 사항:

  • 프로젝트에 대해 적어도 Maintainer 역할이 있어야 합니다.

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

  1. 왼쪽 사이드바에서 검색 또는 이동를 선택하고 프로젝트를 찾습니다.
  2. 설정 > 저장소를 선택합니다.
  3. 브랜치 규칙을 확장하여 보호가 있는 모든 브랜치를 볼 수 있습니다.

브랜치 규칙 세부 정보 보기

특정 브랜치의 브랜치 규칙과 보호를 보려면:

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

브랜치 규칙 생성하기

  • GitLab 16.8에서 add_branch_rules라는 플래그로 도입됨. 기본적으로 비활성화됨.
  • 기본적으로 비활성화되어 있는 add_branch_rules 플래그가 GitLab 16.11에서 edit_branch_rules로 이름이 변경됨.
  • 모든 브랜치 및 모든 보호된 브랜치 옵션이 GitLab 17.0에서 도입됨.
  • GitLab 17.4에서 GitLab.com에서 활성화됨.
  • GitLab 17.5에서 Self-Managed 및 GitLab Dedicated에서 활성화됨.
이 기능의 가용성은 기능 플래그에 의해 제어됩니다. 자세한 정보는 히스토리를 참조하십시오.

선행 요구 사항:

  • 프로젝트에 대해 적어도 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
모든 브랜치에 대해 사용할 수 없습니다.

선행 요구 사항:

  • 프로젝트에 대해 적어도 Maintainer 역할이 있어야 합니다.

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

  1. 브랜치 규칙 세부 정보에서 병합 요청 승인 섹션으로 이동합니다.
  2. 승인 규칙 추가를 선택합니다.
  3. 오른쪽 사이드바에서 다음을 입력하십시오:
    • 규칙 이름을 입력합니다.

    • 필수 승인 수에서 값(0-100)을 입력합니다.

      0의 값은 규칙을 선택 사항으로 만들며, 0보다 큰 모든 숫자는 필수 규칙을 생성합니다. 필요한 최대 승인 수는 100입니다.

    • 승인할 수 있는 승인자를 선택합니다.
  4. 변경 사항 저장을 선택합니다.

추가 정보는 승인 규칙을 참조하십시오.

상태 확인 서비스 추가

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

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

  1. 브랜치 규칙 세부 정보 페이지에서 Status checks 섹션으로 이동합니다.
  2. Status check 추가를 선택합니다.
  3. 서비스 이름을 입력합니다.

  4. 체크할 API 필드에 URL을 입력합니다.

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

브랜치 규칙 상태 확인

더 많은 정보는 외부 상태 확인를 참조하세요.

브랜치 규칙 대상 편집

이 기능의 사용 가능성은 기능 플래그로 제어됩니다. 자세한 정보는 이력서를 참조하세요.

전제 조건:

  • 프로젝트에 대해 적어도 Maintainer 역할이 있어야 합니다.

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 저장소를 선택합니다.
  3. 모든 보호된 브랜치를 보기 위해 Branch rules를 확장합니다.
  4. 원하는 브랜치를 식별하고 세부 정보 보기를 선택합니다.
  5. Rule target 섹션에서 편집을 선택합니다.
  6. 필요한 정보를 편집합니다.
  7. 업데이트를 선택합니다.

브랜치 규칙 보호 편집

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

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

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

브랜치 보호 컨트롤에 대한 자세한 정보는 보호된 브랜치를 참조하세요.

브랜치 규칙 삭제

이 기능의 사용 가능성은 기능 플래그로 제어됩니다. 자세한 정보는 이력서를 참조하세요.

전제 조건:

  • 프로젝트에 대해 적어도 Maintainer 역할이 있어야 합니다.

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

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