App Runner에 새 애플리케이션 버전 배포

에서 AWS App Runner서비스를 생성할 때 애플리케이션 소스 (컨테이너 이미지 또는 소스 리포지토리) 를 구성합니다. App Runner는 서비스를 실행하기 위한 리소스를 프로비저닝하고 해당 리소스에 애플리케이션을 배포합니다.

이 항목에서는 새 버전이 출시될 때 애플리케이션 소스를 App Runner 서비스에 재배포하는 방법을 설명합니다. 이미지 리포지토리의 새 이미지 버전이거나 코드 리포지토리의 새 커밋일 수 있습니다. App Runner는 서비스에 배포하는 두 가지 방법, 즉 자동 및 수동을 제공합니다.

배포 방법

App Runner는 애플리케이션 배포가 시작되는 방식을 제어할 수 있는 다음과 같은 방법을 제공합니다.

자동 배포

서비스에 대한 지속적 통합 및 배포 (CI/CD) 동작을 원하는 경우 자동 배포를 사용하세요. App Runner는 이미지 또는 코드 저장소의 변경 사항을 모니터링합니다.

이미지 리포지토리 — 새 이미지 버전을 이미지 리포지토리에 푸시하거나 코드 리포지토리에 새 커밋을 푸시할 때마다 App Runner는 추가 조치 없이 이를 서비스에 자동으로 배포합니다.

코드 리포지토리 — 소스 디렉터리를 변경하는 코드 리포지토리에 새 커밋을 푸시할 때마다 App Runner는 전체 리포지토리를 배포합니다. 소스 디렉터리의 변경 사항만 자동 배포를 트리거하므로 소스 디렉터리 위치가 자동 배포의 범위에 어떤 영향을 미치는지 이해하는 것이 중요합니다.

• 최상위 디렉터리 (리포지토리 루트) — 서비스를 생성할 때 소스 디렉터리에 설정되는 기본값입니다. 소스 디렉터리가 이 값으로 설정되면 전체 리포지토리가 소스 디렉터리 내에 있음을 의미합니다. 따라서 이 경우 소스 리포지토리에 푸시하는 모든 커밋이 배포를 트리거합니다.

• 리포지토리 루트가 아닌 모든 디렉터리 경로 (기본값 아님) - 소스 디렉터리 내에서 푸시된 변경 사항만 자동 배포를 트리거하므로 원본 디렉터리에 없는 변경 내용을 리포지토리에 푸시해도 자동 배포가 트리거되지 않습니다. 따라서 푸시한 변경 내용을 원본 디렉터리 외부로 배포하려면 수동 배포를 사용해야 합니다.

참고

App Runner는 Amazon ECR 퍼블릭 이미지 및 서비스가 속한 계정과 다른 AWS 계정에 속하는 Amazon ECR 리포지토리의 이미지에 대한 자동 배포를 지원하지 않습니다.

수동 배포

서비스에 대한 각 배포를 명시적으로 시작하려는 경우 수동 배포를 사용하세요. 서비스용으로 구성한 리포지토리에 배포하려는 새 버전이 있는 경우 배포를 시작합니다. 자세한 정보는 수동 배포을 참조하세요.

참고

수동 배포를 실행하면 App Runner는 전체 저장소의 소스를 배포합니다.

다음과 같은 방법으로 서비스의 배포 방법을 구성할 수 있습니다.

• 콘솔 - 새로 만들려는 서비스 또는 기존 서비스의 경우 원본 및 배포 구성 페이지의 배포 설정 섹션에서 수동 또는 자동을 선택합니다.

  

• API 또는 AWS CLI— or UpdateService작업을 호출할 때 CreateServiceSourceConfiguration매개 변수의 AutoDeploymentsEnabled 멤버를 False 수동 배포 또는 자동 True 배포용으로 설정합니다.

자동 배포와 수동 배포 비교

자동 배포와 수동 배포 모두 동일한 결과를 산출합니다. 즉, 두 방법 모두 전체 리포지토리를 배포합니다.

두 메서드의 차이점은 트리거 메커니즘입니다.

• 수동 배포는 콘솔에서의 배포, 에 대한 호출 또는 App Runner API에 대한 호출을 통해 트리거됩니다. AWS CLI다음 수동 배포 섹션에서는 이러한 절차에 대해 설명합니다.

• 소스 디렉터리의 내용이 변경되면 자동 배포가 트리거됩니다.

수동 배포

수동 배포의 경우 서비스에 대한 각 배포를 명시적으로 시작해야 합니다. 새 버전의 애플리케이션 이미지 또는 코드를 배포할 준비가 되면 다음 섹션을 참조하여 콘솔과 API를 사용하여 배포를 수행하는 방법을 알아볼 수 있습니다.

참고

수동 배포를 실행하면 App Runner는 전체 리포지토리의 소스를 배포합니다.

다음 방법 중 하나를 사용하여 애플리케이션 버전을 배포하십시오.

App Runner console

App Runner 콘솔을 사용하여 배포하려면

1. App Runner 콘솔을 열고 지역 목록에서 해당 콘솔을 선택합니다. AWS 리전

2. 탐색 창에서 서비스를 선택한 다음 App Runner 서비스를 선택합니다.

   콘솔에는 서비스 개요가 포함된 서비스 대시보드가 표시됩니다.

   

3. 배포를 선택합니다.

   결과: 새 버전 배포가 시작됩니다. 서비스 대시보드 페이지에서 서비스 상태가 작업 진행 중으로 변경됩니다.

4. 배포가 종료될 때까지 기다리세요. 서비스 대시보드 페이지에서 서비스 상태가 다시 Running (실행 중) 으로 변경되어야 합니다.

5. 배포가 성공했는지 확인하려면 서비스 대시보드 페이지에서 기본 도메인 값 (서비스 웹 사이트 URL) 을 선택합니다. 웹 애플리케이션을 검사하거나 웹 애플리케이션과 상호 작용하고 버전 변경을 확인하세요.

   참고

   앱 러너 애플리케이션의 보안을 강화하기 위해*.awsapprunner.com 도메인은 공개 접미사 목록 (PSL) 에 등록되어 있습니다. 보안 강화를 위해 App Runner 애플리케이션의 기본 도메인 이름에 민감한 쿠키를 설정해야 하는 경우 __Host- 접두사가 있는 쿠키를 사용하는 것이 좋습니다. 이렇게 쿠키를 설정하면 교차 사이트 요청 위조 시도(CSRF)로부터 도메인을 보호하는 데 도움이 됩니다. 자세한 내용은 Mozilla 개발자 네트워크의 Set-Cookie 페이지를 참조하십시오.

App Runner API or AWS CLI

앱 러너 API 또는 를 사용하여 배포하려면 API 작업을 AWS CLI호출하십시오. StartDeployment 전달해야 할 유일한 파라미터는 서비스 ARN입니다. 서비스를 생성할 때 애플리케이션 소스 위치를 이미 구성했으므로 App Runner에서 새 버전을 찾을 수 있습니다. 호출에서 성공적인 응답이 반환되면 배포가 시작됩니다.