pull 요청를 위한 웹 미리 보기 - AWS Amplify 호스팅
웹 미리 보기를 활성화합니다.하위 도메인을 통한 웹 미리 보기 액세스

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

pull 요청를 위한 웹 미리 보기

웹 미리 보기는 개발 및 품질 보증(QA) 팀이 코드를 프로덕션 또는 통합 브랜치에 병합하기 전에 pull 요청(PR) 의 변경 사항을 미리 볼 수 있는 방법을 제공합니다. pull 요청를 사용하면 리포지토리의 브랜치에 푸시한 변경 내용을 다른 사람에게 알릴 수 있습니다. pull 요청가 열리면 공동 작업자와 잠재적 변경 사항을 논의 및 검토하고 변경 사항을 기본 브랜치에 병합하기 전에 후속 커밋을 추가할 수 있습니다.

참고

현재 Amplify의 미리 보기 브랜치는 GitLab, BitBucket을 지원하며 AWS CodeCommit에는 GitHub와 완전한 기능 패리티를 제공하지는 않습니다. AWS_PULL_REQUEST_ID 환경 변수는 GitHub를 리포지토리 공급자로 사용하는 경우에만 사용할 수 있습니다.

웹 미리 보기는 리포지토리에 대한 모든 pull 요청을 기본 사이트에서 사용하는 URL과 완전히 다른 고유한 미리 보기 URL에 배포합니다. Amplify CLI 또는 Amplify Studio를 사용하여 백엔드 환경이 프로비저닝된 앱의 경우 모든 pull 요청(프라이빗 Git 리포지토리만)은 PR이 종료될 때 삭제되는 임시 백엔드를 실행합니다.

PR 미리 보기의 단계로, PR을 열면 고유한 미리 보기 URL이 생성되고 PR이 병합되면 미리 보기 URL이 삭제됨을 보여줍니다.
중요

보안을 위해 개인 리포지토리가 있는 모든 앱에서 웹 미리 보기를 활성화할 수 있지만 공개 리포지토리가 있는 모든 앱에서는 활성화할 수 없습니다. Git 저장소가 공용인 경우 IAM 서비스 역할이 필요하지 않은 앱에 대해서만 미리 보기를 설정할 수 있습니다.

예를 들어 백엔드가 있는 앱과 WEB_COMPUTE 호스팅 플랫폼에 배포된 앱에는 IAM 서비스 역할이 필요합니다. 따라서 리포지토리가 퍼블릭인 경우 이러한 유형의 앱에 대해 웹 미리 보기를 활성화할 수 없습니다.

Amplify는 제3자가 앱의 IAM 역할 권한을 사용하여 실행되는 임의 코드를 제출하지 못하도록 이러한 제한을 적용합니다.

웹 미리 보기를 활성화합니다.

GitHub 리포지토리에 저장된 앱의 경우 미리 보기는 Amplify GitHub 앱을 사용하여 리포지토리에 액세스할 수 있습니다. 액세스를 위해 OAuth를 사용하여 이전에 GitHub 리포지토리에서 배포한 기존 Amplify 앱에서 웹 미리 보기를 활성화하려면 먼저 Amplify GitHub 앱을 사용하도록 앱을 마이그레이션해야 합니다. 마이그레이션 지침은 기존 OAuth 앱을 Amplify GitHub 앱으로 마이그레이션하기 단원을 참조하세요.

pull 요청의 웹 미리 보기를 활성화하려면

  1. 앱 설정, 미리 보기를 선택한 다음 미리 보기 활성화를 선택합니다.

    참고

    앱이 지속적 배포를 위해 설정되고 Git 리포지토리에 연결된 경우에만 앱 설정 메뉴에 미리 보기가 표시됩니다. 이러한 유형의 배포에 대한 지침은 기존 코드로 시작하기를 참조하세요.

  2. GitHub 리포지토리의 경우에만 다음을 수행하여 계정에 Amplify GitHub 앱을 설치하고 승인하세요.

    1. 미리 보기를 활성화하려면 GitHub 앱 설치 창에서 GitHub 앱 설치를 선택합니다.

    2. Amplify GitHub 앱을 구성하려는 GitHub 계정을 선택합니다.

    3. 계정에 대한 리포지토리 권한을 구성할 수 있는 페이지가 GitHub.com에서 열립니다.

    4. 다음 중 하나를 수행하세요.

      • 모든 리포지토리에 설치를 적용하려면 모든 리포지토리를 선택합니다.

      • 선택한 특정 리포지토리로 설치를 제한하려면 리포지토리만 선택을 선택합니다. 선택한 리포지토리에 웹 미리 보기를 활성화하려는 앱의 리포지토리를 포함해야 합니다.

    5. 저장을 선택합니다.

  3. 리포지토리의 미리 보기를 활성화한 후 Amplify 콘솔로 돌아가서 특정 분기에 대한 미리 보기를 활성화하세요. 미리 보기 페이지의 목록에서 브랜치를 선택하고 관리를 선택합니다.

    브랜치가 선택되어 있고 오른쪽 상단에 관리 버튼이 표시된 미리 보기 페이지.

  4. 브랜치의 미리 보기 설정 관리 창에서 pull 요청 미리 보기를 켜세요.

  5. 풀스택 애플리케이션의 경우 다음 중 하나를 수행해야 합니다.

    • 모든 pull 요청에 대해 새 백엔드 환경을 생성을 선택하세요. 이 옵션을 사용하면 프로덕션에 영향을 주지 않고 변경 사항을 테스트할 수 있습니다.

    • 이 브랜치에 대한 모든 pull 요청이 기존 환경을 가리키도록 설정을 선택합니다.

  6. 확인을 선택합니다.

다음에 브랜치에 대한 pull 요청를 제출하면 Amplify는 PR을 빌드하여 미리 보기 URL에 배포합니다.

고유한 미리 보기 URL을 포함하여 PR에 대한 정보가 포함된 미리 보기 페이지.

GitHub 리포지토리의 경우에만 GitHub 계정의 pull 요청에서 직접 URL 미리 보기에 액세스할 수 있습니다.

GitHub 계정의 pull 요청입니다. 여기서 세부 정보를 선택하여 미리 보기 URL을 볼 수 있습니다.

pull 요청가 종료되면 미리 보기 URL이 삭제되고 pull 요청에 연결된 임시 백엔드 환경도 삭제됩니다.

하위 도메인을 통한 웹 미리 보기 액세스

Amazon Route 53에서 관리하는 사용자 지정 도메인에 연결된 Amplify 앱의 하위 도메인을 통해 풀 요청의 웹 미리 보기에 액세스할 수 있습니다. pull 요청가 종료되면 풀 요청과 관련된 브랜치와 하위 도메인이 자동으로 삭제됩니다. 이는 앱의 패턴 기반 기능 분기 배포를 설정한 후 웹 미리 보기의 기본 동작입니다. 자동 하위 도메인을 설정하는 지침은 Amazon Route 53 사용자 지정 도메인을 위한 자동 하위 도메인을 설정합니다. 단원을 참조하세요.