머지 리퀘스트 제목 템플릿
GitLab v19.1- Offering: GitLab.com, GitLab Self-Managed 머지 리퀘스트 제목 템플릿은 프로젝트에서 새 머지 리퀘스트의 기본 제목을 정의합니다. 템플릿은 소스 브랜치 이름이나 첫 번째 커밋 메시지 같은 값으로 확장되는 변수를 지원합니다.
머지 리퀘스트 제목 템플릿#
-
Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed
- GitLab 19.0에서 일반 공개됨. 기능 플래그
mr_default_title_template가 제거됨.
머지 리퀘스트 제목 템플릿은 프로젝트에서 새 머지 리퀘스트의 기본 제목을 정의합니다. 템플릿을 사용하여 팀 전체에서 머지 리퀘스트 명명 규칙을 표준화하세요.
템플릿은 소스 브랜치 이름이나 첫 번째 커밋 메시지 같은 값으로 확장되는 변수를 지원합니다. 사용자는 머지 리퀘스트를 생성하기 전에 제목을 편집할 수 있습니다.
머지 리퀘스트 제목 템플릿 구성#
사전 요구 사항:
- 프로젝트에 대해 최소 Maintainer 권한이 있어야 합니다.
머지 리퀘스트 제목 템플릿을 구성하려면:
-
왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾으세요.
-
Settings > Merge requests를 선택하세요.
-
Merge request title template으로 스크롤하세요.
-
정적 텍스트와 지원되는 변수를 사용하여 템플릿을 입력하세요. 템플릿은 100자로 제한됩니다.
-
Save changes를 선택하세요.
템플릿을 제거하고 기본 동작으로 복원하려면, 템플릿 필드를 지우고 Save changes를 선택하세요.
지원되는 변수#
제목 템플릿은 다음 변수를 지원합니다:
| 변수 | 설명 | 출력 예시 |
|---|---|---|
| %{source_branch} | 소스 브랜치의 이름. | my-feature-branch |
| %{target_branch} | 타깃 브랜치의 이름. | main |
| %{title_from_branch} | 사람이 읽기 쉬운 형식으로 변환된 소스 브랜치 이름. 하이픈과 밑줄은 공백으로 대체됨. | My feature branch |
| %{first_commit_title} | 머지 리퀘스트의 첫 번째 커밋의 제목(첫 번째 줄). | Update README.md |
| %{issue_id} | 소스 브랜치 이름을 통해 연결된 이슈의 IID(예: 123-fix-bug에서 123). 이슈가 감지되지 않으면 공백. | 123 |
| %{issue_title} | 소스 브랜치 이름을 통해 연결된 이슈의 제목. 이슈가 감지되지 않으면 공백. | Fix login bug |
템플릿 예시#
| 템플릿 | 결과 |
|---|---|
| %{source_branch} | my-feature-branch |
| %{title_from_branch} | My feature branch |
| %{first_commit_title} | Update README.md |
| Draft: %{title_from_branch} | Draft: My feature branch |
| [%{source_branch}] %{first_commit_title} | [my-feature-branch] Update README.md |
| Resolve %{issue_id} "%{issue_title}" | Resolve 123 "Fix login bug" |
제목 템플릿 적용 순서#
머지 리퀘스트를 생성할 때, GitLab은 다음 순서로 제목을 할당합니다:
-
제목을 직접 입력한 경우, GitLab은 해당 제목을 사용합니다.
-
제목 템플릿이 구성되어 있는 경우, GitLab은 확장된 템플릿을 사용합니다.
-
템플릿이 설정되어 있지 않은 경우, GitLab은 기본 제목 동작을 사용합니다.
기본 제목 동작#
제목 템플릿이 구성되지 않고 제목을 직접 입력하지 않은 경우, GitLab은 다음 조건을 순서대로 확인하여 제목을 생성합니다:
-
머지 리퀘스트에 커밋이 하나만 있는 경우, 해당 커밋의 제목.
-
머지 리퀘스트에 여러 커밋이 있는 경우, 여러 줄 커밋 메시지를 가진 첫 번째 커밋의 제목.
-
소스 브랜치 이름이 이슈 IID와 하이픈으로 시작하는 경우(예:
123-fix-typo), 제목은Resolve "<your_issue_title>"가 됩니다. -
그 외의 경우, 소스 브랜치 이름에서 하이픈과 밑줄을 공백으로 대체한 이름.
머지 리퀘스트에 커밋이 없거나 드래프트로 표시하면, GitLab은 제목 앞에 Draft:를 추가합니다.