풀 요청 생성 - 아마존 CodeCatalyst

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

풀 요청 생성

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

Amazon CodeCatalyst 콘솔에서 특정 브랜치, 풀 리퀘스트 페이지 또는 프로젝트 개요에서 풀 요청을 생성할 수 있습니다. 특정 브랜치에서 풀 리퀘스트를 생성하면 풀 리퀘스트 생성 페이지에 리포지토리 이름과 소스 브랜치가 자동으로 제공됩니다. 풀 리퀘스트를 생성하면 풀 리퀘스트에 대한 업데이트와 풀 리퀘스트가 합쳐지거나 닫힐 때 관련 이메일이 자동으로 수신됩니다.

참고

풀 리퀘스트를 생성하는 동안 표시되는 차이는 소스 브랜치의 끝과 대상 브랜치의 끝부분 간의 차이입니다. 풀 리퀘스트가 생성되면 선택한 풀 리퀘스트의 수정과 풀 리퀘스트를 생성할 때 대상 브랜치의 팁이었던 커밋 간의 차이가 표시됩니다. Git의 차이점과 병합 기준에 대한 자세한 내용은 Git git-merge-base설명서를 참조하십시오.

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

참고
참고

Amazon Bedrock 제공: 자동 악용 탐지 AWS 기능을 구현합니다. 나를 위한 설명 작성, 콘텐츠 요약 생성, 작업 추천, Amazon Q를 사용하여 프로젝트에 기능 생성 또는 추가, Amazon Q Developer Agent의 소프트웨어 개발 기능에 대한 Amazon Q 이슈 할당 기능이 Amazon Bedrock에 구축되어 있기 때문에 사용자는 Amazon Bedrock에 구현된 제어 기능을 최대한 활용하여 안전, 보안 및 인공 지능 (AI) 의 책임 있는 사용을 강화할 수 있습니다.

풀 리퀘스트를 생성하면 풀 리퀘스트를 생성할

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

  2. 다음 중 하나를 수행합니다.

    • 탐색 창에서 코드를 선택하고 풀 요청을 선택한 다음 풀 요청 생성을 선택합니다.

    • 리포지토리 홈 페이지에서 추가를 선택한 다음 풀 리퀘스트 생성을 선택합니다.

    • 프로젝트 페이지에서 풀 리퀘스트 생성을 선택합니다.

  3. 소스 리포지토리에서 지정된 소스 리포지토리가 커밋된 코드를 포함하는 리포지토리인지 확인합니다. 이 옵션은 리포지토리의 기본 페이지에서 풀 리퀘스트를 만들지 않은 경우에만 나타납니다.

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

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

  6. 풀 리퀘스트 제목에 다른 사용자가 검토해야 할 내용과 이유를 이해하는 데 도움이 되는 제목을 입력합니다.

  7. (선택 사항) 풀 요청 설명에 문제 링크 또는 변경 내용 설명과 같은 정보를 입력합니다.

    작은 정보

    Pull Request에 포함된 변경 사항에 대한 설명을 CodeCatalyst 자동으로 생성하도록 나를 위한 설명 쓰기를 선택할 수 있습니다. 자동으로 생성된 설명을 풀 리퀘스트에 추가한 후 변경할 수 있습니다.

    이 기능을 사용하려면 스페이스에 대해 제너레이티브 AI 기능을 활성화해야 하며 연결된 리포지토리의 풀 요청에는 사용할 수 없습니다. 자세한 내용은 제너레이티브 AI 기능 관리를 참조하십시오.

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

  9. (선택 사항) 필수 검토자에서 필수 검토자 추가를 선택합니다. 프로젝트 멤버 목록에서 선택하여 추가합니다. 풀 리퀘스트를 대상 브랜치에 병합하려면 먼저 필수 검토자가 변경 사항을 승인해야 합니다.

    참고

    검토자를 필수 검토자와 선택적 검토자로 모두 추가할 수는 없습니다. 자신을 리뷰어로 추가할 수 없습니다.

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

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

  12. 풀 리퀘스트에 검토하려는 코드와 변경 사항이 포함되어 있다고 판단되면 [Create] 를 선택합니다.

    참고

    풀 리퀘스트를 생성한 후 코멘트를 추가할 수 있습니다. 풀 리퀘스트나 파일의 개별 라인, 전체 풀 리퀘스트에 댓글을 추가할 수 있습니다. @ 기호 뒤에 파일 이름을 붙여 파일 등의 리소스에 링크를 추가할 수 있습니다.

브랜치에서 풀 리퀘스트를 만들려면

  1. 풀 리퀘스트를 만들려는 프로젝트로 이동합니다.

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

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

  4. 추가를 선택한 다음 풀 리퀘스트 생성을 선택합니다.

  5. 리포지토리와 소스 브랜치가 미리 선택됩니다. 대상 브랜치에서 검토 후 코드를 병합할 브랜치를 선택합니다. 풀 리퀘스트 제목에 다른 프로젝트 사용자가 검토해야 하는 내용과 그 이유를 이해하는 데 도움이 되는 제목을 입력합니다. 필요에 따라 풀 리퀘스트 설명란에 관련 문제 링크를 붙여넣거나 변경한 내용에 대한 설명을 추가하는 등 자세한 정보를 제공할 수 있습니다. CodeCatalyst

    참고

    풀 요청 생성 이벤트에 대해 실행되도록 구성된 워크플로는 풀 요청의 대상 브랜치가 워크플로에 지정된 브랜치 중 하나와 일치하는 경우 풀 요청이 생성된 후에 실행됩니다.

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

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

  8. (선택 사항) 필수 검토자에서 필수 검토자 추가를 선택합니다. 프로젝트 멤버 목록에서 선택하여 추가합니다. 풀 리퀘스트를 대상 브랜치에 병합하려면 먼저 필수 검토자가 변경 사항을 승인해야 합니다.

    참고

    필수 및 선택 사항으로 검토자를 추가할 수는 없습니다. 자신을 리뷰어로 추가할 수 없습니다.

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

  10. 풀 요청에 검토하려는 변경 사항과 필수 검토자가 포함되어 있다고 판단되면 [Create] 를 선택합니다.

브랜치가 풀 요청의 대상 브랜치와 일치하는 곳에서 실행되도록 구성된 워크플로가 있는 경우, 풀 리퀘스트가 생성된 후 풀 리퀘스트 세부 정보 영역의 개요에 해당 워크플로우 실행에 대한 정보가 표시됩니다. 자세한 내용은 워크플로에 트리거 추가 단원을 참조하십시오.