Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CodeCatalyst의 문제 처리 추적 및 구성
CodeCatalyst에서 특성, 버그 및 프로젝트와 관련된 기타 작업을 모니터링할 수 있습니다. 각 작업은 문제라는 고유한 레코드에 보관되어 있습니다. 작업 체크리스트를 추가하여 문제를 더 작은 목표로 나눌 수 있습니다. 각 문제에는 검색, 그룹화 및 필터링할 수 있는 설명, 담당자, 상태 및 기타 속성이 있을 수 있습니다. 기본 보기를 사용하여 문제를 보거나 사용자 지정 필터링, 정렬 또는 그룹화로 고유한 보기를 생성할 수 있습니다. 문제와 관련된 개념에 대한 자세한 내용은 [문제 개념](issues-concepts.md) 섹션을 참조하세요. 첫 번째 문제를 생성하는 방법을 알아보려면 [CodeCatalyst에서 문제 생성](issues-create-issue.md) 섹션을 참조하세요.
다음은 문제를 사용하는 팀이 사용할 수 있는 워크플로 중 하나입니다.
Jorge Souza는 프로젝트에서 작업하는 개발자입니다. 그와 동료 프로젝트 멤버인 Li Juan, Mateo Jackson, Wang Xiulan은 협업을 통해 어떤 작업을 수행해야 하는지 결정합니다. 매일 그와 동료 개발자는 Wang Xiulan이 이끄는 업무 조율 회의를 개최합니다. 그들은 보드에 대한 팀 보기 중 하나로 이동하여 보드를 가져옵니다. 사용자와 팀은 보기를 생성하여 필터, 그룹화 및 문제 정렬을 저장하여 지정된 기준을 충족하는 문제를 쉽게 볼 수 있습니다. 이들의 보기에는 각 개발자에 대한 가장 중요한 문제와 문제의 상태를 표시하기 위해 **담당자**별로 그룹화되고 **우선순위**별로 정렬된 문제가 포함되어 있습니다. Jorge는 완료해야 할 작업이 할당됨에 따라 각 작업에 대한 문제를 생성하여 작업을 계획합니다. 문제를 생성할 때 Jorge는 적절한 **상태**, **우선순위** 및 작업 **예측** 노력을 선택할 수 있습니다. 큰 문제의 경우, Jorge는 문제에 작업을 추가하여 작업을 작은 목표로 나눕니다. Jorge는 즉시 시작할 계획이 없으므로 **백로그**와 같은 초안 상태의 문제를 생성합니다. 초안 상태의 문제는 **초안** 보기에 나타나며, 여기서 계획하고 우선순위를 정해야 합니다. Jorge는 작업을 시작할 준비가 되면, 상태를 다른 범주(**시작되지 않음**, **시작됨** 또는 **완료됨**)의 상태로 업데이트하여 해당 문제를 보드로 이동합니다. 각 작업이 진행 중일 때, 팀은 제목, 상태, 담당자, 레이블, 우선순위 및 추정을 기준으로 필터링하여 지정된 파라미터와 일치하는 특정 문제 또는 유사한 문제를 찾을 수 있습니다. 보드를 사용하여 Jorge와 그의 팀은 각 문제에 대해 완료된 작업 수를 확인하고 작업이 완료될 때까지 각 문제를 한 상태에서 다음 상태로 끌어서 일상적인 진행 상황을 추적할 수 있습니다. 프로젝트가 진행됨에 따라 완료된 문제가 **완료됨** 상태로 누적됩니다. Wang Xiulan은 개발자가 현재 및 향후 작업과 관련된 문제에 집중할 수 있도록 빠른 보관 버튼을 사용하여 아카이브하여 보기에서 제거하기로 결정합니다.
작업을 계획할 때 프로젝트에서 작업하는 개발자는 **정렬 기준** 및 **그룹화 기준**을 선택하여 백로그에서 보드로 이동하려는 문제를 찾습니다. 우선순위가 가장 높은 고객 요청에 따라 보드에 문제를 추가하도록 선택할 수도 있으므로 **고객 요청** 레이블을 기준으로 보드를 그룹화하고 **우선순위**별로 정렬합니다. 또한 추정치를 기준으로 정렬하여 달성할 수 있는 작업량을 확보하고 있는지 확인할 수 있습니다. 프로젝트 관리자인 Saanvi Sarkar는 백로그를 정기적으로 검토하고 정리하여 우선순위가 프로젝트의 성공에 대한 각 문제의 중요성을 정확하게 반영하도록 합니다.
**Topics**
+ [문제 개념](issues-concepts.md)
+ [문제 관련 작업 추적](issues-tracking-work.md)
+ [백로그, 레이블 및 보드로 작업 구성](issues-organizing-work.md)
+ [CodeCatalyst 문제에 대한 할당량](issues-quotas.md)
# 문제 개념
문제를 생성하는 것은 프로젝트 내에서 수행되는 작업을 추적하는 빠르고 효율적인 방법입니다. 문제를 사용하여 일일 업무 조율 회의에서 작업에 대해 논의하고 작업의 우선 순위를 지정하는 등 다양한 작업을 수행할 수 있습니다.
이 페이지에는 CodeCatalyst에서 문제를 효과적으로 사용하는 데 도움이 되는 개념 목록이 포함되어 있습니다.
## 활성 문제
*활성 문제*는 **초안** 상태가 아니거나 보관되지 않은 문제입니다. 즉, 활성 문제는 상태가 **시작되지 않음,** **시작됨** 및 **완료됨**와 같은 상태 범주에 속하는 문제입니다. 상태 및 상태 범주에 대한 자세한 내용은 [상태 및 상태 범주](#issues-concepts-status-definition) 섹션을 참조하세요.
기본 **활성 문제 보기**에서 프로젝트의 모든 활성 문제를 볼 수 있습니다.
## 보관된 문제
*보관된 문제*는 더 이상 프로젝트와 관련이 없는 문제입니다. 예를 들어, 문제가 완료되어 더 이상 **완료** 열에서 볼 필요가 없거나 오류로 생성된 경우 [문제를 보관할](issues-archive-issues.md) 수 있습니다. 필요한 경우 보관된 문제를 보관 해제할 수 있습니다.
## 담당자
*담당자*는 문제가 할당된 사람입니다. 검색 시 목록에 검색한 사람이 표시되지 않으면, 그 사람은 프로젝트에 추가되지 않은 것입니다. 담당자를 추가하려면 [프로젝트에 사용자 초대](projects-members.md#projects-members-add) 섹션을 참조하세요. 문제에 대해 여러 담당자를 활성화하려면 [다수의 담당자 활성화 또는 비활성화](issues-settings-multiple-assignees.md) 섹션을 참조하세요. 여러 담당자가 할당된 문제는 서로 다른 색상의 아바타와 함께 보드에 표시되며, 각 아바타는 담당자 중 하나를 나타냅니다.
## 사용자 지정 필드
*사용자 지정 필드*를 사용하면 프로젝트 내에서 문제를 추적하고 유지하기 위한 필요에 따라 문제의 다양한 속성을 사용자 지정할 수 있습니다. 예를 들어 로드맵 작성을 위한 필드, 특정 기한 또는 요청자 필드를 추가할 수 있습니다.
## 추정
애자일 개발에서는 *추정*을 스토리 포인트라고 합니다. 문제의 모호성과 복잡성 외에도 문제에 대한 추정치를 사용하여 필요한 작업량을 나타낼 수 있습니다. 더 위험도가 높거나 어렵거나 잘 알 수 없는 문제에는 더 높은 추정치를 사용하는 것이 좋습니다.
추정 유형 및 구성 방법에 대한 자세한 내용은 [문제에 대한 노력 추정 구성](issues-settings-estimation.md) 섹션을 참조하세요.
## 문제
*문제*는 프로젝트와 관련된 작업을 추적하는 레코드입니다. 기능, 작업, 버그 또는 프로젝트와 관련된 기타 작업에 대한 문제를 생성할 수 있습니다. 애자일 개발을 사용하는 경우 문제가 에픽 또는 사용자 스토리를 설명할 수도 있습니다.
## Label
*레이블*은 문제를 그룹화, 정렬 및 필터링하는 데 사용됩니다. 새 레이블 이름을 입력하거나 채워진 목록에서 레이블 중 하나를 선택할 수 있습니다. 이 목록은 프로젝트에서 최근에 사용된 레이블로 구성됩니다. 문제에는 레이블이 여러 개 있을 수 있으며, 레이블을 문제에서 제거할 수 있습니다. 레이블을 사용자 지정하려면 [레이블로 작업 범주화](issues-labels.md) 섹션을 참조하세요.
## 우선순위
*우선 순위*는 문제의 중요도를 나타냅니다. **낮음**, **중간**, **높음**, **우선순위 없음**의 네 가지 옵션이 있습니다.
## 상태 및 상태 범주
*상태*는 문제의 현재 상태이며 시작부터 완료까지 수명 주기 동안 문제의 진행 상황을 빠르게 확인하는 데 사용됩니다. 모든 문제에는 상태가 있어야 하며 각 상태는 *상태 범주*에 속합니다. 상태 범주는 상태를 구성하고 기본 문제 보기를 채우는 데 사용됩니다.
CodeCatalyst에는 5개의 기본 상태와 4개의 상태 범주가 있습니다. 기본 상태 이외에 다른 상태를 생성할 수는 있지만 기본 이외의 다른 상태 범주는 생성할 수 없습니다. 다음 목록에는 괄호 안에 기본 상태 및 상태 범주가 포함되어 있습니다. **백로그(초안)**, **할 일(시작되지 않음)**, **진행 중(시작됨)**, **검토 중(시작됨)** 및 **완료(완료됨)**.
상태에 대한 작업의 자세한 내용은 [사용자 지정 상태로 작업 추적](issues-customize-statuses.md) 섹션을 참조하세요.
## 작업
문제에 *작업*을 추가하여 해당 문제의 작업을 더 세분화하고 구성할 수 있습니다. 생성 시 문제에 작업을 추가하거나 기존 문제에 작업을 추가할 수 있습니다. 문제를 볼 때 작업을 재정렬, 제거 또는 완료됨으로 표시할 수 있습니다.
## 보기
CodeCatalyst 프로젝트의 문제는 *보기*에 표시됩니다. 보기는 목록 형식의 문제를 표시하는 그리드 보기 또는 문제 상태별로 구성된 열의 타일로 문제를 표시하는 보드 보기일 수 있습니다. 네 가지 기본 보기가 있으며 사용자 [지정 그룹화, 필터링 및 정렬을 사용하여 자체 보기를 생성할 수 있습니다](issues-creating-view.md). 다음 목록에는 네 가지 기본 보기에 대한 세부 정보가 포함되어 있습니다.
+ **초안** 보기는 현재 작업 중이 아닌 문제를 보여주는 그리드 보기입니다. **초안** 상태 범주의 상태로 생성된 모든 문제가 이 보기에 표시됩니다. 팀은 이 보기를 사용하여 아직 정의 중이거나 할당 및 작업을 기다리고 있는 문제를 확인할 수 있습니다.
+ **활성 문제** 보기는 현재 작업 중인 모든 문제에 대한 보드 보기입니다. **시작되지 않음**, **시작됨** 또는 **완료됨** 상태 범주의 상태 문제가 이 보기에 표시됩니다.
+ **모든 문제 보기**는 프로젝트의 모든 문제, *초안* 및 *활성 문제를* 모두 보여주는 그리드 보기입니다.
+ **보관된** 보기에는 보관된 모든 문제가 표시됩니다.
# 문제 관련 작업 추적
문제를 사용하여 프로젝트 작업을 계획하고 추적할 수 있습니다. 각 문제는 고유한 레코드에 보관된 작업의 일부입니다. 문제를 작업으로 세분화하여 해당 문제의 작업을 추가로 구성하고 추적할 수 있습니다. 또한 문제 간에 링크를 생성하여 관련 작업을 추적하고, 레이블을 추가하여 작업의 구성 및 분류, 문제 그룹화, 작업 우선순위 할당, 작업의 차단 여부 표시를 할 수 있습니다.
문제 또는 일련의 문제를 해결할 준비가 되면, 작업을 추정하고, 사용자에게 할당하고, 다른 사람이 작업 및 진행 상황을 이해하는 데 도움을 주기 위해 설명을 추가할 수 있습니다. 문제를 내보내 다른 형식으로 포함된 정보를 가져올 수도 있습니다.
# CodeCatalyst에서 문제 생성
개발 팀은 작업을 추적하고 관리하는 데 도움이 되는 문제를 생성합니다. 필요에 따라 프로젝트 내에서 문제를 생성할 수 있습니다. 예를 들어 코드를 통해 변수 업데이트를 추적하는 문제를 생성할 수 있습니다. 프로젝트의 다른 사용자에게 문제를 할당하고, 레이블을 사용하여 작업 추적에 도움을 받는 등 다양한 작업을 수행할 수 있습니다.
다음 지침에 따라 CodeCatalyst에서 문제를 생성합니다.
**문제를 생성하려면**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.
1. 문제를 생성하려는 프로젝트로 이동합니다.
1. 프로젝트 홈 페이지에서 **문제 생성**을 선택합니다. 또는 탐색 창에서 **문제**를 선택합니다.
1. **문제 생성**을 선택합니다.
**참고**
그리드 보기를 사용할 때 문제를 인라인으로 추가할 수도 있습니다.
1. 문제의 제목을 입력합니다.
1. (선택 사항) **설명**을 입력합니다. 마크다운을 사용하여 서식 지정을 추가할 수 있습니다.
1. (선택 사항) 문제에 대한 **상태**, **우선 순위** 및 **추정**을 선택합니다.
**참고**
프로젝트의 추정 설정이 **추정 숨기기**로 설정된 경우 **추정** 필드는 없습니다.
1. (선택 사항) 문제에 작업을 추가합니다. 작업을 사용하여 문제의 작업을 더 작은 목표로 세분화할 수 있습니다. 작업을 추가하려면 **\$1 작업 추가**를 선택합니다. 그런 다음 텍스트 필드에 작업 이름을 입력하고 Enter 키를 누릅니다. 작업을 추가한 후 확인란을 선택하여 완료로 표시하거나, 확인란의 왼쪽에서 작업을 선택하고 드래그하여, 순서를 변경할 수 있습니다.
1. (선택 사항) 기존 레이블을 추가하거나 새 레이블을 생성하고 **\$1 레이블 추가**를 선택하여 추가합니다.
1. 기존 레이블을 추가하려면 목록에서 레이블을 선택합니다. 필드에 검색어를 입력하여 프로젝트에 해당 용어가 포함된 모든 레이블을 검색할 수 있습니다.
1. 새 레이블을 생성하고 추가하려면 검색 필드에 생성하려는 레이블의 이름을 입력하고 Enter 키를 누릅니다.
1. (선택 사항) **\$1 담당자 추가**를 선택하여 담당자를 추가합니다. **\$1 나를 추가**를 선택하여 자신을 담당자로 빠르게 추가할 수 있습니다.
**작은 정보**
**Amazon Q**가 문제를 해결하도록 Amazon Q에 문제를 할당할 수 있습니다. 자세한 내용은 [자습서: CodeCatalyst 생성형 AI 기능을 사용하여 개발 작업 속도 향상](getting-started-project-assistance.md) 단원을 참조하십시오. 이 기능은 미국 서부(오리건) 리전에서만 사용할 수 있습니다.
이 기능을 사용하려면 스페이스에 생성형 AI 기능을 활성화해야 합니다. 자세한 내용은 [생성형 AI 기능 관리](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)를 참조하세요.
1. (선택 사항) 기존 **사용자 지정 필드**를 추가하거나 새 사용자 지정 필드를 생성합니다. 문제에는 여러 사용자 지정 필드가 있을 수 있습니다.
1. 기존 사용자 지정 필드를 추가하려면 목록에서 사용자 지정 필드를 선택합니다. 필드에 검색어를 입력하여 프로젝트에 해당 용어가 포함된 모든 사용자 지정 필드를 검색할 수 있습니다.
1. 새 사용자 지정 필드를 생성하고 추가하려면, 검색 필드에 생성하려는 사용자 지정 필드의 이름을 입력하고 Enter 키를 누릅니다. 그런 다음 생성하려는 사용자 지정 필드 유형을 선택하고 값을 설정합니다.
1. **문제 생성**을 선택합니다. 오른쪽 하단 모서리에 알림이 나타납니다. 문제가 성공적으로 생성된 경우 문제가 성공적으로 생성되었다는 확인 메시지가 나타납니다. 문제가 성공적으로 생성되지 않은 경우 실패 이유와 함께 오류 메시지가 나타납니다. 이런 경우 **재시도**를 선택하여 문제를 편집하고 다시 생성하거나 **취소**를 선택하여 문제를 폐기할 수 있습니다. 두 옵션 모두 알림을 무시합니다.
**참고**
풀 요청을 생성할 때는 풀 요청을 문제에 연결할 수 없습니다. 그러나 문제를 생성한 후에는 풀 요청에 연결하는 링크를 추가하기 위해 문제를 [편집](issues-edit-issue.md)할 수 있습니다.
## Amazon Q에 할당된 문제를 생성하고 작업할 때의 모범 사례
문제를 생성할 때 일부 문제는 오랜 시간 그대로 방치되기도 합니다. 이에 대한 원인은 복잡하며 많은 변수가 있을 수 있습니다. 누가 작업해야 하는지 명확하지 않기 때문에 발생하는 것일 수 있습니다. 또는 이 문제로 인해 코드 베이스의 특정 부분에 대한 조사 또는 전문 지식이 필요한 상황에서 작업에 가장 적합한 후보가 다른 문제로 바쁘기 때문일 수도 있습니다. 주로 다른 긴급한 작업을 먼저 진행해야 하는 경우가 많습니다. 이러한 원인 중 일부 또는 전체로 인해 작업이 진행되지 않은 문제가 생길 수 있습니다. CodeCatalyst에는 제목과 설명을 기반으로 문제를 분석할 수 있는 Amazon Q라는 생성형 AI 어시스턴트와의 통합 기능이 포함됩니다. Amazon Q에 문제를 할당하면 평가할 초안 솔루션을 생성하려고 시도합니다. 이렇게 하면 사용자와 팀이 주의가 필요한 문제에 집중하고 작업을 최적화하는 데 도움이 되며, Amazon Q는 즉시 해결할 리소스가 없는 문제에 대한 솔루션을 제공합니다.
**참고**
**Amazon Bedrock:implements 자동 침해 탐지로 구동**됩니다. AWS [https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html) 소프트웨어 개발용 Amazon Q Developer Agent의 **설명 쓰기**, **콘텐츠 요약 생성**, **권장 작업**, **Amazon Q를 사용하여 프로젝트에 기능을 생성하거나 추가**, **Amazon Q에 문제 할당** 기능은 Amazon Bedrock에 구축되므로, 사용자는 Amazon Bedrock에서 구현된 제어 기능을 최대한 활용하여 안전, 보안 및 인공 지능(AI)을 책임 있게 사용할 수 있습니다.
Amazon Q는 간단하고 단순한 문제를 다룰 때 최상의 성능을 발휘합니다. 최상의 결과를 얻으려면 일반적인 언어를 사용하여 수행하려는 작업을 명확하게 설명하세요. 다음은 Amazon Q가 작업할 수 있도록 최적화된 문제를 생성하는 데 도움이 되는 몇 가지 모범 사례입니다.
**중요**
생성형 AI 기능은 미국 서부(오리건) 리전에서만 사용할 수 있습니다.
+ **간단해야 합니다**. Amazon Q는 문제의 제목 및 설명에서 설명할 수 있는 간단한 코드 변경 및 수정 사항에 사용하는 것이 가장 좋습니다. 문제를 할당할 때 모호한 제목이나 지나치게 유동적이거나 모순되는 설명을 쓰지 마세요.
+ **구체적이어야 합니다**. 문제를 해결하는 데 필요한 정확한 변경 사항에 대해 더 많은 정보를 제공할수록 Amazon Q가 문제를 해결하는 솔루션을 생성할 가능성이 높아집니다. 가능한 경우 변경하려는 API 이름, 업데이트하려는 방법, 변경해야 하는 테스트, 생각나는 기타 세부 정보와 같은 특정 세부 정보를 포함합니다.
+ **Amazon Q 에 할당하기 전에 문제의 제목과 설명에 모든 세부 정보가 포함되어 있는지 확인합니다**. Amazon Q에 문제를 할당한 후에는 문제의 제목이나 설명을 변경할 수 없으므로, Amazon Q에 할당하기 전에 문제에 필요한 모든 정보가 있는지 확인하세요.
+ **단일 소스 리포지토리에서 코드 변경이 필요한 문제만 할당합니다**. Amazon Q는 CodeCatalyst의 단일 소스 리포지토리에 있는 코드에서만 작업할 수 있습니다. 연결된 리포지토리는 지원되지 않습니다. Amazon Q에 문제를 할당하기 전에 단일 소스 리포지토리에서만 변경해야 하는 문제인지 확인하세요.
+ **각 단계를 승인하려면 Amazon Q에서 제안한 기본값을 사용합니다**. 기본적으로 Amazon Q는 수행하는 각 단계에 대해 승인을 요구합니다. 이렇게 하면 문제에 대한 설명뿐만 아니라 Amazon Q가 생성한 풀 요청에 대한 설명에서도 Amazon Q와 상호 작용할 수 있습니다. 이렇게 하면 Amazon Q를 통해 보다 대화형 경험을 제공하여, Amazon Q가 접근 방식을 조정하고 문제를 해결하기 위해 생성하는 코드를 구체화하도록 할 수 있습니다.
**참고**
Amazon Q는 문제 또는 풀 요청의 개별 의견에는 응답하지 않지만 접근 방식을 재고하거나 수정을 생성하라는 메시지가 표시되면 이를 검토합니다.
+ **Amazon Q에서 제안한 접근 방식을 항상 주의 깊게 검토합니다**. 한 번 접근 방식을 승인하면 Amazon Q는 해당 접근 방식을 기반으로 코드를 생성하는 작업을 시작합니다. Amazon Q에 계속 진행하라고 알리기 전에 접근 방식이 올바르고 예상하는 모든 세부 정보가 포함되어 있는지 확인하세요.
+ **검토하기 전에 배포할 수 있는 기존 워크플로가 없는 경우에만 Amazon Q가 워크플로에서 작업하도록 허용해야 합니다**. 프로젝트에 풀 요청 이벤트에 대한 실행을 시작하도록 구성된 워크플로가 있을 수 있습니다. 그렇다면 Amazon Q가 생성했으며 워크플로 YAML 생성 또는 업데이트를 포함하고 있는 풀 요청은 해당 풀 요청에 포함된 워크플로의 실행을 시작할 수 있습니다. 프로젝트에서 생성한 풀 요청을 검토하고 승인하기 전에 이러한 워크플로를 자동으로 실행하는 워크플로가 없다는 사실이 확인되지 않았다면 Amazon Q가 워크플로 파일에서 작업하도록 허용하지 않는 것이 가장 좋습니다.
자세한 내용은 [자습서: CodeCatalyst 생성형 AI 기능을 사용하여 개발 작업 속도 향상](getting-started-project-assistance.md) 섹션 및 [생성형 AI 기능 관리](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)를 참조하세요.
## 문제 추정
애자일 개발에서는 *추정*을 스토리 포인트라고 합니다. 문제의 모호성과 복잡성 외에도 문제에 대한 추정치를 사용하여 필요한 작업량을 나타낼 수 있습니다. 더 위험도가 높거나 어렵거나 잘 알 수 없는 문제에는 더 높은 추정치를 사용하는 것이 좋습니다.
문제 추정을 시작하려면 먼저 프로젝트에 사용할 추정 유형을 선택해야 합니다. 기본의 다음 두 가지 유형 중에서 선택할 수 있습니다. **티셔츠 크기** 조정 또는 **Fibonacci 시퀀스**를 효과적으로 사용하려면 팀이 각 크기가 나타내는 것을 서로 맞춰야 합니다. 각 추정치가 나에게 무엇을 나타내는지 함께 결정한 다음 각 문제에 해당 추정치를 적용하기 시작합니다. 정기적인 검토를 하는 것이 좋습니다.
CodeCatalyst의 문제에 대한 노력 추정의 설정을 구성하려면 다음 단계를 따르세요.
**문제에 대한 노력 추정을 구성하려면**
1. 탐색 창에서 **문제**를 선택합니다.
1. **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열고 **설정**을 선택합니다.
1. **기본 설정** 섹션의 **추정**에서 추정 값이 표시되는 방법을 선택합니다. 사용 가능한 추정 유형은 **티셔츠 크기 조정,** **Fibonacci 시퀀싱** 또는 **추정 숨기기**입니다. 프로젝트의 추정 설정이 **추정 숨기기**로 설정된 경우 프로젝트의 문제에 **추정** 필드는 없습니다.
추정 유형이 업데이트되면, 데이터가 손실되지 않고 모든 문제의 추정 값이 자동으로 변환됩니다. 변환 매핑은 다음 표에 나와 있습니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/issues-tracking-work.html)
문제에 대한 추정을 추가하거나 변경하려면 [문제를 편집할 수 있습니다](issues-edit-issue.md).
# CodeCatalyst의 문제 편집 및 공동 작업
**Contents**
+ [문제 편집](issues-edit-issue.md)
+ [첨부 파일 작업](issues-attachments.md)
+ [첨부 파일 보기 및 관리](issues-settings-attachments.md)
+ [문제에 대한 작업 관리](issues-tasks.md)
+ [문제를 다른 문제에 연결](issues-link-issue.md)
+ [문제를 차단됨 또는 차단 해제됨으로 표시](issues-mark-as-blocked.md)
+ [설명의 추가, 편집 또는 삭제](issues-comment.md)
+ [설명에서 언급 기능 사용](issues-mentions-comment.md)
# 문제 편집
다음 단계에 따라 문제의 제목, 설명, 상태, 담당자, 우선순위, 추정 또는 레이블을 편집합니다.
**문제를 편집하려면**
1. 편집하려는 문제를 선택하여 문제의 세부 정보를 봅니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. 그래프의 제목을 편집하려면, 해당 제목을 선택하고 새로운 제목을 입력한 다음, Enter 키를 누릅니다.
1. 설명을 편집하려면, 설명을 선택하고 새 설명을 입력한 다음 Enter 키를 누릅니다. 마크다운을 사용하여 서식 지정을 추가할 수 있습니다.
1. **작업**에서 문제에 대한 작업을 보고 관리할 수 있습니다. 작업이 없는 경우, Amazon Q가 문제를 분석하고 문제에서 업무를 사용자에게 할당할 수 있는 별도의 항목으로 나눌 수 있는 작업을 추천하도록 할 수 있습니다. 자세한 내용은 [문제에 대한 작업 관리](issues-tasks.md) 단원을 참조하십시오.
1. **상태**, **추정** 또는 **우선순위**를 편집하려면 해당 드롭다운 메뉴에서 옵션을 선택합니다.
1. **레이블**에서 기존 레이블을 추가하거나, 새 레이블을 생성하거나, 레이블을 제거할 수 있습니다.
1. 기존 레이블을 추가하려면 **\$1 레이블 추가**를 선택하고 목록에서 레이블을 선택합니다. 필드에 검색어를 입력하여 프로젝트에 해당 용어가 포함된 모든 레이블을 검색할 수 있습니다.
1. 새 레이블을 생성하고 추가하려면, **\$1 레이블 추가**를 선택하고 검색 필드에 생성하려는 레이블의 이름을 입력한 다음 Enter 키를 누릅니다.
1. 레이블을 제거하려면, 제거하려는 레이블 옆에 있는 **X** 아이콘을 선택합니다. 모든 문제에서 레이블을 제거하면, 레이블이 문제 **설정**의 **레이블** 섹션에서 **미사용 레이블** 섹션에 표시됩니다. 미사용 레이블은 필터를 사용하거나 문제에 레이블을 추가할 때 레이블 목록 마지막에 나타납니다. 문제 **설정** 에서 모든 레이블(사용 및 미사용) 및 해당 레이블이 있는 문제에 대한 개요를 확인할 수 있습니다.
1. 문제를 할당하려면, **담당자** 섹션에서 **\$1 담당자 추가**를 선택한 다음 목록에서 담당자를 검색하고 선택합니다. **\$1 나를 추가**를 선택하여 자신을 담당자로 빠르게 추가할 수 있습니다.
1. **첨부 파일**에서 첨부 파일을 추가, 다운로드 또는 제거할 수 있습니다. 자세한 내용은 [첨부 파일 작업](issues-attachments.md) 단원을 참조하십시오.
1. 풀 요청을 연결하려면, **풀 요청 연결**을 선택한 다음, 목록에서 풀 요청을 선택하거나 풀 요청의 URL 또는 ID를 입력합니다. 풀 요청을 연결 해제하려면, 연결 해제 아이콘을 선택합니다.
**작은 정보**
문제에 풀 요청에 대한 링크를 추가한 후, 연결된 풀 요청 목록에서 해당 ID를 선택하여 해당 풀 요청을 빠르게 탐색할 수 있습니다. 풀 요청의 URL을 사용하여 문제 보드와 다른 프로젝트에 있는 풀 요청을 연결할 수 있지만, 해당 프로젝트의 멤버인 사용자만 해당 풀 요청을 보거나 탐색할 수 있습니다.
1. (선택 사항) 기존 사용자 지정 필드를 추가 및 설정하거나, 새 사용자 지정 필드를 생성하거나, 사용자 지정 필드를 제거합니다. 문제에는 여러 사용자 지정 필드가 있을 수 있습니다.
1. 기존 사용자 지정 필드를 추가하려면 목록에서 사용자 지정 필드를 선택합니다. 필드에 검색어를 입력하여 프로젝트에 해당 용어가 포함된 모든 사용자 지정 필드를 검색할 수 있습니다.
1. 새 사용자 지정 필드를 생성하고 추가하려면, 검색 필드에 생성하려는 사용자 지정 필드의 이름을 입력하고 Enter 키를 누릅니다. 그런 다음 생성하려는 사용자 지정 필드 유형을 선택하고 값을 설정합니다.
1. 사용자 지정 필드를 제거하려면, 제거하려는 사용자 지정 필드 옆에 있는 **X** 아이콘을 선택합니다. 모든 문제에서 사용자 지정 필드를 제거하면, 사용자 지정 필드가 삭제되고 필터링 시 더 이상 표시되지 않습니다.
# 첨부 파일 작업
CodeCatalyst에서는 문제에 첨부 파일을 추가하여 관련 파일에 쉽게 액세스할 수 있습니다. 다음 절차에 따라 문제의 첨부 파일을 관리할 수 있습니다.
문제에 추가한 첨부 파일의 크기는 스페이스의 스토리지 할당량에 포함됩니다. 프로젝트의 첨부 파일을 보고 관리하는 방법에 대한 자세한 내용은 [첨부 파일 보기 및 관리](issues-settings-attachments.md) 섹션을 참조하세요.
**중요**
문제의 첨부 파일은 Amazon CodeCatalyst에서 스캔하거나 분석하지 않습니다. 모든 사용자는 악성 코드 또는 콘텐츠가 포함된 문제에 첨부 파일을 추가했을 수 있습니다. 사용자가 첨부 파일을 관리하고 악성 코드, 콘텐츠 또는 바이러스로부터 보호하는 모범 사례를 알고 있는지 확인합니다.
**첨부 파일을 추가, 다운로드 또는 제거하려면**
1. 첨부 파일을 관리할 문제를 선택합니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. 첨부 파일을 추가하려면 **파일 업로드**를 선택합니다. 운영 체제의 파일 탐색기에서 파일로 이동하여 선택합니다. **열기**를 선택하여 첨부 파일로 추가합니다. 최대 첨부 파일 크기와 같은 할당량 정보는 [CodeCatalyst 문제에 대한 할당량](issues-quotas.md) 섹션을 참조하세요.
첨부 파일 이름 및 콘텐츠 유형에 대한 다음 제한 사항에 유의하세요.
+ 파일 이름에는 다음 문자가 허용되지 않습니다.
+ 제어 문자: `0x00–0x1f` 및 `0x80–0x9f`
+ 예약 문자: `/`, `?`, `<`, `>`, `\`, `:`, `*`, `|` 및 `"`
+ Unix 예약 파일 이름: `.` 및 `..`
+ 생략 부호 및 공백
+ Windows 예약 파일 이름: `CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9`
+ 첨부 파일의 콘텐츠 유형은 다음 미디어 유형 패턴을 준수해야 합니다.
```
media-type = type "/" [tree "."] subtype ["+" suffix]* [";" parameter];
```
예시: `text/html; charset=UTF-8`.
1. 첨부 파일을 다운로드하려면 다운로드하려는 첨부 파일 옆의 줄임표 메뉴를 선택하고 **다운로드**를 선택합니다.
1. 첨부 파일의 URL을 복사하려면, URL을 복사할 첨부 파일 옆의 줄임표 메뉴를 선택하고 **URL 복사**를 선택합니다.
1. 첨부 파일을 제거하려면, 제거하려는 첨부 파일 옆의 줄임표 메뉴를 선택하고 **삭제**를 선택합니다.
# 첨부 파일 보기 및 관리
문제 설정에서 프로젝트의 문제에 추가된 모든 첨부 파일이 담긴 테이블을 볼 수 있습니다. 이 테이블에는 콘텐츠 유형, 첨부된 시간, 첨부된 문제 및 문제 상태, 파일 크기와 같은 정보를 포함하여 각 첨부 파일의 세부 정보가 포함되어 있습니다.
이 테이블을 사용하면 완료되거나 보관된 문제의 큰 첨부 파일을 쉽게 식별하여 스페이스의 스토리지를 확보할 수 있습니다.
**중요**
문제의 첨부 파일은 Amazon CodeCatalyst에서 스캔하거나 분석하지 않습니다. 모든 사용자는 악성 코드 또는 콘텐츠가 포함된 문제에 첨부 파일을 추가했을 수 있습니다. 사용자가 첨부 파일을 관리하고 악성 코드, 콘텐츠 또는 바이러스로부터 보호하는 모범 사례를 알고 있는지 확인합니다.
**프로젝트의 모든 문제 첨부 파일을 보고 관리하려면**
1. 탐색 창에서 **문제**를 선택합니다.
1. 줄임표 아이콘을 선택하고 **설정**을 선택합니다.
1. **첨부 파일** 탭을 선택합니다.
# 문제에 대한 작업 관리
문제에 *작업*을 추가하여 해당 문제의 작업을 더 세분화, 구성 및 추적할 수 있습니다. 작업을 직접 생성하거나 Amazon Q를 사용하여 문제 분석 및 복잡성에 따라 작업을 추천할 수 있습니다.
Amazon Q Developer는 AWS 애플리케이션을 이해, 구축, 확장 및 운영하는 데 도움이 되는 생성형 AI 기반 대화형 어시스턴트입니다. 빌드 속도를 높이기 위해 Amazon Q AWS를 지원하는 모델을 고품질 AWS 콘텐츠로 보강하여 더 완전하고 실행 가능하며 참조된 답변을 생성합니다. 자세한 내용은 **Amazon Q Developer 사용 설명서의 [ Amazon Q Developer란 무엇인가요?](https://docs.aws.amazon.com/amazonq/latest/aws-builder-use-ug/what-is.html)를 참조하세요.
**문제에 대한 작업 관리하려면**
1. 작업을 관리하려는 문제를 선택합니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. **작업**에서 문제에 대한 작업을 보고 관리할 수 있습니다.
1. 작업을 추가하려면 텍스트 필드에 작업 이름을 입력하고 Enter 키를 누릅니다.
1. 문제에 대한 작업이 없는 경우 Amazon Q가 문제를 분석하고 문제 제목, 설명, 문제의 복잡성 분석 및 리포지토리 코드를 기반으로 작업을 생성하도록 선택하고 **작업 추천**을 선택합니다. 문제의 코드가 포함된 소스 리포지토리를 지정해야 합니다. **작업 추천 시작**을 선택하여 작업 추천 분석을 시작합니다. 대화 상자가 닫힙니다. 추천이 완료되면, **추천 작업 보기**를 선택하여 작업을 검토하고, **작업 생성**을 선택하기 전에 목록에 작업을 삭제 또는 추가하거나 추천 작업의 순서를 변경하는 등 필요한 조치를 취합니다.
작업을 생성한 후에는 사용자에게 할당할 수 있으며, 수동으로 생성한 작업과 동일한 방식으로 작업할 수 있습니다.
1. 작업을 완료로 표시하려면 작업의 확인란을 선택합니다.
1. 작업의 세부 정보를 보거나 업데이트하려면 목록에서 선택합니다.
1. 작업을 재정렬하려면, 확인란 왼쪽에서 작업을 선택하여 끌어옵니다.
1. 작업을 제거하려면, 작업의 줄임표 메뉴를 선택하고 **제거**를 선택합니다.
# 문제를 다른 문제에 연결
문제가 다른 문제의 작업과 관련된 경우, 연결할 수 있습니다. 이는 작업 항목 간의 종속성을 이해하고 추적하는 데 도움이 되는 빠른 방법입니다.
문제를 연결할 때 선택할 수 있는 네 가지 상태가 있습니다.
+ 관련 항목: 연결된 문제와 관련된 작업을 나타내려면 이 상태를 사용합니다.
+ 차단 기준: 연결된 문제로 인해 문제가 차단되었음을 나타내려면 이 상태를 사용합니다.
+ 차단 대상: 해당 문제가 연결된 문제의 진행을 차단하고 있음을 나타내려면 이 상태를 사용합니다.
+ 중복: 해당 문제가 다른 문제에 캡처된 작업을 복제했다는 점을 나타내려면 이 상태를 사용합니다.
링크의 상태는 생성한 후에 변경할 수 있습니다. 링크와 링크 상태는 링크를 생성하는 문제와 연결된 문제 모두에서 **연결된 문제**에 나타납니다. 링크가 생성된 후에도 링크를 제거할 수 있습니다.
**문제를 다른 문제 또는 작업에 연결하려면**
1. 다른 문제에 연결하려는 문제를 엽니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. **문제 연결**을 선택합니다.
1. **다음으로 표시**에서 링크의 상태를 선택합니다.
**문제 번호**에 문제의 번호를 입력하거나 드롭다운 목록에서 해당 문제를 선택합니다.
1. 다른 링크를 추가하려면 **연결된 문제 추가**를 선택합니다.
1. 완료되면 **업데이트**를 선택하여 연결된 관계와 관련된 문제 및 모든 연결된 문제를 업데이트합니다.
# 문제를 차단됨 또는 차단 해제됨으로 표시
문제를 해결하지 못하도록 막는 요소가 있다면, *차단됨*으로 표시할 수 있습니다. 예를 들어, 아직 병합되지 않은 코드 베이스의 다른 부분에 대한 변경에 의존하는 경우 문제가 차단될 수 있습니다.
문제를 차단됨으로 표시하면, CodeCatalyst는 문제에 빨간색 **차단됨** 레이블을 추가하여, 백로그 또는 아카이브 또는 보드에서 잘 보이도록 합니다.
외부 상황이 해결되면, 문제를 차단 해제할 수 있습니다.
**문제를 차단됨으로 표시하려면**
1. 차단됨으로 표시할 문제를 엽니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. **작업**을 선택한 다음, **차단됨으로 표시**를 선택합니다.
**문제를 차단 해제하려면**
1. 차단 해제하려는 문제를 엽니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. **작업**을 선택한 다음, **차단 해제됨으로 표시**를 선택합니다.
# 설명의 추가, 편집 또는 삭제
문제에 대한 설명을 남길 수 있습니다. 설명에서 다른 스페이스 멤버, 스페이스의 다른 프로젝트, 관련 문제 및 코드에 태그를 지정할 수 있습니다.
**문제에 설명을 추가하려면**
1. 프로젝트로 이동합니다.
1. 탐색 바에서 **문제**를 선택합니다.
1. 설명을 추가할 문제를 선택합니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. **설명** 필드에 설명을 입력합니다. 마크다운을 사용하여 서식 지정을 추가할 수 있습니다.
1. **전송**를 선택합니다.
**설명을 편집하려면**
문제에 대한 설명은 편집할 수 있습니다. 직접 작성한 설명만 편집할 수 있습니다.
1. 프로젝트로 이동합니다.
1. 탐색 바에서 **문제**를 선택합니다.
1. 설명을 편집할 문제를 선택합니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. 설명을 편집하려면, 편집할 설명을 찾습니다.
**작은 정보**
오래된 순 또는 최신 순으로 설명을 정렬할 수 있습니다. 설명은 한 번에 10개씩 로드됩니다.
1. 줄임표 아이콘을 선택한 다음 **편집**을 선택합니다.
1. 설명을 편집합니다. 마크다운을 사용하여 서식 지정을 추가할 수 있습니다.
1. **저장**을 선택합니다. 이제 설명이 업데이트됩니다.
**설명을 삭제하려면**
문제에 대한 설명은 삭제할 수 있습니다. 직접 작성한 설명만 삭제할 수 있습니다. 설명이 삭제되면, 사용자 이름이 표시되지만 원본 설명 텍스트 대신 *이 설명은 삭제되었습니다*라는 문구가 나타납니다.
1. 프로젝트로 이동합니다.
1. 탐색 바에서 **문제**를 선택합니다.
1. 설명을 삭제할 문제를 선택합니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. 줄임표 아이콘을 선택하고 **삭제**를 선택한 다음 **확인**을 선택합니다.
# 설명에서 언급 기능 사용
스페이스 멤버, 스페이스의 다른 프로젝트, 관련 문제 및 코드를 설명에서 언급할 수 있습니다. 이렇게 하면 사용자가 언급한 사용자 또는 리소스에 대한 빠른 링크가 생성됩니다.
**설명에서 @mention을 사용하려면**
1. 프로젝트로 이동합니다.
1. 탐색 바에서 **문제**를 선택합니다.
1. 편집하려는 문제를 선택하여 문제의 세부 정보를 봅니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. **설명 추가** 텍스트 상자를 선택합니다.
1. 다른 사용자를 언급하려면 `@user_name`을 입력합니다.
1. 프로젝트를 언급하려면 `@project_name`을 입력합니다.
1. 다른 문제를 언급하려면 `@issue_name` 또는 `@issue_number`를 입력합니다.
1. 소스 리포지토리에서 특정 파일 또는 코드를 언급하려면 `@file_name`을 입력합니다.
**참고**
입력 시 `@mention`와 일치하는 용어가 포함된 상위 5개 항목(사용자, 소스 리포지토리, 프로젝트 등)의 목록에서 작성됩니다.
1. 언급하려는 항목을 선택합니다. 항목이 있는 위치를 보여주는 경로가 설명 텍스트 상자에 작성됩니다.
1. 설명을 완료하고 **전송**을 선택합니다.
# 문제 찾기 및 보기
다음 섹션에서는 CodeCatalyst 프로젝트 내에서 문제를 효과적으로 검색하고 보는 방법을 설명합니다.
## 문제 검색
특정 파라미터를 검색하여 문제를 찾을 수 있습니다. 보다 구체적인 검색에 대한 자세한 내용은 [CodeCatalyst에서 코드, 문제, 프로젝트 및 사용자 검색코드, 문제, 프로젝트 및 사용자 검색](search.md) 섹션을 참조하세요.
**문제를 검색하려면**
1. 프로젝트로 이동합니다.
1. 검색 창을 사용하여 문제 또는 문제와 관련된 정보를 검색합니다. 쿼리 파라미터를 사용하여 검색을 구체화할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 코드, 문제, 프로젝트 및 사용자 검색코드, 문제, 프로젝트 및 사용자 검색](search.md) 단원을 참조하십시오.
# 문제 정렬
기본적으로 CodeCatalyst의 문제는 **수동 순서**로 정렬됩니다. 수동 순서는 사용자가 이동시킨 순서대로 문제를 표시합니다. 수동 순서로 정렬할 때는 문제를 끌어다 놓아 순서를 변경할 수 있습니다. 이 정렬 옵션은 문제의 백로그를 정리하고 문제의 우선순위를 지정할 때 유용합니다.
다음 표는 그리드 보기와 보드 보기 모두에서 문제를 정렬하는 방법을 보여줍니다.
| 그리드 보기 정렬 옵션 | 보드 보기 정렬 옵션 |
| --- | --- |
| 수동 순서 | 수동 순서 |
| 최종 업데이트 날짜 | 최종 업데이트 날짜 |
| 우선순위 | 우선순위 |
| 추정 | 추정 |
| 제목 | 제목 |
| ID | |
| Status | |
| 차단됨 | |
| 사용자 지정 필드 | |
다음 절차에 따라 문제가 정렬되는 방법을 변경할 수 있습니다.
**문제를 정렬하려면**
1. 프로젝트로 이동합니다.
1. 탐색 창에서 **문제**를 선택합니다. 기본 보기는 **보드**입니다.
1. (선택 사항) **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열어 다른 문제 보기로 이동합니다.
1. 그리드 보기를 정렬하려면 두 가지 옵션이 있습니다.
1. 정렬할 필드의 **헤더**를 선택합니다. **헤더**를 선택하면 오름차순과 내림차순으로 순환됩니다.
1. **정렬 기준** 드롭다운 메뉴를 선택하고 정렬 기준 파라미터를 선택합니다. 문제는 오름차순으로 정렬됩니다.
1. 보드 보기를 정렬하려면 **정렬 기준** 드롭다운 메뉴를 선택하고 정렬 기준 파라미터를 선택합니다. 문제는 오름차순으로 정렬됩니다.
# 문제 그룹화
그룹화는 담당자, 레이블 및 우선순위와 같은 여러 파라미터별로 보드의 문제를 구성하는 데 사용됩니다.
**문제를 그룹화하려면**
1. 프로젝트로 이동합니다.
1. 탐색 창에서 **문제**를 선택합니다. 기본 보기는 **보드**입니다.
1. (선택 사항) **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열어 다른 문제 보기로 이동합니다.
1. **그룹**을 선택합니다.
1. **그룹화**에서 다음과 같이 그룹화 기준 파라미터를 선택합니다.
+ **담당자** 또는 **우선순위**를 선택한 경우, **그룹 순서**를 선택합니다.
+ **레이블**을 선택한 경우, 레이블을 선택한 다음 **그룹 순서**를 선택합니다.
1. (선택 사항) **빈 그룹 표시** 토글을 선택하여 현재 할당된 문제가 없는 그룹을 표시하거나 숨깁니다.
1. 선택에 따라 보기가 업데이트됩니다. 구성된 파라미터와 일치하는 그룹에만 문제가 나타납니다.
# 문제 필터링
필터링을 사용하여 지정된 이름, 우선순위, 레이블, 사용자 지정 필드 또는 담당자가 포함된 문제를 찾습니다.
**문제를 필터링하려면**
1. 프로젝트로 이동합니다.
1. 탐색 창에서 **문제**를 선택합니다.
1. (선택 사항) **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열어 다른 문제 보기로 이동합니다.
**참고**
문제 이름 또는 설명의 문자열을 기준으로 필터링하려면, 문제 검색창에 문자열을 입력합니다.
1. **필터**를 선택한 다음 **\$1필터 추가**를 선택합니다.
1. 필터링할 파라미터를 선택합니다. 여러 필터와 파라미터를 선택할 수 있습니다. **및**이나 **또는**을 선택하여 모든 필터 또는 개별 필터와 일치하는 문제를 표시하도록 필터를 구성할 수 있습니다. 보기가 업데이트되어 필터와 일치하는 문제가 표시됩니다.
# 문제 진행
모든 문제에는 수명 주기가 있습니다. CodeCatalyst에서 문제는 일반적으로 백로그에서 초안으로 시작됩니다. 해당 문제에 대한 작업을 시작해야 할 경우, 문제를 다른 상태 범주로 이동하고 완료될 때까지 다양한 상태로 이동한 다음 보관됩니다. 다음과 같은 방법으로 수명 주기 동안 문제를 이동하거나 진행할 수 있습니다.
+ 백로그와 보드 간에 문제를 이동할 수 있습니다.
+ 진행 중인 문제를 다양한 완료 단계로 이동할 수 있습니다.
+ 완료된 문제를 보관할 수 있습니다.
# 백로그와 보드 사이에서 문제 이동
문제를 작업하기 시작하면, 백로그에서 보드로 문제를 이동할 수 있습니다. 작업이 연기된 경우, 문제를 백로그로 다시 이동할 수도 있습니다.
**백로그와 보드 간에 문제를 이동하려면**
1. 프로젝트로 이동합니다.
1. 탐색 창에서 **문제**를 선택합니다. 기본 보기는 **보드**입니다.
1. 보드에서 백로그로 문제를 이동하려면:
1. 이동할 문제를 선택합니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. 드롭다운 **상태** 메뉴에서 **백로그**를 선택합니다.
1. 보드에서 백로그로 문제를 이동하려면:
1. 백로그로 이동하려면, **보드**를 선택하고 **백로그를** 선택합니다.
1. 이동할 문제를 선택합니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. **보드에 추가**를 선택하거나 **백로그** 이외의 **상태**를 선택합니다.
# 보드의 라이프 사이클 단계를 통한 문제의 진행
완료 시까지 문제는 보드 내의 다양한 상태로 이동할 수 있습니다.
**보드 내에서 문제를 이동시키려면**
1. 탐색 창에서 **문제**를 선택합니다. 기본 보기는 **보드**입니다.
1. 다음 중 하나를 수행하세요.
+ 문제를 다른 상태로 끌어다 놓습니다.
+ 문제를 선택한 다음 **상태** 드롭다운 메뉴에서 상태를 선택합니다.
+ 문제를 선택한 다음 **다음으로 이동: *다음 상태***를 선택합니다.
문제 보관에 대한 자세한 내용은 [문제 보관](issues-archive-issues.md) 섹션을 참조하세요.
# 그룹 간 문제 이동
**모든 문제** 및 **보드** 보기에서 다양한 파라미터별로 [문제를 그룹화](issues-grouping.md)할 수 있습니다. 문제가 그룹화되면, 한 그룹에서 다른 그룹으로 문제를 이동할 수 있습니다. 한 그룹에서 다른 그룹으로 문제를 이동하면 대상 그룹과 일치하도록 문제가 그룹화된 필드가 자동으로 편집됩니다.
예시 시나리오로, CodeCatalyst를 사용하는 회사에서 Wang Xiulan과 Saanvi Sarkar라는 두 사람에게 문제가 할당되었다고 가정해 보겠습니다. 보드는 `Assignee`별로 그룹화되며 각 담당자마다 하나씩, 총 두 개의 그룹이 있습니다. Wang Xiulan의 그룹에서 Saanvi Sarkar의 그룹으로 문제를 이동하면, 문제의 담당자가 Saanvi Sarkar로 업데이트됩니다.
# 문제 보관
**참고**
문제는 프로젝트 내에서 삭제되지 않고 보관됩니다. 문제를 삭제하려면 프로젝트를 삭제해야 합니다.
프로젝트에서 문제가 더 이상 필요하지 않을 때 해당 문제를 보관할 수 있습니다. 문제를 보관하면 CodeCatalyst는 보관된 문제를 필터링하는 모든 보기에서 문제를 제거합니다. 보관된 문제는 **보관된 문제** 기본 보기에서 볼 수 있으며, 필요한 경우 이 보기에서 보관을 취소할 수 있습니다.
다음과 같은 경우 문제를 보관합니다.
+ 문제를 완료했으며 **완료** 열에 더 이상 문제를 둘 필요가 없습니다.
+ 이 작업을 수행할 계획이 없습니다.
+ 실수로 문제를 생성했습니다.
+ 최대 활성 문제 수에 도달했습니다.
**문제를 보관하려면**
1. 보관하려는 문제를 엽니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. **작업**을 선택한 후 **이동하여 보관**을 선택합니다.
1. (선택 사항) **완료됨** 상태의 여러 문제를 빠르게 보관하려면 보드의 **완료됨** 상태 상단에 있는 세로 줄임표를 선택하고 **문제 보관**을 선택합니다.
**문제를 보관 해제하려면**
1. 보관 해제하려는 문제를 엽니다. **문제 보기 전환기** 드롭다운 메뉴에서 **보관된 문제 보기**를 열어 보관된 문제 목록을 볼 수 있습니다. 문제를 찾는 방법에 대한 도움말은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
1. **보관 해제**를 선택합니다.
# 문제 내보내기
현재 보기의 문제를 .xlsx 파일로 내보낼 수 있습니다. 문제를 내보내려면, 다음 단계를 수행합니다.
**문제를 내보내려면**
1. 프로젝트로 이동합니다.
1. 탐색 바에서 **문제**를 선택합니다.
1. **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열고 내보내려는 문제가 포함된 보기로 이동합니다. 보기에 표시된 문제만 내보내집니다.
1. 줄임표 메뉴를 선택하고 **Excel로 내보내기**를 선택합니다.
1. .xlsx 파일이 다운로드됩니다. 기본적으로 프로젝트의 이름과 내보내기가 완료된 날짜로 제목이 지정됩니다.
# 백로그, 레이블 및 보드로 작업 구성
모든 팀이 동일한 방식으로 작업하는 것은 아닙니다. 문제가 나타나는 방식을 구성하고 Amazon CodeCatalyst에서 할당하여 진행 중인 작업과 해당 작업의 상태를 정확하게 이해할 수 있습니다. 사용자가 모두 동일한 추정 방법을 사용하도록 문제를 허용할 추정 방법을 선택할 수 있습니다. 사용자 지정 레이블 및 상태를 생성하여 작업에 대한 보기를 필터링할 때 사용할 수도 있습니다. 팀의 작업 방식에 따라 문제에 여러 담당자를 허용할지 아니면 단일 사용자에게만 문제를 할당할지 여부를 구성할 수 있습니다. 문제에 대한 사용자 지정 보기를 생성하여 사용자 또는 팀과 가장 관련성이 높은 정보를 표시하는 방식으로 작업이 표시되도록 할 수도 있습니다.
# 레이블로 작업 범주화
문제에 대한 레이블을 사용자 지정할 수 있습니다. 여기에는 레이블 편집 및 색상 변경이 포함됩니다. 레이블은 작업을 분류하고 구성하는 데 도움이 될 수 있습니다. 예를 들어, 소프트웨어의 특정 측면 또는 다른 그룹 또는 팀에 대한 레이블을 생성할 수 있습니다.
**Topics**
+ [레이블 생성](#issues-create-label)
+ [레이블 편집](issues-edit-label.md)
+ [레이블 삭제](issues-delete-label.md)
## 레이블 생성
CodeCatalyst에서는 새 문제를 생성하거나 기존 문제를 편집할 때 레이블을 추가하여 레이블을 생성합니다. 자세한 내용은 [CodeCatalyst에서 문제 생성](issues-create-issue.md) 및 [CodeCatalyst의 문제 편집 및 공동 작업](issues-edit-collaborate-issue.md) 섹션을 참조하세요.
# 레이블 편집
다음 절차에 따라 기존 레이블의 이름 또는 색상을 변경합니다.
**레이블을 편집하려면**
1. 탐색 창에서 **문제**를 선택합니다.
1. **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열고 **설정**을 선택합니다.
1. **레이블** 타일에는 프로젝트에 사용되는 레이블 목록이 있습니다. 편집하려는 레이블 옆의 편집 아이콘을 선택합니다. 다음 중 한 개 이상을 수행할 수 있습니다.
1. 레이블의 이름을 편집합니다.
1. 색상을 변경하려면 색상을 선택합니다. 선택기를 사용하여 새 색상을 선택합니다.
1. 레이블에 대한 변경 사항을 저장하려면, 체크 표시 아이콘을 선택합니다.
1. 이제 변경된 레이블이 사용 가능한 레이블 목록에 표시됩니다. 또한 해당 레이블을 사용하는 문제의 수를 확인할 수 있습니다.
**참고**
각 레이블 옆에 표시되는 번호를 선택해 **모든 문제** 페이지로 이동하고 해당 레이블이 포함된 모든 문제를 볼 수 있습니다.
# 레이블 삭제
현재 CodeCatalyst에서 문제 레이블을 삭제할 수 없습니다. 모든 문제에서 레이블을 제거하면, 레이블이 문제 **설정**의 **레이블** 섹션에서 **미사용 레이블** 섹션에 표시됩니다. 미사용 레이블은 필터를 사용하거나 문제에 레이블을 추가할 때 레이블 목록 마지막에 나타납니다. 문제 **설정** 에서 모든 레이블(사용 및 미사용) 및 해당 레이블이 있는 문제에 대한 개요를 확인할 수 있습니다.
# 사용자 지정 필드를 사용하여 작업 구성
사용자 지정 필드를 생성하여, 프로젝트의 작업을 구성하고 볼 때 도움을 받을 수 있습니다. 사용자 지정 필드는 **필터**의 사용 가능한 필터 목록에 추가되므로 사용자 지정 필드별로 문제를 필터링할 수 있습니다. 사용자 지정 필드는 이름과 값 페어입니다. 사용자 지정 필드의 이름을 기준으로 필터링한 다음 해당 사용자 지정 필드의 값을 기준으로 필터링합니다.
문제에는 여러 사용자 지정 필드가 있을 수 있습니다.
## 사용자 지정 필드 생성
CodeCatalyst에서 문제를 생성하거나 기존 문제를 편집할 때 사용자 지정 필드를 추가하여 사용자 지정 필드를 생성합니다. 자세한 내용은 [CodeCatalyst에서 문제 생성](issues-create-issue.md) 및 [CodeCatalyst의 문제 편집 및 공동 작업](issues-edit-collaborate-issue.md) 섹션을 참조하세요.
## 사용자 지정 필드 삭제
사용자 지정 필드를 삭제하려면 사용자 지정 필드를 추가한 각 문제에서 사용자 지정 필드를 제거해야 합니다. 사용자 지정 필드가 삭제되면 **필터**에 사용자 지정 필드가 더 이상 표시되지 않습니다. 필터를 사용하여 사용자 지정 필드가 있는 모든 문제를 보고, 문제를 편집하여 사용자 지정 필드를 제거할 수 있습니다. 자세한 내용은 [문제 찾기 및 보기](issues-view.md) 및 [문제 편집](issues-edit-issue.md) 섹션을 참조하세요.
# 사용자 지정 상태로 작업 추적
보드에서 사용자 지정 상태를 추가할 수 있습니다. 각 사용자 지정 상태는 **초안**, **시작되지 않음**, **시작됨** 또는 **완료됨** 범주 중 하나에 속해야 합니다. 상태 범주는 상태를 구성하고 기본 보기를 채우는 데 사용됩니다. 상태 및 상태 범주에 대한 자세한 내용은 [상태 및 상태 범주](issues-concepts.md#issues-concepts-status-definition) 섹션을 참조하고 보기에 대한 자세한 내용은 [문제 찾기 및 보기](issues-view.md) 섹션을 참조하세요.
# 상태 생성
1. 탐색 창에서 **문제**를 선택합니다.
1. **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열고 **설정**을 선택합니다.
1. **상태**에서 상태를 지정할 범주 옆에 있는 더하기 아이콘을 선택합니다.
1. 상태 이름을 지정한 다음 체크 표시 아이콘을 선택합니다.
**참고**
X 아이콘을 선택하여 상태 추가를 취소합니다.
이제 사용자 지정 상태가 보드에 표시되며 문제를 생성할 때 옵션으로 표시됩니다.
# 상태를 편집하려면
1. 탐색 창에서 **문제**를 선택합니다.
1. **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열고 **설정**을 선택합니다.
1. **상태**에서 편집하거나 변경할 상태 옆에 있는 편집 아이콘을 선택합니다.
1. 상태를 편집한 다음, 체크 표시 아이콘을 선택합니다.
이제 편집된 상태가 보드에 표시됩니다.
# 상태를 이동하려면
1. 탐색 창에서 **문제**를 선택합니다.
1. 줄임표 아이콘을 선택하고 **설정**을 선택합니다.
1. **상태**에서 이동할 상태를 선택합니다.
1. 선택한 상태를 원하는 곳에 끌어다 놓습니다.
**참고**
지정된 범주 내에서만 상태를 이동할 수 있습니다.
이제 보드에서 상태가 재정렬됩니다.
# 상태를 비활성화하려면
1. 탐색 창에서 **문제**를 선택합니다.
1. **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열고 **설정**을 선택합니다.
1. **상태**에서 비활성화할 상태를 선택합니다.
1. 비활성화하려는 상태에서 상태 토글을 선택합니다. 이제 해당 상태가 회색으로 표시됩니다.
**참고**
비활성화된 상태는 모든 문제가 보드 밖으로 이동할 때까지 보드에 표시됩니다. 비활성화된 상태에는 문제를 추가할 수 없습니다.
1. 비활성화된 상태를 다시 활성화하려면 상태 토글을 선택합니다. 해당 상태는 더 이상 회색으로 표시되지 않습니다.
**참고**
각 범주에는 활성 상태가 하나 이상 있어야 합니다. 범주에 상태가 하나만 있는 경우, 해당 상태는 비활성화할 수 없습니다.
# 문제에 대한 노력 추정 구성
CodeCatalyst의 문제에 대한 노력 추정의 설정을 구성하려면 다음 단계를 따르세요.
**문제에 대한 노력 추정을 구성하려면**
1. 탐색 창에서 **문제**를 선택합니다.
1. **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열고 **설정**을 선택합니다.
1. **기본 설정** 섹션의 **추정**에서 추정 값이 표시되는 방법을 선택합니다. 사용 가능한 추정 유형은 **티셔츠 크기 조정,** **Fibonacci 시퀀싱** 또는 **추정 숨기기**입니다. 추정 유형이 업데이트되면, 데이터가 손실되지 않고 모든 문제의 추정 값이 자동으로 변환됩니다. 변환 매핑은 다음 표에 나와 있습니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/issues-settings-estimation.html)
# 다수의 담당자 활성화 또는 비활성화
CodeCatalyst의 문제에 다수의 담당자에 대한 설정을 구성하려면 다음 단계를 따르세요.
**다수의 담당자를 활성화 또는 비활성화하려면**
1. 탐색 창에서 **문제**를 선택합니다.
1. **활성 문제**를 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열고 **설정**을 선택합니다.
1. **기본 설정** 섹션의 **담당자**에서 표시기를 전환하여 다수의 담당자가 동일한 문제에 할당될 수 있도록 합니다. 한 문제에는 최대 10명의 담당자가 있을 수 있습니다. 이 옵션을 활성화하지 않으면, 한 문제에 한 명의 담당자만 할당할 수 있습니다.
# 문제 보기 생성
[보기](issues-concepts.md#issues-concepts-views-definition)를 생성하여 특정 필터 집합과 일치하는 문제를 빠르게 볼 수 있습니다. 이렇게 하면 시간을 절약하고 이전에 필터링, 그룹화 또는 정렬한 문제를 빠르게 확인할 수 있습니다.
**문제 보기를 생성하려면**
1. 탐색 창에서 **문제**를 선택합니다.
1. (선택 사항) 사용 사례에 따라 기존 보기에서 보기를 생성할 수 있습니다. 다른 보기로 이동하려면 **활성 문제를** 선택하여 **문제 보기 전환기** 드롭다운 메뉴를 열고 보기를 선택합니다.
1. (선택 사항) 보기를 생성하기 전에 필터, 그룹화 및 정렬을 구성합니다. 보기를 생성할 때 이러한 항목을 추가할 수 있지만, 이전에 보기를 생성한 경우 보기를 생성하기 전에 보기에 표시된 내용을 미리 볼 수 있습니다.
1. 헤더 표시줄에서 **문제 보기 전환기** 드롭다운 메뉴를 엽니다. 상태에 따라 열에서 문제가 표시되는 보드 보기를 생성하려면 **보드** 열에서 **\$1**를 선택합니다. 목록에서 문제가 표시되는 그리드 보기를 생성하려면 **그리드** 열에서 **\$1**를 선택합니다. 생각이 바뀌었다면 보기가 생성되기 전에 보기 유형을 변경할 수 있습니다.
1. **보기 생성** 대화 상자에서 보기 이름을 입력하고 **생성**을 선택합니다.
1. **필터**, **문제 그룹화 기준** 및 **문제 정렬 기준** 필드는 현재 보기 설정에 따라 채워집니다. 필요한 경우 업데이트를 하세요.
1. **보기 생성**을 선택하여 보기를 생성하고 보기로 전환합니다.
# CodeCatalyst 문제에 대한 할당량
다음 표에서는 Amazon CodeCatalyst 의 문제에 대한 할당량 및 한도에 대해 설명합니다. Amazon CodeCatalyst의 할당량에 대한 자세한 내용은 [CodeCatalyst 할당량](quotas.md) 섹션을 참조하세요.
| 리소스 | 기본 할당량 |
| --- | --- |
| 활성 문제 | 프로젝트당 최대 1,000개. |
| 첨부 파일 크기 | 첨부 파일당 최대 500MB. 최대 총 첨부 파일 스토리지는 스페이스의 전체 스토리지 제한에 영향을 받습니다. 자세한 내용은 [요금](https://codecatalyst.aws/explore/pricing)을 참조하세요. |
| 총 문제 수(활성 및 보관) | 프로젝트당 최대 100,000개. |
| 저장된 보기 | 프로젝트당 최대 50개의 저장된 문제 보기. |
| 문제에 연결 가능한 풀 요청 수 | 문제당 풀 요청 최대 50개. |
| 상태(프로젝트당) | 프로젝트당 최대 50개. |
| 상태(문제당) | 문제당 최대 50개. |
| 레이블(프로젝트당) | 프로젝트당 최대 200개. |
| 레이블(문제당) | 문제당 최대 50개. |
| 사용자 지정 필드(문제당) | 문제당 최대 50개. |
| 담당자 | 문제당 최대 10명. |
| 설명 | 문제당 최대 1,000개. |
| 작업 | 문제당 최대 100개. |