풀 요청 생성 - Amazon CodeCatalyst

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

풀 요청 생성

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

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

참고

풀 요청을 생성하는 동안 표시되는 차이는 소스 브랜치의 팁과 대상 브랜치의 팁 간의 차이입니다. 풀 요청이 생성되면 표시된 차이는 선택한 풀 요청의 개정과 풀 요청을 생성할 때 대상 브랜치의 팁이었던 커밋 간의 차이입니다. Git의 차이점 및 병합 기반에 대한 자세한 내용은 Git 설명서git-merge-base의 섹션을 참조하세요.

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

참고
참고

Amazon Bedrock :implements 자동 남용 탐지로 구동됩니다. AWS https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html 나에 대한 설명 쓰기, 콘텐츠 요약 생성, 작업 권장, Amazon Q를 사용하여 프로젝트에 기능을 생성하거나 추가, Amazon Q Developer Agent for 소프트웨어 개발 기능을 사용하여 Amazon Q 기능에 문제 할당이 Amazon Bedrock에 구축되므로 사용자는 Amazon Bedrock에서 구현된 제어 기능을 최대한 활용하여 안전, 보안 및 인공 지능(AI)의 책임 있는 사용을 적용할 수 있습니다.

풀 요청을 생성하려면

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

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

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

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

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

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

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

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

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

  7. (선택 사항) 풀 요청 설명 에서 문제에 대한 링크 또는 변경 사항에 대한 설명과 같은 정보를 제공합니다.

    작은 정보

    풀 요청에 포함된 변경 사항에 대한 설명을 자동으로 생성하도록 설명 쓰기를 선택할 수 있습니다. CodeCatalyst 풀 요청에 설명을 추가한 후 자동으로 생성된 설명을 변경할 수 있습니다.

    이 기능을 사용하려면 생성형 AI 기능이 공간에 대해 활성화되어 있고 연결된 리포지토리의 풀 요청에 사용할 수 없어야 합니다. 자세한 내용은 생성형 AI 기능 관리를 참조하세요.

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

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

    참고

    검토자를 필수 검토자와 선택적 검토자로 추가할 수 없습니다. 자신을 검토자로 추가할 수 없습니다.

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

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

  12. 풀 요청에 검토하려는 코드와 변경 사항이 포함되어 있다고 판단되면 생성을 선택합니다.

    참고

    풀 요청을 생성한 후 설명을 추가할 수 있습니다. 풀 요청 또는 파일의 개별 줄과 전체 풀 요청에 설명을 추가할 수 있습니다. @ 기호와 파일 이름을 사용하여 파일과 같은 리소스에 대한 링크를 추가할 수 있습니다.

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

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

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

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

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

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

    참고

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

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

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

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

    참고

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

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

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

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