Git 리포지토리용 통합 웹후크 - AWS Amplify 호스팅

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

Git 리포지토리용 통합 웹후크

Amplify Hosting은 Git 리포지토리에 새 커밋이 발생하면 자동으로 빌드를 시작하기 위해 웹후크를 사용합니다. 통합 웹후크 기능은 Amplify와 Git 공급자 간의 통합을 개선하며, 하나의 리포지토리에 더 많은 Amplify 애플리케이션을 연결할 수 있도록 합니다. 통합 웹후크을 사용하면, 이제 리포지토리와 연결된 모든 애플리케이션에 대해 리전별로 단일 웹후크가 사용됩니다. 예를 들어 리포지토리가 미국 동부(버지니아 북부) 및 미국 서부(오리건) 리전의 애플리케이션과 연결되어 있다면, 두 개의 통합 웹후크가 생성됩니다.

이전에는 Amplify가 리포지토리와 연결된 각 앱마다 새로운 웹후크를 생성했습니다. 하나의 리포지토리에 여러 앱이 존재하는 경우, 개별 Git 공급자가 설정한 웹후크 한도에 도달하여 더 이상 앱을 추가하지 못할 수 있었습니다. 특히 단일 리포지토리에 여러 프로젝트가 존재하는 모노레포 환경에서 작업하는 팀의 경우 어려움이 있었습니다.

통합 웹후크의 주요 장점은 다음과 같습니다.

  • Git 공급자 웹후크 제한 극복: 하나의 리포지토리에 원하는 만큼 많은 Amplify 앱을 연결할 수 있습니다.

  • 모노레포 지원 향상: 여러 프로젝트가 하나의 리포지토리를 공유하는 모노레포 환경에서 더 큰 유연성과 효율성을 제공합니다.

  • 관리 간소화: 단일 리포지토리 웹후크로 여러 Amplify 앱을 관리하면 복잡성과 잠재적 오류 지점을 줄일 수 있습니다

  • 워크플로 통합 개선: Git 공급자가 할당한 웹후크를 개발 프로세스의 다른 필수 워크플로에 활용할 수 있습니다.

통합 웹후크 시작하기

새로운 앱 만들기

Git 리포지토리에서 Amplify Hosting으로 새 애플리케이션을 배포하면, 통합 웹후크 기능이 자동으로 구현됩니다. 새 애플리케이션 생성 방법은 Amplify Hosting에 앱 배포 시작하기 섹션을 참조하세요.

기존 앱 업데이트

기존 Amplify 애플리케이션의 경우, 기존 웹후크를 통합 웹후크로 교체하려면 Git 리포지토리를 애플리케이션에 다시 연결해야 합니다. Git 공급자가 허용하는 최대 웹후크 수에 이미 도달한 경우, 통합 웹후크로의 마이그레이션이 실패할 수 있습니다. 이 경우, 기존 웹후크를 하나 이상 수동으로 제거한 후 다시 연결하세요.

하나의 리포지토리에서 여러 애플리케이션을 서로 다른AWS 리전에 배포할 수 있습니다. Amplify 작업은 리전 기반으로 하므로, 통합 웹후크로의 마이그레이션은 앱을 다시 연결한 리전의 웹후크에만 적용됩니다. 따라서 리포지토리에서 애플리케이션 ID 기반 웹후크와 리전 기반 통합 웹후크가 함께 표시될 수 있습니다.

기존 Amplify 앱을 통합 웹후크로 마이그레이션하려면 다음 지침을 따릅니다.

기존 Amplify 앱을 통합 웹후크로 마이그레이션하려면
  1. AWS Management 콘솔에 로그인하고 Amplify 콘솔을 엽니다.

  2. 통합 웹후크로 마이그레이션할 앱을 선택합니다.

  3. 탐색 창에서 앱 설정, 브랜치 설정을 차례로 선택합니다.

  4. 브랜치 설정 페이지에서 리포지토리 재연결을 선택합니다.

  5. Git 리포지토리의 웹후크 설정에서 통합 웹후크가 성공적으로 적용되었는지 확인합니다. 단일 웹후크 URL이 https://amplify-webhooks.Region.amazonaws.com/git-provider 형식으로 표시되어야 합니다.