앱 러너 구성 파일 참조

참고

구성 파일은 소스 코드를 기반으로 하는 서비스에만 적용됩니다. 이미지 기반 서비스에는 구성 파일을 사용할 수 없습니다.

이 항목은 구성 파일의 구문 및 의미에 대한 포괄적인 참조 안내서입니다. AWS App Runner App Runner 구성 파일에 대한 개요는 를 참조하십시오. 구성 파일을 사용하여 App Runner 서비스 옵션 설정

앱 러너 구성 파일은 YAML 파일입니다. 이름을 지정하고 애플리케이션 저장소의 소스 디렉터리에 배치합니다. apprunner.yaml

구조 개요

앱 러너 구성 파일은 YAML 파일입니다. 이름을 지정하고 애플리케이션 저장소의 소스 디렉터리에 배치합니다. apprunner.yaml

App Runner 구성 파일에는 다음과 같은 주요 부분이 포함되어 있습니다.

상위 섹션 — 최상위 키 포함
빌드 섹션 - 빌드 단계를 구성합니다.
실행 섹션 - 런타임 단계를 구성합니다.

상단 섹션

파일 상단의 키는 파일 및 서비스 런타임에 대한 일반 정보를 제공합니다. 다음과 같은 키를 사용할 수 있습니다.

version— 필수. 앱 러너 구성 파일 버전입니다. 가장 좋은 방법은 최신 버전을 사용하는 것입니다.

구문
```
version: version
```
예
```
version: 1.0
```
runtime— 필수. 애플리케이션에서 사용하는 런타임의 이름. App Runner에서 제공하는 다양한 프로그래밍 플랫폼에서 사용 가능한 런타임에 대해 알아보려면 을 참조하십시오. 소스 코드 기반 앱 러너 서비스

참고
관리형 런타임의 명명 규칙은 다음과 같습니다. <language-name><major-version>

구문
```
runtime: runtime-name
```
예
```
runtime: python3
```

빌드 섹션

빌드 섹션에서는 App Runner 서비스 배포의 빌드 단계를 구성합니다. 빌드 명령과 환경 변수를 지정할 수 있습니다. 빌드 명령이 필요합니다.

섹션은 build: 키로 시작하며 다음과 같은 하위 키로 구성됩니다.

commands— 필수. App Runner가 다양한 빌드 단계에서 실행하는 명령을 지정합니다. 다음과 같은 하위 키가 포함됩니다.
- pre-build— 선택 사항. App Runner가 빌드 전에 실행하는 명령 예를 들어 npm 종속 항목 또는 테스트 라이브러리를 설치할 수 있습니다.
- build— 필수. App Runner가 애플리케이션을 빌드하기 위해 실행하는 명령입니다. 예를 들어, 를 사용하세요pipenv.
- post-build— 선택 사항. 앱 러너가 빌드 후에 실행하는 명령어 예를 들어 Maven을 사용하여 빌드 아티팩트를 JAR 또는 WAR 파일로 패키징하거나 테스트를 실행할 수 있습니다.
구문
```
build:
  commands:
    pre-build:
      - command
      - …
    build:
      - command
      - …
    post-build:
      - command
      - …
```
예
```
build:
  commands:
    pre-build:
      - yum install openssl
    build:
      - pip install -r requirements.txt
    post-build:
      - python manage.py test
```
env— 선택 사항입니다. 빌드 단계의 사용자 지정 환경 변수를 지정합니다. 이름-값 스칼라 매핑으로 정의됩니다. 빌드 명령에서 이러한 변수를 이름으로 참조할 수 있습니다.
참고
이 구성 파일에는 서로 다른 두 위치에 서로 다른 두 개의 env 항목이 있습니다. 한 세트는 Build 섹션에 있고 다른 세트는 Run 섹션에 있습니다.
- 빌드 프로세스 중에pre-build, buildpost-build, 및 pre-run 명령으로 빌드 섹션의 env 세트를 참조할 수 있습니다.
  
  중요 - pre-run 명령어는 빌드 섹션에 정의된 환경 변수에만 액세스할 수 있지만 이 파일의 Run 섹션에 있다는 점에 유의하십시오.
- 실행 섹션의 env 세트는 런타임 환경의 run 명령으로 참조할 수 있습니다.
구문
```
build:
  env:
    - name: name1
      value: value1
    - name: name2
      value: value2
    - …
```
예
```
build:
  env:
    - name: DJANGO_SETTINGS_MODULE
      value: "django_apprunner.settings"
    - name: MY_VAR_EXAMPLE
      value: "example"
```

실행 섹션

실행 섹션은 App Runner 애플리케이션 배포의 컨테이너 실행 단계를 구성합니다. 런타임 버전, 사전 실행 명령 (수정된 형식만 해당), 시작 명령, 네트워크 포트 및 환경 변수를 지정할 수 있습니다.

섹션은 run: 키로 시작하며 다음과 같은 하위 키가 있습니다.

runtime-version— 선택 사항. App Runner 서비스에 대해 잠그려는 런타임 버전을 지정합니다.

기본적으로 메이저 버전만 잠깁니다. App Runner는 모든 배포 또는 서비스 업데이트에서 런타임에 사용할 수 있는 최신 마이너 및 패치 버전을 사용합니다. 메이저 버전과 마이너 버전을 지정하면 둘 다 잠기고 App Runner는 패치 버전만 업데이트합니다. 메이저, 마이너, 패치 버전을 지정하면 서비스가 특정 런타임 버전에서만 잠기며 App Runner는 해당 버전을 업데이트하지 않습니다.

구문
```
run:
  runtime-version: major[.minor[.patch]]
```
참고
일부 플랫폼의 런타임은 버전 구성요소가 다릅니다. 자세한 내용은 특정 플랫폼 주제를 참조하십시오.
예
```
runtime: python3
run:
  runtime-version: 3.7
```
pre-run— 선택 사항. 빌드 사용만 수정되었습니다. 빌드 이미지에서 실행 이미지로 애플리케이션을 복사한 후 App Runner가 실행하는 명령을 지정합니다. 여기에 명령을 입력하여 /app 디렉터리 외부에서 실행 이미지를 수정할 수 있습니다. 예를 들어 /app 디렉터리 외부에 있는 추가 글로벌 종속성을 설치해야 하는 경우 이 하위 섹션에 필요한 명령을 입력하여 설치하십시오. App Runner 빌드 프로세스에 대한 자세한 내용은 을 참조하십시오. 관리형 런타임 버전 및 앱 러너 빌드
참고
- 중요 — pre-run 명령이 Run 섹션에 나열되어 있더라도 이 구성 파일의 Build 섹션에 정의된 환경 변수만 참조할 수 있습니다. 이 실행 섹션에 정의된 환경 변수는 참조할 수 없습니다.
- 이 pre-run 매개변수는 수정된 App Runner 빌드에서만 지원됩니다. 애플리케이션이 원본 App Runner 빌드에서 지원하는 런타임 버전을 사용하는 경우 구성 파일에 이 매개변수를 삽입하지 마세요. 자세한 정보는 관리형 런타임 버전 및 앱 러너 빌드을 참조하세요.
구문
```
run:
  pre-run:
      - command
      - …
```
command— 필수. App Runner가 애플리케이션 빌드를 완료한 후 애플리케이션을 실행하는 데 사용하는 명령입니다.

구문
```
run:
  command: command
```
network— 선택 사항입니다. 애플리케이션이 수신하는 포트를 지정합니다. 여기에는 다음이 포함됩니다.
- port— 선택 사항입니다. 지정된 경우 애플리케이션에서 수신하는 포트 번호입니다. 기본값은 8080입니다.
- env— 선택 사항입니다. 지정된 경우 App Runner는 기본 환경 변수에서 동일한 포트 번호를 전달하는 것 외에도 이 환경 변수의 컨테이너에 포트 번호를 전달합니다 (대신 전달하지 않음). PORT 즉env, 지정하는 경우 App Runner는 두 환경 변수에 포트 번호를 전달합니다.
구문
```
run:
  network:
    port: port-number
    env: env-variable-name
```
예
```
run:
  network:
    port: 8000
    env: MY_APP_PORT
```
env— 선택 사항입니다. 실행 단계에 대한 사용자 지정 환경 변수 정의 이름-값 스칼라 매핑으로 정의됩니다. 런타임 환경에서 이러한 변수를 이름으로 참조할 수 있습니다.
참고
이 구성 파일에는 서로 다른 두 위치에 서로 다른 두 개의 env 항목이 있습니다. 한 세트는 Build 섹션에 있고 다른 세트는 Run 섹션에 있습니다.
- 빌드 프로세스 중에pre-build, buildpost-build, 및 pre-run 명령으로 빌드 섹션의 env 세트를 참조할 수 있습니다.
  
  중요 - pre-run 명령어는 빌드 섹션에 정의된 환경 변수에만 액세스할 수 있지만 이 파일의 Run 섹션에 있다는 점에 유의하십시오.
- 실행 섹션의 env 세트는 런타임 환경의 run 명령으로 참조할 수 있습니다.
구문
```
run:
  env:
    - name: name1
      value: value1
    - name: name2
      value: value2   
  secrets:
    - name: name1
      value-from: arn:aws:secretsmanager:region:aws_account_id:secret:secret-id
    - name: name2
      value-from: arn:aws:ssm:region:aws_account_id:parameter/parameter-name
    - …
```
예
```
run:
  env:
    - name: MY_VAR_EXAMPLE
      value: "example"
  secrets:
    - name: my-secret
      value-from: "arn:aws:secretsmanager:us-east-1:123456789012:secret:testingstackAppRunnerConstr-kJFXde2ULKbT-S7t8xR:username::"
    - name: my-parameter
      value-from: "arn:aws:ssm:us-east-1:123456789012:parameter/parameter-name"
    - name: my-parameter-only-name
      value-from: "parameter-name"
```

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

예시

앱 러너 API