App Runner 구성 파일 참조

상단 섹션 - 최상위 키 포함

빌드 섹션 - 빌드 단계를 구성합니다.

실행 섹션 - 런타임 단계를 구성합니다.

version - 필수. App Runner 구성 파일 버전입니다. 이상적으로는 최신 버전을 사용합니다.

구문

version: version

version: 1.0

runtime - 필수 항목입니다. 애플리케이션이 사용하는 런타임의 이름입니다. App Runner가 제공하는 다양한 프로그래밍 플랫폼에 사용 가능한 런타임에 대한 자세한 내용은 섹션을 참조하세요소스 코드를 기반으로 하는 App Runner 서비스.

구문

runtime: runtime-name

runtime: python3

commands - 필수 항목입니다. 다양한 빌드 단계에서 App Runner가 실행하는 명령을 지정합니다. 다음 하위 키가 포함됩니다.

구문

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 - 선택 사항입니다. 빌드 단계의 사용자 지정 환경 변수를 지정합니다. 이름-값 스칼라 매핑으로 정의됩니다. 빌드 명령에서 이러한 변수를 이름으로 참조할 수 있습니다.

구문

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"

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 빌드 프로세스에 대한 자세한 내용은 섹션을 참조하세요관리형 런타임 버전 및 App Runner 빌드.

구문

run:
  pre-run:
      - command
      - …

command - 필수 항목입니다. App Runner가 애플리케이션 빌드를 완료한 후 애플리케이션을 실행하는 데 사용하는 명령입니다.

구문

run:
  command: command

network - 선택 사항입니다. 애플리케이션이 수신 대기하는 포트를 지정합니다. 여기에는 다음이 포함됩니다.

구문

run:
  network:
    port: port-number
    env: env-variable-name

run:
  network:
    port: 8000
    env: MY_APP_PORT

env - 선택 사항입니다. 실행 단계의 사용자 지정 환경 변수 정의. 이름-값 스칼라 매핑으로 정의됩니다. 런타임 환경에서 이러한 변수를 이름으로 참조할 수 있습니다.

구문

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"