Beispiele für App Runner-Konfigurationsdateien

Anmerkung

Konfigurationsdateien gelten nur für Dienste, die auf Quellcode basieren. Sie können Konfigurationsdateien nicht mit imagebasierten Diensten verwenden.

Die folgenden Beispiele veranschaulichen AWS App Runner Konfigurationsdateien. Einige sind minimal und enthalten nur die erforderlichen Einstellungen. Andere sind vollständig, einschließlich aller Abschnitte der Konfigurationsdatei. Eine Übersicht über die App Runner-Konfigurationsdateien finden Sie unterApp Runner-Dienstoptionen mithilfe einer Konfigurationsdatei einrichten.

Beispiele für Konfigurationsdateien

Minimale Konfigurationsdatei

Bei einer minimalen Konfigurationsdatei geht App Runner von den folgenden Annahmen aus:

• Während der Erstellung oder Ausführung sind keine benutzerdefinierten Umgebungsvariablen erforderlich.

• Die neueste Runtime-Version wird verwendet.

• Die Standard-Portnummer und die Port-Umgebungsvariable werden verwendet.

Beispiel apprunner.yaml

version: 1.0
runtime: python3 
build:
  commands:
    build:
      - pip install pipenv
      - pipenv install 
run: 
  command: python app.py

Vollständige Konfigurationsdatei

Dieses Beispiel zeigt die Verwendung aller Konfigurationsschlüssel im apprunner.yaml Originalformat mit einer verwalteten Laufzeit.

Beispiel apprunner.yaml

version: 1.0
runtime: python3 
build:
  commands:
    pre-build:
      - wget -c https://s3.amazonaws.com/amzn-s3-demo-bucket/test-lib.tar.gz -O - | tar -xz
    build:        
      - pip install pipenv
      - pipenv install
    post-build:
      - python manage.py test
  env:
    - name: DJANGO_SETTINGS_MODULE
      value: "django_apprunner.settings"
    - name: MY_VAR_EXAMPLE
      value: "example"
run:
  runtime-version: 3.7.7
  command: pipenv run gunicorn django_apprunner.wsgi --log-file -
  network: 
    port: 8000
    env: MY_APP_PORT  
  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"

Vollständige Konfigurationsdatei — (verwendet einen überarbeiteten Build)

Dieses Beispiel zeigt die Verwendung aller Konfigurationsschlüssel in der apprunner.yaml mit einer verwalteten Laufzeit.

Der pre-run Parameter wird nur vom überarbeiteten App Runner-Build unterstützt. Fügen Sie diesen Parameter nicht in Ihre Konfigurationsdatei ein, wenn Ihre Anwendung Runtime-Versionen verwendet, die vom ursprünglichen App Runner-Build unterstützt werden. Weitere Informationen finden Sie unter Verwaltete Runtime-Versionen und der App Runner-Build.

Anmerkung

Da dieses Beispiel für Python 3.11 ist, verwenden wir die python3 Befehle pip3 und. Weitere Informationen finden Sie Callouts für bestimmte Runtime-Versionen im Thema Python-Plattform.

Beispiel apprunner.yaml

version: 1.0
runtime: python311
build:
  commands:
    pre-build:
      - wget -c https://s3.amazonaws.com/amzn-s3-demo-bucket/test-lib.tar.gz -O - | tar -xz
    build:        
      - pip3 install pipenv
      - pipenv install
    post-build:
      - python3 manage.py test
  env:
    - name: DJANGO_SETTINGS_MODULE
      value: "django_apprunner.settings"
    - name: MY_VAR_EXAMPLE
      value: "example"
run:
  runtime-version: 3.11
  pre-run:  
    - pip3 install pipenv
    - pipenv install
    - python3 copy-global-files.py
  command: pipenv run gunicorn django_apprunner.wsgi --log-file -
  network: 
    port: 8000
    env: MY_APP_PORT  
  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"

Beispiele für spezifische verwaltete Laufzeitkonfigurationsdateien finden Sie im jeweiligen Unterthema zur Laufzeit unter. Codebasierter Dienst