# 끌어오기 요청에 대한 빠른 시작

첫 번째 변경 사항을 제안하고 첫 커밋부터 병합된 풀 리퀘스트까지 전 과정을 진행해 보세요.

끌어오기 요청은 다른 사용자가 병합되기 전에 변경 내용을 검토할 수 있도록 주 코드 베이스와 별도로 분기에 변경 내용을 제안합니다. 이 빠른 시작에서는 끌어오기 요청에 대한 가장 간단한 경로를 안내합니다. 분기를 만들고, 변경 및 커밋하고, 끌어오기 요청을 열고, 피드백에 응답하고, 병합합니다.

위의 탭 중 하나를 선택하여 GitHub 웹사이트 또는 GitHub CLI에서 따라할 수 있습니다.

## 리포지토리를 브랜치하거나 포크하세요

먼저 격리된 작업 장소를 만듭니다.

<div class="ghd-tool webui">

1. 에서 GitHub변경 내용을 제안하려는 리포지토리의 기본 페이지로 이동합니다.
2. 선택적으로, 쓰기 권한이 없다면 포크해야 합니다. 오른쪽 위 모서리에서 **포크** 를 클릭하고 단계를 따릅니다. 그런 다음 리포지토리의 포크에서 계속합니다.
3. 파일 목록 맨 위에 있는 분기 선택기 메뉴를 클릭합니다. 아마 **main**이라고 되어 있을 거예요. 새 분기 이름을 입력하고 **기본에서 분기 *new-branch-name* 만들기를** 클릭합니다.

</div>

<div class="ghd-tool cli"> 

1. 사용 GitHub CLI하려면 먼저 설치해야 합니다.
   [GITHUB CLI 빠른 시작](/ko/enterprise-server@3.20/github-cli/github-cli/quickstart)을(를) 참조하세요.

2. 리포지토리를 복제합니다. 또는 리포지토리를 포크하고 동시에 로컬로 복제합니다.

* 리포지토리에 대한 쓰기 권한이 있는 경우 리포지토리를 복제합니다.

  ```shell
  gh repo clone OWNER/REPO
  ```

* 쓰기 권한이 없는 경우 먼저 **포크** 를 만들고 한 번에 모두 복제합니다.

  ```shell
  gh repo fork OWNER/REPO --clone
  ```

1. 복제된 리포지토리 디렉터리로 변경합니다.

   ```shell
   cd REPO
   ```

2. 새 분기를 만들고 전환합니다.

   ```shell
   git checkout -b YOUR-BRANCH-NAME
   ```

</div>

## 코드 작성 또는 편집

브랜치에서 변경 사항을 적용하세요. 첫 번째 끌어오기 요청의 경우 변경 내용을 집중적이고 단순하게 유지합니다. 더 작은 끌어오기 요청은 더 빠르게 검토하고 병합하기 쉽습니다.

다음 중 하나를 시도하여 변경합니다.

* IDE 또는 텍스트 편집기에서 로컬로 파일을 편집합니다.
* GitHub에서 해당 파일로 이동한 다음 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit this file" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>를 클릭하여 파일을 직접 편집합니다.

## 자주 커밋하세요

작고 의미 있는 커밋으로 작업을 저장합니다. 각 커밋은 스냅샷과 변경 내용을 설명하는 메시지를 기록합니다.

<div class="ghd-tool cli">

```shell
git add .
git commit -m "Describe your change"
git push --set-upstream origin YOUR-BRANCH-NAME
```

</div>

<div class="ghd-tool webui">

GitHub에서 파일을 편집하고 커밋할 준비가 되면 커밋 메시지를 입력한 다음 브랜치에 직접 커밋합니다.

1. **변경 내용 커밋...** 을 클릭합니다.
2. **커밋 메시지** 상자에 변경 내용에 대한 간단한 설명을 입력합니다.
3. 작업 중인 분기를 선택합니다.
4. **변경 제안**을 클릭합니다.

변경 사항이 추가되고 해당 브랜치에 커밋됩니다.

</div>

## 끌어오기 요청 열기

브랜치에 제안하려는 변경 사항이 있으면 기본 브랜치를 대상으로 풀 리퀘스트를 엽니다.

<div class="ghd-tool webui">

1. 리포지토리의 메인 페이지에서 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-git-pull-request" aria-label="The pull request icon" role="img"><path d="M1.5 3.25a2.25 2.25 0 1 1 3 2.122v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.25 2.25 0 0 1 1.5 3.25Zm5.677-.177L9.573.677A.25.25 0 0 1 10 .854V2.5h1A2.5 2.5 0 0 1 13.5 5v5.628a2.251 2.251 0 1 1-1.5 0V5a1 1 0 0 0-1-1h-1v1.646a.25.25 0 0 1-.427.177L7.177 3.427a.25.25 0 0 1 0-.354ZM3.75 2.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm0 9.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm8.25.75a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Z"></path></svg> 풀 리퀘스트**를 클릭한 다음, **새 풀 리퀘스트**를 클릭합니다.
2. **기본** 분기의 경우 main은 이미 선택되어 있으며 일반적으로 병합할 기본 분기입니다.
3. **비교** 분기의 경우 변경 내용이 포함된 분기를 선택합니다.
4. **끌어오기 요청 만들기**를 클릭합니다.
5. 변경한 내용과 이유를 설명하는 제목과 설명을 입력합니다.
6. 검토할 준비가 된 끌어오기 요청 또는 초안 상태에 있는 끌어오기 요청을 만들 수 있습니다.

* 검토할 준비가 되면 **끌어오기 요청 만들기**를 클릭합니다.
* 진행 중인 작업을 공유하려면 드롭다운을 사용하고 **초안 끌어오기 요청 만들기**를 선택합니다.

</div>

<div class="ghd-tool cli">

검토할 준비가 된 끌어오기 요청 또는 초안 상태에 있는 끌어오기 요청을 만들 수 있습니다.

* 검토할 준비가 된 경우:

  ```shell
  gh pr create
  ```

* 진행 중인 작업을 공유하려면

  ```shell
  gh pr create --draft
  ```

그런 다음 프롬프트에 따라 기본 분기, 제목 및 설명을 설정합니다.

</div>

동일한 분기에 추가로 커밋하면 끌어오기 요청에 자동으로 추가됩니다.

## 검토 요청

**검토자** 상자를 통해 검토를 요청하려면 리포지토리에 대한 쓰기 액세스 권한이 필요하며 리포지토리에 대한 읽기 권한이 있는 사용자 또는 팀의 검토를 요청할 수 있습니다. 검토를 요청하는 경우 개인 또는 팀이 알림을 받게 됩니다. 경우에 따라 선택할 수 있는 제안된 검토자가 표시됩니다.

**검토자** 상자를 사용할 수 없는 경우 다음을 수행할 수 있습니다.

* 리포지토리의 README에서 풀 리퀘스트 검토에 대한 안내를 확인하고 그 지침을 따르세요.
* 검토를 대신해 줄 수 있는 사람을 알고 있다면 그 사람에게 연락하여 풀 리퀘스트 링크를 공유하세요.

## 주소 검토 피드백

검토자는 끌어오기 요청을 병합하기 전에 주석을 달거나, 변경 내용을 제안하거나, 변경 내용을 요청할 수 있습니다.

* 검토자의 제안을 수락하려면 **제안 커밋** (또는 여러 번 일괄 처리하고 **제안 커밋** 클릭)을 클릭합니다.
* 더 광범위하게 변경하려면 코드를 편집하고 새 커밋을 동일한 분기에 푸시합니다. 끌어오기 요청은 자동으로 업데이트되고 검사를 다시 실행합니다.
* 해결한 후 각 대화를 **해결됨** 으로 표시합니다.

## 병합 및 배포

필요한 검토 및 상태 검사가 통과되면 끌어오기 요청을 병합하여 변경 내용을 기본 분기로 가져옵니다. 변경 내용을 병합하지 않기로 결정한 경우 끌어오기 요청을 대신 닫을 수 있습니다.

> \[!TIP]
> 리포지토리에 따라 병합 요구 사항이 다를 수 있습니다. 관련 지침을 검토하고 지침을 따릅니다.

<div class="ghd-tool webui">

1. 끌어오기 요청 아래쪽에서 **끌어오기 요청 병합**을 클릭합니다.
2. **\[확인**]을 클릭하여 병합을 완료합니다.
3. (선택 사항) 헤드 분기를 삭제하여 리포지토리를 깔끔하게 유지합니다.

</div>

<div class="ghd-tool cli">

```shell
gh pr merge
```

프롬프트에 따라 병합 메서드를 선택하고 필요에 따라 분기를 삭제합니다.

</div>

## 다음 단계

첫 번째 끌어오기 요청 후 다른 사람의 작업을 검토해 보세요.
[끌어오기 요청을 검토하기 위한 빠른 시작](/ko/enterprise-server@3.20/pull-requests/get-started/reviewing-pull-requests-quickstart)을(를) 참조하세요.

## 추가 읽기

* [Writing code for a project](/ko/enterprise-server@3.20/pull-requests/concepts/writing-code-for-a-project)
* [끌어오기 요청](/ko/enterprise-server@3.20/pull-requests/reference/pull-requests)