상호 링크는 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도 활동 피드에 알림을 표시합니다. 즉, 두 이슈에 모두 표시되도록 하려면 관계를 한 번만 언급하면 됩니다. 머지 리퀘스트에서 이슈를 언급할 때도 마찬가지입니다.

이슈의 활동 피드가 기록만 표시 또는 모든 활동 표시로 필터링되면 상호 링크가 (사용자 이름)이 이슈 #(번호)에서 언급함 (시간 전)으로 표시됩니다.

머지 리퀘스트에서#

머지 리퀘스트 댓글에서 이슈를 언급하는 것은 연결된 이슈와 정확히 동일하게 작동합니다.

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

이슈의 활동 피드가 기록만 표시 또는 모든 활동 표시로 필터링되면 상호 링크가 (사용자 이름)이 머지 리퀘스트 !(번호)에서 언급함 (시간 전)으로 표시됩니다.

브랜치 이름에서#

이슈와 동일한 프로젝트에서 브랜치를 만들고 브랜치 이름을 이슈 번호 다음에 하이픈을 붙여 시작하면 이슈와 생성하는 MR이 연결됩니다. 자세한 내용은 이슈 번호로 브랜치 이름 접두사 붙이기를 참조하세요.