# 문제 만들기

문제는 다양한 방법으로 만들 수 있으므로 워크플로에 가장 편리한 방법을 선택하면 됩니다.

이슈는 버그, 향상된 기능 또는 기타 요청을 추적하는 데 사용할 수 있습니다. 자세한 내용은 [문제 개요](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/learning-about-issues/about-issues)을(를) 참조하세요.

리포지토리 관리자는 리포지토리에 대한 문제를 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 [이슈 사용 안 함](/ko/enterprise-server@3.22/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues)을(를) 참조하세요.

## 리포지토리에서 이슈 만들기

1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

2. 리포지토리 이름 아래에서 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-issue-opened" aria-label="issue-opened" role="img"><path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z"></path></svg> Issues**를 클릭합니다.

   ![리포지토리의 기본 페이지 스크린샷. 가로 탐색 모음에서 "문제" 레이블이 지정된 탭이 진한 주황색으로 표시됩니다.](/assets/images/help/repository/repo-tabs-issues-global-nav-update.png)

3. **새 문제**를 클릭합니다.

4. 리포지토리에서 이슈 템플릿을 사용하는 경우 열려는 이슈 유형 옆에 있는 **시작**을 클릭합니다.

   열려고 하는 문제의 유형이 사용 가능한 옵션에 포함되어 있지 않은 경우, **빈 이슈 열기**를 클릭합니다.

![문제에 대한 템플릿 선택기의 스크린샷. 템플릿 선택 항목 아래에는 "빈 문제 열기"라는 레이블이 지정된 링크가 진한 주황색으로 표시됩니다.](/assets/images/help/issues/blank-issue-link.png)

1. "제목" 필드에서 문제에 대한 제목을 입력합니다.

2. 메모 본문 필드에 문제에 대한 설명을 입력합니다.
   관련 토론을 상호 참조하려면 토론의 URL을 문제 설명에 붙여넣습니다.

3. 프로젝트 유지 관리자인 경우 [다른 사람에게 문제를 할당하거나, 문제에](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users)[추가프로젝트](/ko/enterprise-server@3.22/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#assigning-a-project-from-within-an-issue-or-pull-request)하거나, [중요 시점과 연결](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/associating-milestones-with-issues-and-pull-requests)하거나, [문제 유형을 설정](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/editing-an-issue#adding-or-changing-the-issue-type)하거나, [레이블을 적용](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/managing-labels)할 수 있습니다.

4. 완료되면 **새 문제 제출**을 클릭합니다.

## 주석에서 이슈 만들기

이슈 또는 끌어오기 요청의 주석에서 새 이슈를 열 수 있습니다. 주석에서 이슈를 열면 주석이 원래 게시된 위치를 보여 주는 코드 조각이 이슈에 포함됩니다.

1. 이슈를 열려는 주석으로 이동합니다.

2. 해당 댓글에서 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Show options" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>을 클릭합니다.

   ![끌어오기 요청의 댓글 스크린샷. 케밥 메뉴 버튼이 진한 주황색 선으로 표시되어 있습니다.](/assets/images/help/pull_requests/kebab-in-pull-request-review-comment.png)

3. **새 이슈의 참조**를 클릭합니다.

4. "리포지토리" 드롭다운 메뉴를 사용하여 이슈를 열려는 리포지토리를 선택합니다.

5. 이슈에 대해 설명이 포함된 제목과 본문을 입력합니다.

6. **이슈 만들기**를 클릭합니다.

7. 프로젝트 유지 관리자인 경우 [다른 사람에게 문제를 할당하거나, 문제에](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users)[추가프로젝트](/ko/enterprise-server@3.22/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#assigning-a-project-from-within-an-issue-or-pull-request)하거나, [중요 시점과 연결](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/associating-milestones-with-issues-and-pull-requests)하거나, [문제 유형을 설정](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/editing-an-issue#adding-or-changing-the-issue-type)하거나, [레이블을 적용](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/managing-labels)할 수 있습니다.

8. 완료되면 **새 문제 제출**을 클릭합니다.

## 코드에서 이슈 만들기

파일 또는 끌어오기 요청의 특정 줄 또는 코드 줄에서 새 이슈를 열 수 있습니다. 코드에서 이슈를 열면 선택한 코드 줄 또는 범위를 보여 주는 코드 조각이 이슈에 포함됩니다. 코드가 저장된 동일한 리포지토리에서만 이슈를 열 수 있습니다.

1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

2. 이슈에서 참조할 코드를 찾습니다.
   * 파일의 코드에 대한 이슈를 열려면 파일로 이동합니다.
   * 끌어오기 요청에서 코드에 대한 문제를 열려면 끌어오기 요청으로 이동하고 **변경된 파일을 클릭합니다<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-diff" aria-label="diff" role="img"><path d="M8.75 1.75V5H12a.75.75 0 0 1 0 1.5H8.75v3.25a.75.75 0 0 1-1.5 0V6.5H4A.75.75 0 0 1 4 5h3.25V1.75a.75.75 0 0 1 1.5 0ZM4 13h8a.75.75 0 0 1 0 1.5H4A.75.75 0 0 1 4 13Z"></path></svg>**. 그런 다음, 주석에 포함할 코드가 포함된 파일을 찾아 **보기**를 클릭합니다.

3. 한 줄 또는 범위를 선택할지 여부를 선택합니다.

   * 한 줄의 코드를 선택하려면 줄 번호를 클릭하여 줄을 강조 표시합니다.
   * 코드 범위를 선택하려면 범위의 첫 번째 줄 수를 클릭하여 코드 줄을 강조 표시합니다. 그런 다음 코드 범위의 마지막 줄 위로 마우스를 가져가고 <kbd>Shift</kbd> 키를 누른 다음 줄 번호를 클릭하여 범위를 강조 표시합니다.

4. 코드 범위의 왼쪽에서 을 클릭합니다 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Code line X options" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>. 드롭다운 메뉴에서 **새 문제의 참조**를 클릭합니다.

![8줄이 선택된 파일의 스크린샷. 첫 번째 선택한 줄의 왼쪽에는 케밥 아이콘으로 레이블이 지정된 단추가 진한 주황색으로 표시됩니다.](/assets/images/help/repository/open-new-issue-specific-line.png)

1. "제목" 필드에서 문제에 대한 제목을 입력합니다.
2. 메모 본문 필드에 문제에 대한 설명을 입력합니다.
3. 프로젝트 유지 관리자인 경우 [다른 사람에게 문제를 할당하거나, 문제에](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users)[추가프로젝트](/ko/enterprise-server@3.22/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#assigning-a-project-from-within-an-issue-or-pull-request)하거나, [중요 시점과 연결](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/associating-milestones-with-issues-and-pull-requests)하거나, [문제 유형을 설정](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/editing-an-issue#adding-or-changing-the-issue-type)하거나, [레이블을 적용](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/managing-labels)할 수 있습니다.
4. 완료되면 **새 문제 제출**을 클릭합니다.

## 토론에서 이슈 만들기

리포지토리에 대한 심사 권한이 있는 사용자는 토론에서 이슈를 만들 수 있습니다.

토론에서 이슈를 만들면 토론 게시물의 내용이 이슈 본문에 자동으로 포함되고 레이블이 유지됩니다. 토론에서 이슈를 만들면 토론이 이슈로 변환되거나 기존 토론이 삭제되지 않습니다.
GitHub Discussions에 대한 자세한 내용은 [토론에 대한 정보](/ko/enterprise-server@3.22/discussions/collaborating-with-your-community-using-discussions/about-discussions)을(를) 참조하세요.

1. 리포지토리 이름이나 조직 이름에서 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-comment-discussion" aria-label="comment-discussion" role="img"><path d="M1.75 1h8.5c.966 0 1.75.784 1.75 1.75v5.5A1.75 1.75 0 0 1 10.25 10H7.061l-2.574 2.573A1.458 1.458 0 0 1 2 11.543V10h-.25A1.75 1.75 0 0 1 0 8.25v-5.5C0 1.784.784 1 1.75 1ZM1.5 2.75v5.5c0 .138.112.25.25.25h1a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h3.5a.25.25 0 0 0 .25-.25v-5.5a.25.25 0 0 0-.25-.25h-8.5a.25.25 0 0 0-.25.25Zm13 2a.25.25 0 0 0-.25-.25h-.5a.75.75 0 0 1 0-1.5h.5c.966 0 1.75.784 1.75 1.75v5.5A1.75 1.75 0 0 1 14.25 12H14v1.543a1.458 1.458 0 0 1-2.487 1.03L9.22 12.28a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215l2.22 2.22v-2.19a.75.75 0 0 1 .75-.75h1a.25.25 0 0 0 .25-.25Z"></path></svg> 토론**을 클릭합니다.

   ![GitHub 리포지토리의 탭 스크린샷. "토론"에 진한 주황색 윤곽선이 표시됩니다.](/assets/images/help/discussions/repository-discussions-tab-global-nav-update.png)

2. 토론 목록에서 보려는 토론을 클릭합니다.

3. 오른쪽 사이드바에서 **토론에서 문제 만들기를 클릭합니다<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-issue-opened" aria-label="issue-opened" role="img"><path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z"></path></svg>**.

   ![토론의 사이드바 스크린샷. "토론에서 문제 만들기" 옵션이 진한 주황색으로 표시되어 있습니다.](/assets/images/help/discussions/create-issue-from-discussion.png)

4. "제목" 필드에서 문제에 대한 제목을 입력합니다.

5. 메모 본문 필드에 문제에 대한 설명을 입력합니다.

6. 프로젝트 유지 관리자인 경우 [다른 사람에게 문제를 할당하거나, 문제에](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users)[추가프로젝트](/ko/enterprise-server@3.22/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#assigning-a-project-from-within-an-issue-or-pull-request)하거나, [중요 시점과 연결](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/associating-milestones-with-issues-and-pull-requests)하거나, [문제 유형을 설정](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/editing-an-issue#adding-or-changing-the-issue-type)하거나, [레이블을 적용](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/managing-labels)할 수 있습니다.

7. 완료되면 **새 문제 제출**을 클릭합니다.

## 프로젝트에서 이슈 만들기

프로젝트를 종료하지 않고도 신속하게 문제를 만들 수 있습니다. 필드별로 그룹화된 보기를 사용하는 경우 해당 그룹에서 이슈를 만들면 새 이슈의 필드가 자동으로 그룹의 값으로 설정됩니다. 예를 들어 보기를 "상태"로 그룹화하면 "Todo" 그룹에서 이슈를 만들 때 새 이슈의 "상태"가 자동으로 "Todo"로 설정됩니다. 프로젝트에 대한 자세한 내용은 [Projects 정보](/ko/enterprise-server@3.22/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)을 참조하세요.

1. 프로젝트로 이동합니다.

2. 테이블, 항목 그룹 또는 보드 레이아웃의 열 아래쪽에서 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-plus" aria-label="plus icon" role="img"><path d="M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z"></path></svg>을(를) 클릭합니다.

   ![테이블 보기의 아래쪽 행을 보여 주는 스크린샷입니다. "+" 단추가 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/projects-v2/omnibar-add.png)

3. **새 이슈 만들기**를 클릭합니다.

4. "새 이슈 만들기" 대화 상자의 맨 위에서 새 이슈를 만들 리포지토리를 선택합니다.

   !["새 이슈 만들기" 대화 상자를 보여주는 스크린샷입니다.](/assets/images/help/projects-v2/issue-create-form.png)

5. 리포지토리 드롭다운 아래에 새 이슈의 제목을 입력합니다.

6. 필요에 따라 제목 필드 아래의 필드를 사용하여 담당자, 레이블 및 마일스톤을 설정하고 새 이슈를 다른 프로젝트에 추가합니다.

7. 필요에 따라 이슈에 대한 설명을 입력합니다.

8. 필요에 따라 더 많은 이슈를 만들려면 **더 만들기**를 선택하면 이슈를 만들 때 대화 상자가 다시 열립니다.

9. **만들기**를 클릭합니다.

## URL 쿼리에서 이슈 만들기

쿼리 매개 변수를 사용하여 이슈를 열 수 있습니다. 쿼리 매개 변수는 검색 필터 결과 또는 문제 템플릿 GitHub과 같은 특정 웹 페이지 보기를 공유하도록 사용자 지정할 수 있는 URL의 선택적 부분입니다. 사용자 고유의 쿼리 매개 변수를 만들려면 키 및 값 쌍과 일치해야 합니다.

> \[!TIP]
> 기본 레이블, 담당자, 문제 제목을 사용하여 열리는 이슈 템플릿을 만들 수도 있습니다. 자세한 내용은 [템플릿을 사용하여 유용한 이슈 및 끌어오기 요청 권장](/ko/enterprise-server@3.22/communities/using-templates-to-encourage-useful-issues-and-pull-requests)을(를) 참조하세요.

해당하는 쿼리 매개 변수를 사용하려면 모든 작업에 대한 적절한 사용 권한이 있어야 합니다. 예를 들어 `labels` 쿼리 매개 변수를 사용하려면 이슈에 레이블을 추가할 수 있는 사용 권한이 있어야 합니다. 자세한 내용은 [조직의 리포지토리 역할](/ko/enterprise-server@3.22/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization)을(를) 참조하세요.

쿼리 매개 변수를 사용하여 잘못된 URL을 만들거나 적절한 사용 권한이 없는 경우, URL은 `404 Not Found` 오류 페이지를 반환합니다. 서버 한도를 초과하는 URL을 만들면 URL이 `414 URI Too Long` 오류 페이지를 반환합니다.

| 쿼리 매개 변수                                                                                                                                                                                                                                                        | 예시 |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `title`                                                                                                                                                                                                                                                         |    |
| `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report`는 레이블 "bug"와 제목 "New bug report"를 사용하여 이슈를 만듭니다.                                                                                                                              |    |
| `body`                                                                                                                                                                                                                                                          |    |
| `https://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem.`은 이슈 본문에 제목 "New bug report" 및 주석 "Describe the problem"을 사용하여 이슈를 만듭니다.                                                                                      |    |
| `labels`                                                                                                                                                                                                                                                        |    |
| `https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug`는 "help wanted" 및 "bug" 레이블을 가진 문제를 생성합니다.                                                                                                                                             |    |
| `milestone`                                                                                                                                                                                                                                                     |    |
| `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones`는 "testing milestones"라는 마일스톤에 이슈를 만듭니다.                                                                                                                                         |    |
| `assignees`                                                                                                                                                                                                                                                     |    |
| `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat`은 이슈를 만들고 @octocat에 할당합니다.                                                                                                                                                                  |    |
| `projects`                                                                                                                                                                                                                                                      |    |
| `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1`은 제목 "Bug fix"(버그 수정)를 사용하여 이슈를 만들고 조직의 프로젝트 1에 추가합니다.                                                                                                                      |    |
| `template`                                                                                                                                                                                                                                                      |    |
| `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md`는 이슈 본문의 템플릿을 사용하여 이슈를 만듭니다.                                                                                                                                                       |    |
| `template` 쿼리 매개 변수는 루트 내 `ISSUE_TEMPLATE` 하위 디렉터리에 저장된 템플릿, `docs/` 또는 리포지토리의 `.github/` 디렉터리에서 작동합니다. 자세한 내용은 [템플릿을 사용하여 유용한 이슈 및 끌어오기 요청 권장](/ko/enterprise-server@3.22/communities/using-templates-to-encourage-useful-issues-and-pull-requests)을(를) 참조하세요. |    |

## GitHub CLI을 사용하여 문제 만들기

GitHub CLI는 컴퓨터의 명령줄에서 GitHub를 사용하기 위한 오픈 소스 도구입니다. 명령줄에서 작업하는 경우 GitHub CLI을(를) 사용하여 시간을 절약하고 컨텍스트 전환을 방지할 수 있습니다.자세한 내용은 GitHub CLI[GitHub CLI 정보](/ko/enterprise-server@3.22/github-cli/github-cli/about-github-cli)을 참조하세요.

이슈를 만들려면 `gh issue create` 하위 명령을 사용합니다. 대화형 프롬프트를 건너뛰려면 `--body` 및 `--title` 플래그를 포함합니다.

```shell
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION"
```

담당자, 레이블, 마일스톤 및 프로젝트를 지정할 수도 있습니다.

```shell
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --assignee @me,USERNAME --label "LABEL-1,LABEL-2" --project PROJECT-NAME --milestone "MILESTONE-NAME"
```

문제 유형을 설정하려면 플래그를 `--type` 사용합니다.

```shell
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --type "ISSUE-TYPE"
```

기존 부모의 하위 문제로 문제를 만들려면 문제 번호 또는 URL이 `--parent` 있는 플래그를 사용합니다.

```shell
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --parent PARENT-ISSUE-NUMBER
```

## 추가 참고 자료

* [GitHub에 쓰기](/ko/enterprise-server@3.22/get-started/writing-on-github)