AWS Elastic Beanstalk
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

使用 AWS Elastic Beanstalk Python 平台

AWS Elastic Beanstalk Python 平台是一组环境配置,适用于可在 Apache 代理服务器后方使用 WSGI 运行的 Python Web 应用程序。每个配置都对应于 Python 的一个版本,如 Python 3.4。

Elastic Beanstalk 提供配置选项,可供您用于自定义在 Elastic Beanstalk 环境中的 EC2 实例上运行的软件。您可配置应用程序所需的环境变量,启用日志轮换至 Amazon S3,并将应用程序源中包含静态文件的文件夹映射至代理服务器所提供的路径。

在 AWS 管理控制台中提供了平台特定的配置选项,可用于修改运行环境的配置。要避免在终止环境时丢失环境配置,可以使用保存的配置来保存您的设置,并在以后将这些设置应用到其他环境。

要保存源代码中的设置,您可以包含配置文件。在您每次创建环境或部署应用程序时,会应用配置文件中的设置。您还可在部署期间使用配置文件来安装程序包、运行脚本以及执行其他实例自定义操作。

对于 pip 可提供的 Python 包,您也可在应用程序源代码的根目录中包含名为 requirements.txt要求文件。Elastic Beanstalk 将在部署期间安装要求文件中指定的所有包。

AWS 管理控制台中应用的设置覆盖配置文件中的相同设置(如果存在)。这让您可以在配置文件中包含默认设置,并使用控制台中的特定环境设置加以覆盖。如需了解有关优先顺序和其他设置更改方法的更多信息,请参阅配置选项

配置您的 Python 环境

您可使用 AWS 管理控制台来启用日志轮换至 Amazon S3,配置应用程序可从环境中读取的变量,并将应用程序源中包含静态文件的子文件夹映射至代理服务器所提供的路径。

在 Elastic Beanstalk 控制台中配置 Python 环境

  1. 打开 Elastic Beanstalk 控制台

  2. 导航到您的环境的管理页

  3. 选择 Configuration

  4. Software 配置卡上,选择 Modify

Python 设置

  • WSGI 路径 – 主应用程序文件的名称或路径。例如,application.pydjango/wsgi.py

  • NumProcesses – 要在每个应用程序实例上运行的流程的数量。

  • NumThreads – 要在每个流程中运行的线程的数量。

AWS X-Ray 设置

日志选项

“日志选项”部分有两个设置:

  • 实例配置文件 – 指定有权访问 Amazon S3 存储桶的实例配置文件,该存储桶与应用程序关联。

  • Enable log file rotation to Amazon S3 - 指定应用程序的 Amazon EC2 实例的日志文件是否应复制到与应用程序相关联的 Amazon S3 存储桶。

静态文件

为了提高性能,您可以配置代理服务器,从 Web 应用程序内的一组目录中提供静态文件(例如 HTML 或图像)。当代理服务器收到对指定路径下的某个文件的请求时,它将直接提供此文件而不是将请求路由至您的应用程序。您可以在 Modify software (修改软件) 配置页面的 Static Files (静态文件) 部分中设置虚拟路径和目录映射。添加映射时,如果您添加另一个映射,则会显示额外的一行。要删除映射,请单击“Remove”。

 Elastic Beanstalk 控制台中“Modify software (修改软件)”配置页面中的静态文件配置

如果看不到 Static Files (静态文件) 部分,您必须使用配置选项至少添加一个映射。例如,以下配置文件添加两个虚拟路径和目录映射,目录位于您的源包的顶层。

例 .ebextensions/python-static-files.config

option_settings: aws:elasticbeanstalk:container:python:staticfiles: /html: statichtml /images: staticimages

默认情况下,Python 环境中的代理服务器提供 static 路径下名为 /static 的文件夹中的任何文件。例如,如果您的应用程序源代码在名为 logo.png 的文件夹中包含一个名为 static 的文件,则代理服务器将通过 subdomain.elasticbeanstalk.com/static/logo.png 将其提供给用户。您可以配置额外的映射,如本节中所述。

环境属性

您可使用环境属性来为应用程序提供信息,配置环境变量。例如,您可创建名为 CONNECTION_STRING 的环境属性,指定应用程序可用于连接数据库的连接字符串。

在 Elastic Beanstalk 上运行的 Python 环境中,可以使用 Python 的 os.environ 字典访问这些值。有关更多信息,请转到 http://docs.python.org/library/os.html

您可使用类似以下内容的代码,用于访问各种密钥和参数:

import os endpoint = os.environ['API_ENDPOINT']

环境属性也可为框架提供信息。例如,您可创建名为 DJANGO_SETTINGS_MODULE 的属性,以配置 Django 为使用特定设置模块。根据环境的不同,值可以是 development.settingsproduction.settings 等等。

参阅 环境属性和其他软件设置 了解更多信息。

Python 配置命名空间

您可以使用配置文件设置配置选项并在部署期间执行其他实例配置。配置选项可以通过您使用的 Elastic Beanstalk 服务或平台定义并组织到命名空间中。

Python 平台在 aws:elasticbeanstalk:container:python:staticfilesaws:elasticbeanstalk:container:python 命名空间中定义选项。以下示例配置文件指定配置选项设置,以创建名为 DJANGO_SETTINGS_MODULE 的环境属性,这一静态文件选项将名为 staticimages 的目录映射至路径 /images;此外还有 aws:elasticbeanstalk:container:python 命名空间中的附加设置。此命名空间包含让您在源代码中指定 WSGI 脚本位置的选项,以及运行 WSGI 的线程和进程数量。

option_settings: aws:elasticbeanstalk:application:environment: DJANGO_SETTINGS_MODULE: production.settings aws:elasticbeanstalk:container:python:staticfiles: "/images/": "staticimages/" aws:elasticbeanstalk:container:python: WSGIPath: ebdjango/wsgi.py NumProcesses: 3 NumThreads: 20

配置文件还支持多个密钥,以便进一步在环境实例上修改软件。此示例使用程序包密钥,以使用 yum容器命令安装 Memcached,从而在部署期间运行配置服务器的命令。

packages: yum: libmemcached-devel: '0.31' container_commands: collectstatic: command: "django-admin.py collectstatic --noinput" 01syncdb: command: "django-admin.py syncdb --noinput" leader_only: true 02migrate: command: "django-admin.py migrate" leader_only: true 03wsgipass: command: 'echo "WSGIPassAuthorization On" >> ../wsgi.conf' 99customize: command: "scripts/customize.sh"

Elastic Beanstalk 提供许多配置选项来自定义您的环境。除了配置文件之外,您还可使用控制台、保存的配置、EB CLI 或 AWS CLI 来配置选项。参阅 配置选项 了解更多信息。