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

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

Tool navigation

이 기사에서

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

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

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

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

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

  1. 사용 GitHub CLI하려면 먼저 설치해야 합니다. GITHUB CLI 빠른 시작을(를) 참조하세요.

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

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

    gh repo clone OWNER/REPO

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

    gh repo fork OWNER/REPO --clone

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

    cd REPO

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

    git checkout -b YOUR-BRANCH-NAME

코드 작성 또는 편집

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

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

  • IDE 또는 텍스트 편집기에서 로컬로 파일을 편집합니다.
  • GitHub에서 해당 파일로 이동한 다음 를 클릭하여 파일을 직접 편집합니다.

자주 커밋하세요

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

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

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

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

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

끌어오기 요청 열기

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

  1. 리포지토리의 메인 페이지에서 풀 리퀘스트를 클릭한 다음, 새 풀 리퀘스트를 클릭합니다.
  2. 기본 분기의 경우 main은 이미 선택되어 있으며 일반적으로 병합할 기본 분기입니다.
  3. 비교 분기의 경우 변경 내용이 포함된 분기를 선택합니다.
  4. 끌어오기 요청 만들기를 클릭합니다.
  5. 변경한 내용과 이유를 설명하는 제목과 설명을 입력합니다.
  6. 검토할 준비가 된 끌어오기 요청 또는 초안 상태에 있는 끌어오기 요청을 만들 수 있습니다.
  • 검토할 준비가 되면 끌어오기 요청 만들기를 클릭합니다.
  • 진행 중인 작업을 공유하려면 드롭다운을 사용하고 초안 끌어오기 요청 만들기를 선택합니다.

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

  • 검토할 준비가 된 경우:

    gh pr create

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

    gh pr create --draft

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

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

검토 요청

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

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

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

주소 검토 피드백

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

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

병합 및 배포

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

팁

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

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

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

다음 단계

첫 번째 끌어오기 요청 후 다른 사람의 작업을 검토해 보세요. 끌어오기 요청을 검토하기 위한 빠른 시작을(를) 참조하세요.

추가 읽기