• 커밋 템플릿 구성
• 병합 커밋의 기본 템플릿
• 스쿼시 커밋의 기본 템플릿
• 커밋 템플릿의 지원되는 변수
• 관련 주제

커밋 메시지 템플릿

• GitLab 14.5에서 도입되었습니다.
• GitLab 14.6에서 스쿼시 커밋 템플릿이 도입되었습니다.

GitLab은 특정 유형의 커밋을 위해 기본 메시지를 생성하기 위해 커밋 템플릿을 사용합니다. 이러한 템플릿은 커밋 메시지가 특정 형식을 따르거나 특정 정보를 포함하도록 장려합니다. 사용자는 병합 요청을 병합할 때 이러한 템플릿을 재정의할 수 있습니다.

커밋 템플릿은 리뷰 제안의 구문과 유사한 구문을 사용합니다.

커밋 템플릿 구성

기본 템플릿에 필요한 정보가 포함되어 있지 않은 경우 프로젝트의 커밋 템플릿을 변경하세요.

필수 조건:

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

다음 단계를 수행합니다:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 설정 > 병합 요청을 선택합니다.
3. 생성하려는 템플릿 유형에 따라 병합 커밋 메시지 템플릿 또는 스쿼시 커밋 메시지 템플릿으로 스크롤합니다.
4. 원하는 커밋 유형에 대한 기본 메시지를 입력합니다. 정적 텍스트와 변수를 모두 사용할 수 있습니다. 각 템플릿은 최대 500자로 제한되지만 템플릿을 데이터로 대체한 후 최종 메시지가 더 길어질 수 있습니다.
5. 변경사항 저장을 선택합니다.

병합 커밋의 기본 템플릿

병합 커밋 메시지의 기본 템플릿은 다음과 같습니다:

'%{source_branch}' 브랜치를 '%{target_branch}'로 병합

%{title}

%{issues}

병합 요청 참조: %{reference}

스쿼시 커밋의 기본 템플릿

프로젝트에서 병합 시 커밋을 스쿼시하도록 구성한 경우 GitLab은 다음 템플릿으로 스쿼시 커밋 메시지를 생성합니다:

%{title}

커밋 템플릿의 지원되는 변수

• GitLab 14.5에서 도입되었습니다.
• first_commit 및 first_multiline_commit 변수는 GitLab 14.6에서 도입되었습니다.
• url, approved_by, 및 merged_by 변수는 GitLab 14.7에서 도입되었습니다.
• co_authored_by 변수는 GitLab 14.7에서 도입되었습니다.
• all_commits 변수는 GitLab 14.9에서 도입되었습니다.
• reviewed_by 변수는 GitLab 15.7에서 도입되었습니다.
• local_reference 변수는 GitLab 16.1에서 도입되었습니다.
• source_project_id 변수는 GitLab 16.3에서 도입되었습니다.

커밋 메시지 템플릿은 이러한 변수를 지원합니다:

빈 변수만 포함한 줄은 제거됩니다. 제거할 줄이 전후로 모두 빈 줄인 경우 전후 빈 줄도 제거됩니다.

열려 있는 병합 요청의 커밋 메시지를 편집한 후, GitLab은 커밋 메시지를 자동으로 다시 업데이트합니다. 프로젝트 템플릿으로 커밋 메시지를 복원하려면 페이지를 새로고침하세요.

관련 주제

• Squash and merge.