使用 Python 平台 - AWS App Runner
Python 運行時配置特定執行階段版本的編號說明Python 運行時示例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Python 平台

AWS App Runner Python 平台提供受管理的執行階段。每個執行階段都可以使用以 Python 版本為基礎的 Web 應用程式輕鬆建置和執行容器。當您使用 Python 運行時，應用程序運行器以託管 Python 運行時映像開始。此映像檔是以 Amazon Linux Docker 映像檔為基礎，其中包含 Python 版本的執行階段套件，以及一些工具以及常用的相依性套件。App Runner 使用此託管運行時映像作為基本映像，並添加您的應用程序代碼來構建 Docker 映像。然後，它將部署此映像以在容器中運行 Web 服務。

當您使用應用程式執行器主控台或CreateServiceAPI作業建立服務時，您可以指定 App Runner 服務的執行階段。您也可以將執行階段指定為原始程式碼的一部分。在您包含在程式碼儲存庫中的 App Runner 設定檔中使用runtime關鍵字。託管運行時的命名約定是 <language-name><major-version>.

如需有效的 Python 執行階段名稱和版本，請參閱Python 執行期發行資訊。

App Runner 會在每次部署或服務更新時，將服務的執行階段更新為最新版本。如果您的應用程式需要特定版本的受管理執行階段，您可以使用 App Runner 設定檔中的runtime-version關鍵字來指定它。您可以鎖定到任何級別的版本，包括主要或次要版本。應用程序運行器僅對服務的運行時進行較低級別的更新。

Python 執行階段的版本語法：major[.minor[.patch]]

例如：3.8.5

下列範例會示範版本鎖定：

  • 3.8-鎖定主要和次要版本。應用程序運行器僅更新補丁版本。

  • 3.8.5— 鎖定到特定的修補程式版本。應用程序運行器不會更新您的運行時版本。

主題

Python 運行時配置

當您選擇受管理的執行階段時，您也必須設定最低限度的建置和執行命令。您可以在創建或更新應用程序運行器服務時進行配置。您可以使用下列其中一種方法來執行此操作：

  • 使用 App Runner 主控台 — 在建立程序或設定索引標籤的 [設定組建] 區段中指定命令。

  • 使用應用程式執行器 API — 呼叫CreateService或UpdateServiceAPI作業。使用CodeConfigurationValues資料類型的BuildCommand和StartCommand成員指定命令。

  • 使用組態檔案 — 在最多三個建置階段中指定一或多個建置命令，以及用來啟動應用程式的單一執行命令。還有其他可選配置設置。

提供組態檔案是選擇性的。當您使用主控台或建立 App Runner 服務時API，您可以指定 App Runner 是在建立時直接取得您的組態設定，還是從組態檔案取得您的組態設定。

特定執行階段版本的編號說明

注意

應用程式執行程式現在會針對以下執行階段版本的應用程式執行更新的建置程序：Python 3.11 和 Node.js 18。如果您的應用程式在其中一個執行階段版本上執行，請參閱以託管運行時版本和應用程序運行器構建取得有關修訂建置程序的詳細資訊。使用所有其他執行階段版本的應用程式不會受到影響，而且會繼續使用原始建置程序。

Python 3.11（修訂後的應用程序運行器構建）

在受管理的 Python 3.11 執行階段的應用程式中使用下列設定。

  • 將「頂部」部分中的runtime密鑰設置為 python311

    範例 
    runtime: python311

  • 使用pip3而不是安裝相依性。pip

  • 使用python3解釋器代替python。

  • 以pre-run指令的方pip3式執行安裝程式。Python 的/app目錄之外安裝依賴關係。由於 App Runner 會針對 Python 3.11 執行修訂的應用程式執行程式組建，因此透過apprunner.yaml檔案的 [建置] 區段中的命令安裝在/app目錄外的任何項目都會遺失。如需詳細資訊，請參閱修訂後的應用程式執行器。

    範例 
    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 -

如需詳細資訊，請參閱本主題稍後的 Python 3.11 擴充設定檔範例。

Python 運行時示例

下面的例子顯示了用於構建和運行 Python 服務的應用程序運行配置文件。最後一個範例是您可以部署到 Python 執行階段服務的完整 Python 應用程式的原始程式碼。

注意

這些範例中使用的執行階段版本為 3.7.7 以及 3.11。 您可以將其替換為您要使用的版本。如需最新支援的 Python 執行階段版本，請參閱Python 執行期發行資訊。

此範例顯示可與 Python 管理執行階段搭配使用的最小組態檔案。如需 App Runner 使用最小組態檔案所做的假設，請參閱組態檔案範例。

Python 3.11 使用pip3和命python3令。如需詳細資訊，請參閱本主題稍後的 Python 3.11 擴充設定檔範例。

範例 阿普魯人. 羊
version: 1.0
runtime: python3 
build:
  commands:
    build:
      - pip install pipenv
      - pipenv install 
run: 
  command: python app.py

這個例子顯示了使用 Python 託管運行時的所有配置鍵。

注意

這些範例中使用的執行階段版本為 3.7.7。 您可以將其替換為您要使用的版本。如需最新支援的 Python 執行階段版本，請參閱Python 執行期發行資訊。

Python 3.11 使用pip3和命python3令。如需詳細資訊，請參閱本主題稍後的 Python 3.11 擴充設定檔範例。

範例 阿普魯人. 羊
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"

此範例顯示在中使用 Python 3.11 受管理執行階段的所有組態索引鍵 apprunner.yaml 這個例子包括一個pre-run部分，因為這個版本的 Python 使用修訂的應用程序運行器構建。

該pre-run參數僅由修訂後的應用程序運行器構建支持。如果您的應用程式使用原始 App Runner 組建支援的執行階段版本，請勿在設定檔中插入此參數。如需詳細資訊，請參閱託管運行時版本和應用程序運行器構建。

注意

這些範例中使用的執行階段版本為 3.11。 您可以將其替換為您要使用的版本。如需最新支援的 Python 執行階段版本，請參閱Python 執行期發行資訊。

範例 阿普魯人. 羊
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"

此範例顯示可部署至 Python 執行階段服務的完整 Python 應用程式的原始程式碼。

範例 requirements.txt
pyramid==2.0
範例 server.py
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response
import os

def hello_world(request):
    name = os.environ.get('NAME')
    if name == None or len(name) == 0:
        name = "world"
    message = "Hello, " + name + "!\n"
    return Response(message)

if __name__ == '__main__':
    port = int(os.environ.get("PORT"))
    with Configurator() as config:
        config.add_route('hello', '/')
        config.add_view(hello_world, route_name='hello')
        app = config.make_wsgi_app()
    server = make_server('0.0.0.0', port, app)
    server.serve_forever()
範例 阿普魯人. 羊
version: 1.0
runtime: python3
build:
  commands:
    build:
      - pip install -r requirements.txt
run:
  command: python server.py