연결된 이슈
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
연결된 이슈는 두 이슈 사이의 양방향 관계이며, 이슈 설명 아래의 블록에 표시됩니다. 이 관계는 사용자가 두 이슈를 모두 볼 수 있을 때만 UI에 표시됩니다. API로 연결된 이슈를 관리하려면 이슈 링크 API를 참고합니다.
히스토리
- GitLab 17.0에서 최소 필요 권한이 Reporter(true인 경우)에서 Guest로 변경되었습니다.
연결된 이슈는 두 이슈 사이의 양방향 관계이며, 이슈 설명 아래의 블록에 표시됩니다. 서로 다른 프로젝트의 이슈를 연결할 수 있습니다.
이 관계는 사용자가 두 이슈를 모두 볼 수 있을 때만 UI에 표시됩니다. 열려 있는 차단 이슈가 있는 이슈를 닫으려고 하면 경고가 표시됩니다.
API로 연결된 이슈를 관리하려면 이슈 링크 API를 참고합니다.
연결된 이슈 추가#
사전 요구사항:
- 두 프로젝트 모두에서 Guest, Planner, Reporter, Developer, Maintainer, Owner 중 하나의 권한이 있어야 합니다.
한 이슈를 다른 이슈에 연결하려면 다음 단계를 수행합니다:
-
이슈의 Linked items 섹션에서 연결된 이슈 추가 버튼(+)을 선택합니다.
-
두 이슈 사이의 관계를 선택합니다. 다음 중 하나입니다:
- relates to
- blocks
- is blocked by
-
이슈 번호를 입력하거나 이슈의 전체 URL을 붙여 넣습니다.

같은 프로젝트의 이슈는 참조 번호만으로 지정할 수 있습니다. 다른 프로젝트의 이슈는 그룹 이름과 프로젝트 이름 같은 추가 정보가 필요합니다. 예를 들면 다음과 같습니다:
- 같은 프로젝트:
#44 - 같은 그룹:
project#44 - 다른 그룹:
group/project#44
유효한 참조는 검토할 수 있도록 임시 목록에 추가됩니다.
- 같은 프로젝트:
-
연결할 이슈를 모두 추가한 후 Add를 선택합니다.
연결된 이슈를 모두 추가하고 나면 관계를 시각적으로 더 쉽게 파악할 수 있도록 분류된 형태로 확인할 수 있습니다.

커밋 메시지나 다른 이슈 또는 MR의 설명에서도 연결된 이슈를 추가할 수 있습니다. 자세한 내용은 이슈 상호 연결을 참고합니다.
연결된 이슈 제거#
이슈의 Linked items 섹션에서 제거할 각 이슈 토큰 오른쪽에 있는 제거 버튼(✗)을 선택합니다.
양방향 관계이므로 두 이슈 모두에서 해당 관계가 더 이상 표시되지 않습니다.

자세한 내용은 권한 페이지를 참고합니다.
차단 이슈#
연결된 이슈를 추가할 때 해당 이슈가 다른 이슈를 blocks하거나 is blocked by 관계임을 표시할 수 있습니다.
다른 이슈에 의해 차단된 이슈는 제목 옆에 아이콘([entity-blocked])이 표시되며, 이 아이콘은 이슈 목록과 보드에 나타납니다. 차단 이슈가 닫히거나 관계가 변경 또는 제거되면 아이콘이 사라집니다.
"Close issue" 버튼으로 차단된 이슈를 닫으려고 하면 확인 메시지가 표시됩니다.