작업 항목 상태는 In progress, Done, Won't do처럼 작업 항목 워크플로의 특정 단계를 나타냅니다. 상태는 GitLab Free에서 사용하는 기존의 이진 열림/닫힘 상태 체계보다 더 세분화된 추적을 제공합니다.

동영상 개요는 Configurable Status for Issues and Tasks - Complete Walkthrough (GitLab 18.2)를 참고합니다.

상태는 다음 용도로 사용합니다.

• 작업 항목을 완료까지의 여러 단계에 따라 추적합니다.
• 작업 항목 진행 상황을 더 명확하게 파악합니다.
• 작업 항목 라이프사이클 관리를 위해 레이블을 사용할 필요를 대체합니다.
• 팀과 프로젝트 전반의 워크플로를 표준화합니다.

상태는 태스크와 이슈에서 사용할 수 있습니다. 상태는 에픽에서도 사용할 수 있습니다. 그 밖의 작업 항목 유형에 상태를 추가하는 계획은 에픽 5099를 참고합니다.

기본 상태#

GitLab은 작업 항목 추적을 바로 시작할 수 있도록 기본 상태를 제공합니다. 이러한 상태는 수정할 수 없습니다.

기본 상태는 다음과 같습니다.

• To do: 작업 항목을 시작할 준비가 되었습니다.
• In progress: 작업 항목이 활발히 진행 중입니다.
• Done: 작업 항목이 완료되었습니다.
• Won't do: 작업 항목을 완료하지 않습니다.
• Duplicate: 작업 항목이 다른 항목과 중복됩니다.

상태 카테고리#

상태 카테고리는 상태가 작업 항목의 상태와 아이콘에 어떤 영향을 주는지 결정하는 논리적 그룹입니다. 각 상태는 다섯 가지 카테고리 중 하나에 속합니다.

• Triage: 새로 등록되었거나 아직 처리되지 않은 작업 항목에 사용합니다.
• To do: 시작할 준비가 된 작업 항목에 사용합니다.
• In progress: 활발히 진행 중인 작업 항목에 사용합니다.
• Done: 완료된 작업 항목에 사용합니다.
• Canceled: 완료하지 않을 작업 항목에 사용합니다.

Done 및 Canceled 카테고리의 상태는 작업 항목을 자동으로 닫힘 상태로 설정합니다. 그 밖의 카테고리는 작업 항목을 열림 상태로 유지합니다.

라이프사이클#

라이프사이클은 작업 항목 유형에 적용할 수 있는 상태의 모음입니다. 라이프사이클은 여러 상태를 의미 있는 워크플로로 묶어, 작업 항목 유형과 네임스페이스 전반에서 일관되게 재사용할 수 있게 합니다.

각 라이프사이클은 다음과 같은 기본 전환 상태를 정의합니다.

• Default open status: 작업 항목을 만들거나 다시 열 때 적용됩니다.
• Default closed status: 작업 항목을 닫을 때 적용됩니다.
• Default duplicated status: 작업 항목을 중복, 이동 또는 승격으로 표시할 때 적용됩니다.

사용자 정의 라이프사이클을 사용하는 최상위 그룹에서 에픽의 상태를 활성화하면 에픽은 이슈와 같은 라이프사이클을 사용합니다. 이슈에 사용자 정의 라이프사이클이 없으면 에픽은 그룹의 첫 번째 사용자 정의 라이프사이클을 사용합니다. 그룹의 Settings > Work items 페이지의 Statuses 섹션에서 이슈 라이프사이클의 Usage 목록에 에픽 유형이 표시됩니다. 에픽에 다른 라이프사이클을 지정하려면 에픽 유형의 라이프사이클을 변경합니다. 이슈의 라이프사이클을 변경해도 에픽은 현재 라이프사이클을 유지합니다.

라이프사이클 만들기#

사전 요구 사항:

• 그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
• 이 그룹은 최상위 그룹이어야 합니다.

라이프사이클을 만들려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > Work items를 선택합니다.
3. Statuses 섹션에서 Create lifecycle을 선택합니다.
4. 라이프사이클 이름을 추가하고, 기본 라이프사이클 구성 또는 기존 라이프사이클 중 하나를 시작점으로 선택합니다. 그러면 새 라이프사이클이 상태로 미리 채워지며, 이후에 원하는 대로 조정할 수 있습니다.
5. Create를 선택합니다.

라이프사이클 이름 바꾸기#

사전 요구 사항:

• 그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
• 이 그룹은 최상위 그룹이어야 합니다.

라이프사이클의 이름을 바꾸려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > Work items를 선택합니다.
3. Statuses 섹션에서 라이프사이클 세부 정보 보기 위에 포인터를 올립니다.
4. Rename을 선택합니다.
5. 라이프사이클 이름을 바꾸고 Save를 선택합니다.

라이프사이클 제거#

사전 요구 사항:

• 그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
• 이 그룹은 최상위 그룹이어야 합니다.
• 라이프사이클이 사용 중이 아니어야 합니다. 어떤 작업 항목 유형과도 연결되어 있지 않아야 합니다.

라이프사이클을 제거하려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > Work items를 선택합니다.
3. Statuses 섹션에서 제거할 라이프사이클의 Remove lifecycle을 선택합니다.
4. 확인 대화 상자에서 Remove를 선택합니다.

작업 항목 유형의 라이프사이클 변경#

사전 요구 사항:

• 그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
• 이 그룹은 최상위 그룹이어야 합니다.

작업 항목 유형의 라이프사이클을 변경하려면 다음 단계를 수행합니다.

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

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

3. Statuses 섹션에서 다음 중 하나를 수행합니다.

   • Change lifecycle을 선택합니다.
   • 라이프사이클이 둘 이상의 작업 항목 유형에 사용 중이면 드롭다운 목록에서 선택합니다.

4. 작업 항목 유형에 적용할 새 라이프사이클을 선택합니다. 기존 라이프사이클을 선택하거나 새 라이프사이클을 만들 수 있습니다.

5. Next를 선택합니다.

   현재의 모든 상태가 새 라이프사이클에서 어떤 상태로 바뀌는지 표시됩니다.

6. 선택 사항. 다른 대체 상태를 지정하려면 드롭다운 목록에서 선택합니다.

7. Save를 선택합니다.

사용자 정의 상태#

사용자 정의 상태는 네임스페이스에서 정의하는 상태로, 해당 네임스페이스의 모든 그룹과 프로젝트에서 기본 상태를 대체합니다. 라이프사이클을 편집하면 사용자 정의 상태가 해당 네임스페이스의 기본 상태를 대체합니다.

사용자 정의 상태에는 다음과 같은 제한이 있습니다.

• 네임스페이스당 최대 70개 상태
• 라이프사이클당 최대 30개 상태

상태 카테고리 변경#

상태에는 카테고리가 하나 있으며, 이 카테고리는 해당 상태를 사용하는 모든 라이프사이클에 적용됩니다. 다음과 같은 경우에는 상태의 카테고리를 변경할 수 없습니다.

• 상태가 다른 라이프사이클에서 사용되는 경우.
• 상태가 사용 중이고 새 카테고리가 상태를 열림 상태와 닫힘 상태 사이에서 이동시키는 경우. 작업 항목이 상태에 할당되어 있거나 제거된 상태의 대체 상태일 때 상태가 사용 중인 것입니다.

다른 카테고리를 사용하려면 이름이 다르고 원하는 카테고리를 가진 상태를 만듭니다.

네임스페이스에 대한 사용자 정의 상태 구성#

최상위 그룹에 사용자 정의 상태를 구성하면 해당 그룹과 하위 그룹, 프로젝트의 작업 항목에서 사용할 수 있습니다.

사전 요구 사항:

• 그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
• 이 그룹은 최상위 그룹이어야 합니다.

사용자 정의 상태를 구성하려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > Work items를 선택합니다.
3. Statuses 섹션에서 해당 작업 항목 유형이 사용 중인 라이프사이클의 Edit statuses를 선택합니다.
4. 네임스페이스의 상태를 추가, 편집하거나 순서를 변경합니다.
5. Close를 선택합니다.

작업 항목의 상태 설정#

사전 요구 사항:

• 작업 항목이 속한 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있거나, 작업 항목의 작성자이거나, 작업 항목의 담당자여야 합니다.

작업 항목의 상태를 설정하려면 다음 단계를 수행합니다.

1. 이슈 또는 태스크로 이동합니다.
2. 오른쪽 사이드바의 Status 섹션에서 Edit를 선택합니다.
3. 원하는 상태를 선택합니다.
4. 드롭다운 목록 바깥의 아무 곳이나 선택합니다.

작업 항목의 상태가 즉시 업데이트됩니다.