작업 항목은 GitLab에서 업무를 계획하고 추적하는 핵심 요소입니다. 제품 개발을 계획하고 추적할 때는 전체 맥락과의 연결을 유지하면서도 업무를 관리 가능한 작은 단위로 나누어야 하는 경우가 많습니다. 작업 항목은 이 근본적인 필요에 맞춰 설계되었으며, 전략적 이니셔티브부터 개별 작업까지 모든 수준의 업무 단위를 일관된 방식으로 표현합니다.

작업 항목의 계층 구조는 서로 다른 업무 수준 사이에 명확한 관계를 만들어, 팀이 일상 업무가 상위 목표에 어떻게 기여하는지, 그리고 전략적 목표가 실행 가능한 구성 요소로 어떻게 나뉘는지 이해하도록 돕습니다.

이 구조는 Scrum, Kanban, 포트폴리오 관리 방식 등 다양한 계획 프레임워크를 지원하면서 팀이 모든 수준에서 진행 상황을 파악할 수 있게 합니다.

작업 항목 유형#

GitLab은 다음 작업 항목 유형을 지원합니다.

• 이슈: 작업, 기능, 버그를 추적합니다.
• 에픽: 여러 마일스톤과 이슈에 걸친 대규모 이니셔티브를 관리합니다.
• 태스크: 작은 업무 단위를 추적합니다.
• 목표 및 핵심 결과: 전략적 목표와 측정 가능한 결과를 추적합니다.
• 테스트 케이스: 테스트 계획을 GitLab 워크플로에 직접 통합합니다.

작업 항목 유형 구성으로 새 유형을 만들고 그룹과 프로젝트에서의 사용 여부를 제어할 수도 있습니다.

모든 작업 항목 보기#

Work items 목록은 프로젝트나 그룹의 모든 작업 항목 유형(이슈, 에픽, 태스크 등)을 확인하고 관리하는 중심 공간입니다. 이 화면에서 프로젝트나 그룹의 전체 업무 범위를 파악하고 우선순위를 효과적으로 정합니다.

이전 GitLab 버전에서는 이슈와 에픽이 Plan > Issues와 Plan > Epics 아래에 별도의 목록 페이지를 가졌습니다. GitLab 18.10 이상에서는 이 페이지들이 모든 작업 항목 유형을 하나의 화면에 통합한 Plan > Work items로 대체됩니다. 사이드바에 Issues 나 Epics를 고정해 두었다면 그 자리에 Work items가 고정됩니다. /epics/:iid 또는 /issues/:iid가 포함된 URL은 자동으로 /work_items/:iid로 리디렉션됩니다.

프로젝트나 그룹의 작업 항목을 확인하려면 다음 절차를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트나 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택합니다.

작업 항목 필터링#

Work items 목록은 기본적으로 모든 작업 항목 유형을 표시합니다. 특정 유형만 보려면 (예를 들어 이슈만 또는 에픽만) Type 필터를 사용합니다.

작업 항목 목록을 필터링하려면 다음 절차를 수행합니다.

1. 페이지 상단의 필터 바에서 필터와 연산자, 값을 선택합니다. 예를 들어 에픽만 보려면 필터는 Type, 연산자는 is, 값은 Epic을 선택합니다.
2. 선택 사항. 검색 범위를 좁히려면 필터를 더 추가합니다.
3. Enter를 누르거나 검색 아이콘(🔍)을 선택합니다.

사용 가능한 필터#

작업 항목에는 다음 필터를 사용할 수 있습니다.

• Assignee
  • 연산자: is, is not one of, is one of
• Author
  • 연산자: is, is not one of, is one of
• Confidential
  • 값: Yes, No
• Contact
  • 연산자: is
• Status
  • 연산자: is
• Health status
  • 연산자: is, is not
• Iteration
  • 연산자: is, is not
• Label
  • 연산자: is, is not one of, is one of
• Milestone
  • 연산자: is, is not
• My reaction
  • 연산자: is, is not
• Organization
  • 연산자: is
• Parent
  • 연산자: is, is not
  • 값: 임의의 Issue, Epic, Objective
• Release
  • 연산자: is, is not
• Search within
  • 연산자: Titles, Descriptions
• State
  • 값: Any, Open, Closed
• Type
  • 값: Issue, Incident, Task, Epic, Objective, Key Result, Test case
• Weight
  • 연산자: is, is not

최근에 사용한 필터를 보려면 필터 바 왼쪽에서 Recent searches ([history]) 드롭다운 목록을 선택합니다.

작업 항목 정렬#

작업 항목 목록은 다음 기준으로 정렬합니다.

• 생성일
• 업데이트일
• 시작일
• 마감일
• 제목
• 상태
• 가중치

정렬 기준을 변경하려면 다음 절차를 수행합니다.

1. 필터 바 오른쪽에서 Display ([preferences])를 선택해 표시 기본 설정 창을 엽니다.
2. 창 상단에서 Sort by 드롭다운 목록을 선택합니다.

오름차순과 내림차순 사이에서 정렬 순서를 변경하려면 다음 절차를 수행합니다.

1. 필터 바 오른쪽에서 Display ([preferences])를 선택해 표시 기본 설정 창을 엽니다.
2. 창 상단의 Sort by 드롭다운 목록 옆에서 Sort direction ([sort-lowest] 또는 [sort-highest])을 선택합니다.

정렬 로직에 대한 자세한 내용은 이슈 목록 정렬 및 순서를 참고합니다.

작업 항목 목록 RSS 피드 구독#

GitLab은 작업 항목 목록의 RSS 피드를 제공합니다.

피드를 구독하려면 다음 절차를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트나 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택합니다.
3. 선택 사항. 목록 범위를 좁히려면 필터를 적용합니다.
4. 오른쪽 위에서 Actions (⋮) > Subscribe to RSS feed를 선택합니다.

기본적으로 피드에는 모든 작업 항목 유형이 포함됩니다. 필터를 적용했다면 피드도 해당 필터를 따릅니다.

피드 URL에는 피드 리더로 본인을 인증하는 피드 토큰이 포함됩니다.

목록 표시 기본 설정 구성#

특정 메타데이터 필드를 표시하거나 숨기고 보기 기본 설정을 구성해, 목록 페이지에 작업 항목이 표시되는 방식을 사용자 지정합니다.

GitLab은 표시 기본 설정을 다음 수준으로 저장합니다.

• Fields: 네임스페이스별로 저장됩니다. 업무 방식에 따라 그룹과 프로젝트마다 다른 필드 표시 설정을 둘 수 있습니다. 예를 들어 한 그룹이나 프로젝트에서는 담당자와 레이블을 표시하고 다른 곳에서는 숨길 수 있습니다.
• Your preferences: 모든 프로젝트와 그룹에 걸쳐 전역으로 저장됩니다. 이에 따라 작업 항목을 보는 방식이 일관되게 유지됩니다.

표시 기본 설정을 구성하려면 다음 절차를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.

2. 왼쪽 사이드바에서 Plan > Work items를 선택합니다.

3. 필터 바 오른쪽에서 Display ([preferences])를 선택해 표시 기본 설정 창을 엽니다.

4. Fields에서 표시할 메타데이터를 켜거나 끕니다.

   • Status(이슈 전용)
   • Assignee
   • Labels
   • Weight(이슈 전용)
   • Milestone
   • Iteration(이슈 전용)
   • Dates: 마감일과 기간
   • Health: 건강 상태 표시
   • Blocked/Blocking: 차단 관계 표시
   • Comments: 댓글 수
   • Popularity: 인기도 지표

   켠 필드는 Shown 아래에, 끈 필드는 Hidden 아래에 표시됩니다.

5. 선택 사항. 특정 필드를 찾으려면 Search fields 입력란을 사용합니다.

6. Your preferences에서 Open items in side panel을 켜거나 꺼서 작업 항목을 선택했을 때 열리는 방식을 지정합니다.

   • 켬(기본값): 항목이 화면 오른쪽 서랍에서 열립니다.
   • 끔: 항목이 전체 페이지 화면으로 열립니다.

이 기본 설정은 저장되어 모든 세션과 기기에서 유지됩니다.

작업 항목 Markdown 참조#

GitLab Flavored Markdown 필드에서 [work_item:123]으로 작업 항목을 참조할 수 있습니다. 자세한 내용은 GitLab 전용 참조를 참고합니다.

머지 리퀘스트의 작업 항목#

머지 리퀘스트 설명에서 작업 항목을 참조하면 머지 리퀘스트 사이드바의 Work items 위젯에 자동으로 표시됩니다. 위젯은 연결 방식에 따라 작업 항목을 그룹으로 묶습니다.

• Closing: Closes #123처럼 종료 패턴으로 연결된 작업 항목입니다. 이 작업 항목은 MR 이 머지되면 자동으로 종료됩니다.
• Mentioned: Related to #456처럼 설명에서 참조되었지만 종료 패턴으로 연결되지 않은 작업 항목입니다. 이 작업 항목은 MR 이 머지되어도 종료되지 않습니다.

위젯에 작업 항목이 두 개를 넘게 포함되면 기본적으로 접힙니다. 위젯 헤더를 선택하면 펼쳐집니다. 작업 항목을 선택하면 서랍에서 열립니다.

작업 항목 수동 연결#

머지 리퀘스트 설명을 수정하지 않고 작업 항목을 머지 리퀘스트에 연결할 수도 있습니다. 이렇게 연결한 작업 항목은 Closing 또는 Related 그룹에 표시되고, 머지 리퀘스트는 연결된 각 작업 항목의 Development 섹션에 표시됩니다.

사전 요구 사항:

• 프로젝트에 대한 Developer 이상의 권한이 있어야 합니다.

기존 작업 항목을 머지 리퀘스트에 연결하려면 다음 절차를 수행합니다.

1. 머지 리퀘스트 페이지의 오른쪽 사이드바에 있는 Work items 섹션에서 Add a work item (+)을 선택합니다.
2. Link work item 대화 상자의 Relationship 드롭다운 목록에서 Closes 또는 Relates to를 선택합니다.
3. 검색 필드에서 작업 항목을 검색하거나 해당 URL 또는 참조 ID를 입력한 다음, 해당 항목을 선택합니다.
4. Add를 선택합니다.

작업 항목을 만들어 머지 리퀘스트에 연결하려면 다음 절차를 수행합니다.

1. 머지 리퀘스트 페이지의 오른쪽 사이드바에 있는 Work items 섹션에서 Add a work item (+)을 선택합니다.
2. Link work item 대화 상자의 Relationship 드롭다운 목록에서 Closes 또는 Relates to를 선택합니다.
3. Create new item을 선택합니다.
4. Project 드롭다운 목록에서 프로젝트를 선택합니다.
5. Type 드롭다운 목록에서 작업 항목 유형을 선택합니다.
6. 필드를 입력합니다.
7. 선택한 유형에 해당하는 Create, 예를 들어 Create issue를 선택합니다.

연결을 제거하려면 다음 절차를 수행합니다.

1. 머지 리퀘스트 페이지의 오른쪽 사이드바에 있는 Work items 섹션에서 해당 작업 항목 옆의 Remove (✗)를 선택합니다.

머지 리퀘스트 설명의 종료 패턴이나 멘션으로 추가된 작업 항목은 제거할 수 없습니다.

다른 프로젝트의 작업 항목을 연결하려면 해당 URL 이나 group/project#123과 같은 전체 참조를 입력합니다.

관련 주제#

• 연결된 이슈
• 연결된 에픽
• 이슈 보드
• 레이블
• 이터레이션
• 마일스톤
• 사용자 지정 필드
• 구성 가능한 작업 항목 유형
• 워크플랜