상호 링크는 GitLab에서 이슈 간의 관계를 만듭니다. 상호 링크는 다음과 같이 동작합니다.

• 추적과 가시성을 높이도록 관련 이슈를 연결합니다.
• 이슈를 관련 커밋 및 머지 리퀘스트에 연결합니다.
• 커밋 메시지, 브랜치 이름, 설명을 통해 참조를 만듭니다.
• 프로젝트와 그룹 전반에서 동작합니다.
• 각 이슈의 연결된 항목 섹션에 관계를 표시합니다.

다음 방법으로 상호 링크를 만들 수 있습니다.

• 커밋 메시지
• 연결된 이슈
• 머지 리퀘스트
• 브랜치 이름
• 명시적 작업 항목 링크

커밋 메시지에서#

커밋 메시지에서 이슈를 언급할 때마다 개발 워크플로의 두 단계, 즉 이슈 자체와 해당 이슈와 관련된 첫 번째 커밋 사이의 관계를 만드는 것입니다.

이슈와 커밋하는 코드가 모두 같은 프로젝트에 있으면 커밋 메시지에 #xxx를 추가합니다. 여기서 xxx는 이슈 번호입니다.

git commit -m "this is my commit message. Ref #xxx"

커밋 메시지는 일반적으로 # 문자로 시작할 수 없으므로 대안인 GL-xxx 표기법을 사용할 수도 있습니다.

git commit -m "GL-xxx: this is my commit message"

서로 다른 프로젝트에 있지만 같은 그룹에 속한다면 커밋 메시지에 projectname#xxx를 추가합니다.

git commit -m "this is my commit message. Ref projectname#xxx"

같은 그룹에 속하지 않는다면 이슈의 전체 URL (https://gitlab.com/<username>/<projectname>/-/issues/<xxx>)을 추가할 수 있습니다.

git commit -m "this is my commit message. Related to https://gitlab.com/<username>/<projectname>/-/issues/<xxx>"

물론 gitlab.com을 사용 중인 GitLab 인스턴스의 URL로 바꿀 수 있습니다.

첫 번째 커밋을 이슈에 연결하면 GitLab Value Stream Analytics로 진행 상황을 추적하는 데 도움이 됩니다. 이 기능은 해당 이슈의 구현을 계획하는 데 걸린 시간, 즉 이슈를 만든 시점과 첫 번째 커밋을 만든 시점 사이의 시간을 측정합니다.

연결된 이슈에서#

머지 리퀘스트나 다른 이슈에서 연결된 이슈를 언급하면 팀원과 협업자가 같은 주제에 대해 열려 있는 이슈가 있음을 알 수 있습니다.

이슈 #222에서 이슈 #111을 언급하면 이슈 #111의 활동 피드에도 알림이 표시됩니다. 즉, 관계를 한 번만 언급하면 두 이슈 모두에 표시됩니다. 머지 리퀘스트에서 이슈를 언급할 때도 마찬가지입니다.

이슈의 활동 피드를 기록만 표시 또는 모든 활동 표시로 필터링하면 상호 링크가 (Username) mentioned in issue #(number) (time ago) 형태로 표시됩니다.

머지 리퀘스트에서#

머지 리퀘스트 댓글에서 이슈를 언급하는 방식은 연결된 이슈와 완전히 동일합니다.

머지 리퀘스트 설명에서 이슈를 언급하면 이슈와 머지 리퀘스트가 서로 연결됩니다. 또한 머지 리퀘스트가 머지되는 즉시 이슈가 자동으로 닫히도록 설정할 수도 있습니다.

이슈의 활동 피드를 기록만 표시 또는 모든 활동 표시로 필터링하면 상호 링크가 (Username) mentioned in merge request !(number) (time ago) 형태로 표시됩니다.

브랜치 이름에서#

이슈와 같은 프로젝트에서 브랜치를 만들고 브랜치 이름을 이슈 번호로 시작한 뒤 하이픈을 붙이면, 해당 이슈와 생성한 MR이 연결됩니다. 자세한 내용은 이슈 번호를 브랜치 이름 접두사로 사용을 참고합니다.