Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 풀 요청 생성
<a name="pull-requests-create"></a>

풀 요청을 생성하면 변경 내용을 다른 브랜치에 병합하기 전에 다른 사용자가 코드 변경을 보고 검토할 수 있습니다. 먼저 코드 변경을 위한 브랜치를 생성합니다. 이 브랜치를 풀 요청의 소스 브랜치라고도 합니다. 리포지토리에 변경 사항을 커밋하고 푸시한 후, 소스 브랜치의 내용을 대상 브랜치의 내용과 비교하는 풀 요청을 생성할 수 있습니다.

Amazon CodeCatalyst 콘솔의 특정 브랜치, 풀 요청 페이지 또는 프로젝트 개요에서 풀 요청을 생성할 수 있습니다. 특정 브랜치에서 풀 요청을 생성하면 풀 요청 생성 페이지에 리포지토리 이름과 소스 브랜치가 자동으로 제공됩니다. 풀 요청을 생성하면 풀 요청에 대한 업데이트와 풀 요청이 병합되거나 종료되는 시기를 알려주는 이메일이 자동으로 수신됩니다.

**참고**  
풀 요청을 생성하는 동안 나타나는 차이는 소스 브랜치의 최신 커밋과 대상 브랜치의 최신 커밋의 차이입니다. 풀 요청이 생성되면, 표시된 차이는 선택한 풀 요청의 수정본과 풀 요청을 생성할 때 대상 브랜치의 가장 최신 커밋 간에 발생합니다. Git의 차이점 및 병합 기반에 대한 자세한 내용은 Git 설명서의 [git-merge-base](https://git-scm.com/docs/git-merge-base)를 참조하세요.

풀 요청을 생성할 때 **설명 쓰기** 기능을 사용하여 Amazon Q가 풀 요청에 포함된 변경 사항에 대한 설명을 자동으로 생성하도록 할 수 있습니다. 이 옵션을 선택하면 Amazon Q는 코드 변경 사항이 포함된 소스 브랜치와 이러한 변경 사항을 병합할 대상 브랜치 간의 차이를 분석합니다. 그런 다음 이러한 변경 사항에 대한 요약과 이러한 변경의 의도 및 효과에 대한 최상의 해석을 생성합니다. 이 기능은 CodeCatalyst 풀 요청에 대해 미국 서부(오리건) 리전에서만 사용할 수 있습니다. 연결된 리포지토리의 풀 요청에는 **설명 쓰기** 기능을 사용할 수 없습니다.

**참고**  
**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)을 책임 있게 사용할 수 있습니다.

**풀 요청을 생성하려면**

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

1. 다음 중 하나를 수행하세요.
   + 탐색 창에서 **코드**를 선택하고 **풀 요청**을 선택한 다음 **풀 요청 생성**을 선택합니다.
   + 리포지토리 홈 페이지에서 **추가**를 선택한 다음 **풀 요청 생성**을 선택합니다.
   + 프로젝트 페이지에서 **풀 요청 생성**을 선택합니다.

1. **소스 리포지토리**에서 지정된 소스 리포지토리가 커밋된 코드가 포함된 리포지토리인지 확인합니다. 이 옵션은 리포지토리의 메인 페이지에서 풀 요청을 생성하지 않은 경우에만 나타납니다.

1. **대상 브랜치**에서 코드를 검토한 후 병합할 브랜치를 선택합니다.

1. **소스 브랜치**에서 커밋된 코드가 포함된 브랜치를 선택합니다.

1. **풀 요청 제목**에 다른 사용자가 검토해야 할 사항과 이유를 이해하는 데 도움이 되는 제목을 입력합니다.

1. (선택 사항) **풀 요청 설명**에서 문제에 대한 연결 또는 변경 사항에 대한 설명과 같은 정보를 제공합니다.
**작은 정보**  
CodeCatalyst가 풀 요청에 포함된 변경 사항에 대한 설명을 자동으로 생성하도록 **설명 쓰기**를 선택할 수 있습니다. 자동으로 생성된 설명은 풀 요청에 추가한 후에 변경할 수 있습니다.  
이 기능을 사용하려면 스페이스에 생성형 AI 기능을 활성화해야 하며 연결된 리포지토리의 풀 요청에 사용할 수 없습니다. 자세한 내용은 [생성형 AI 기능 관리](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)를 참조하세요.

1. (선택 사항) **문제**에서 **문제 연결**을 선택한 다음 목록에서 문제를 선택하거나 해당 ID를 입력합니다. 문제를 연결 해제하려면 연결 해제 아이콘을 선택합니다.

1. (선택 사항) **필수 검토자**에서 **필수 검토자 추가**를 선택합니다. 프로젝트 멤버 목록에서 추가할 멤버를 선택합니다. 필수 검토자는 풀 요청을 대상 브랜치에 병합하기 전에 변경 사항을 승인해야 합니다.
**참고**  
검토자를 추가할 때 필수 검토자이면서 동시에 선택적 검토자로 추가할 수 없습니다. 자신을 검토자로 추가할 수 없습니다.

1. (선택 사항) **선택적 검토자**에서 **선택적 검토자 추가**를 선택합니다. 프로젝트 멤버 목록에서 추가할 멤버를 선택합니다. 선택적 검토자는 풀 요청을 대상 브랜치에 병합하기 전에 변경 사항을 요구 사항으로 승인할 필요가 없습니다.

1. 브랜치 간의 차이점을 검토합니다. 풀 요청에 표시되는 차이점은 소스 브랜치의 수정본과 풀 요청이 생성된 시점의 대상 브랜치의 헤드 커밋인 병합 기반 간의 변경 사항입니다. 변경 사항이 표시되지 않으면 브랜치가 동일하거나 소스와 대상 모두에 대해 동일한 브랜치를 선택했을 수 있습니다.

1. 풀 요청에 검토하려는 코드와 변경 사항이 포함되어 있다고 판단되면 **생성**을 선택합니다.
**참고**  
풀 요청을 생성한 후 설명을 추가할 수 있습니다. 풀 요청 또는 파일의 개별 줄 및 풀 요청 전반에 설명을 추가할 수 있습니다. @ 기호와 파일 이름을 사용하여 파일과 같은 리소스에 대한 연결을 추가할 수 있습니다.<a name="pull-requests-create-from-branch"></a>

**브랜치에서 풀 요청을 생성하려면**

1. 풀 요청을 생성하려는 프로젝트로 이동합니다.

1. 탐색 창에서 **소스 리포지토리**를 선택한 다음, 검토할 코드 변경 사항이 있는 브랜치를 포함하는 리포지토리를 선택합니다.

1. 기본 브랜치 이름 옆의 드롭다운 화살표를 선택한 다음, 목록에서 원하는 브랜치를 선택합니다. 리포지토리의 모든 브랜치를 보려면 **모두 보기**를 선택합니다.

1. **추가**를 선택한 다음 **풀 요청 생성**을 선택합니다.

1. 리포지토리와 소스 브랜치는 미리 선택되어 있습니다. **대상 브랜치**에서 코드를 검토한 후 병합할 브랜치를 선택합니다. **풀 요청 제목**에 다른 프로젝트 사용자가 검토해야 하는 내용과 이유를 이해하는 데 도움이 되는 제목을 입력합니다. 선택적으로 CodeCatalyst 의 관련 문제에 대한 링크를 붙여넣거나 변경 사항에 대한 설명을 추가하는 등 **풀 요청 설명** 에 자세한 정보를 제공합니다.
**참고**  
풀 요청 생성 이벤트를 위해 실행하도록 구성된 워크플로는 풀 요청의 대상 브랜치가 워크플로에 지정된 브랜치 중 하나와 일치하는 경우 풀 요청이 생성된 후 실행됩니다.

1. 브랜치 간의 차이점을 검토합니다. 변경 사항이 표시되지 않으면, 브랜치가 동일하거나, 소스와 대상 모두에 대해 동일한 브랜치를 선택했을 수 있습니다.

1. (선택 사항) **문제**에서 **문제 연결**을 선택한 다음 목록에서 문제를 선택하거나 해당 ID를 입력합니다. 문제를 연결 해제하려면 연결 해제 아이콘을 선택합니다.

1. (선택 사항) **필수 검토자**에서 **필수 검토자 추가**를 선택합니다. 프로젝트 멤버 목록에서 추가할 멤버를 선택합니다. 필수 검토자는 풀 요청을 대상 브랜치에 병합하기 전에 변경 사항을 승인해야 합니다.
**참고**  
검토자를 필수 검토자이면서 동시에 선택적 검토자로 추가할 수 없습니다. 자신을 검토자로 추가할 수 없습니다.

1. (선택 사항) **선택적 검토자**에서 **선택적 검토자 추가**를 선택합니다. 프로젝트 멤버 목록에서 추가할 멤버를 선택합니다. 선택적 검토자는 풀 요청을 대상 브랜치에 병합하기 전에 변경 사항을 승인할 필요가 없습니다.

1. 풀 요청에 검토하려는 변경 사항이 포함되어 있고 필수 검토자가 포함되어 있다고 판단되면, **생성**을 선택합니다.

브랜치가 풀 요청의 대상 브랜치와 일치하는 워크플로를 실행하도록 구성된 경우 풀 요청이 생성된 후 **풀 요청 세부** 정보 영역의 **개요**에서 해당 워크플로 실행에 대한 정보를 볼 수 있습니다. 자세한 내용은 [워크플로에 트리거 추가](workflows-add-trigger-add.md) 단원을 참조하십시오.