App Runner 設定ファイルのリファレンス

上位セクション – 最上位キーが含まれます

ビルドセクション – ビルドステージを設定します

実行セクション – ランタイムステージを設定します

version – 必須。App Runner 設定ファイルのバージョン。理想的には、最新バージョンを使用してください。

[Syntax] (構文)

version: version

version: 1.0

runtime – 必須。アプリケーションが使用するランタイムの名前。App Runner が提供するさまざまなプログラミングプラットフォームで使用可能なランタイムについては、「」を参照してくださいソースコードに基づく App Runner サービス。

[Syntax] (構文)

runtime: runtime-name

runtime: python3

commands – 必須。さまざまなビルドフェーズで App Runner が実行するコマンドを指定します。次のサブキーが含まれます。

[Syntax] (構文)

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 – オプション。ビルドステージのカスタム環境変数を指定します。名前と値のスカラーマッピングとして定義されます。これらの変数は、ビルドコマンドで名前で参照できます。

[Syntax] (構文)

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 によって更新されることはありません。

[Syntax] (構文)

run:
  runtime-version: major[.minor[.patch]]

runtime: python3
run:
  runtime-version: 3.7

pre-run – オプション。 ビルド使用法の改訂のみ。ビルドイメージから実行イメージにアプリケーションをコピーした後に App Runner が実行するコマンドを指定します。/app ディレクトリ外の実行イメージを変更するコマンドをここに入力できます。例えば、 /app ディレクトリの外部にある追加のグローバル依存関係をインストールする必要がある場合は、このサブセクションに必要なコマンドを入力してインストールします。App Runner ビルドプロセスの詳細については、「」を参照してくださいマネージドランタイムバージョンと App Runner ビルド。

[Syntax] (構文)

run:
  pre-run:
      - command
      - …

command – 必須。App Runner がアプリケーションビルドの完了後にアプリケーションを実行するために使用するコマンド。

[Syntax] (構文)

run:
  command: command

network – オプション。アプリケーションがリッスンするポートを指定します。この情報には以下が含まれます。

[Syntax] (構文)

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

run:
  network:
    port: 8000
    env: MY_APP_PORT

env – オプション。実行ステージのカスタム環境変数の定義。名前と値のスカラーマッピングとして定義されます。ランタイム環境では、これらの変数を名前で参照できます。

[Syntax] (構文)

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"