https://docs.aws.amazon.com/zh_cn/elasticbeanstalk/latest/dg/create-deploy-python-flask.html

向 AWS Elastic Beanstalk 部署 Flask 应用程序

Flask 是一种适用于 Python 的开源 Web 应用程序框架。本教程将演练生成 Flask 应用程序并将其部署到 AWS Elastic Beanstalk 环境的过程。

小节目录

• 先决条件
• 通过 Flask 设置 Python 虚拟环境
• 创建 Flask 应用程序
• 使用 EB CLI 部署站点
• 清除
• 后续步骤

先决条件

本教程假设您对基本 Elastic Beanstalk 操作和 Elastic Beanstalk 控制台有一定了解。如果尚不了解&＃xff0c;请按照开始使用 Elastic Beanstalk 中的说明启动您的第一个 Elastic Beanstalk 环境。

为了遵循本指南中的步骤&＃xff0c;您需要命令行终端或外壳&＃xff0c;以便运行命令。命令显示在列表中&＃xff0c;以提示符 ($) 和当前目录名称&＃xff08;如果有&＃xff09;开头&＃xff1a;

~/eb-project$ this is a command
this is output

在 Linux 和 macOS 中&＃xff0c;可使用您首选的外壳程序和程序包管理器。在 Windows 10 中&＃xff0c;您可以安装 Windows Subsystem for Linux&＃xff0c;获取 Ubuntu 和 Bash 与 Windows 集成的版本。

Flask 需要 Python 2.7 或 3.4 或更新版本。在本教程中&＃xff0c;我们使用 Python 3.6 和相应的 Elastic Beanstalk 平台版本。按照设置 Python 开发环境上的说明操作来安装 Python。

Flask 框架将作为此教程的一部分安装。

本教程还使用 Elastic Beanstalk 命令行界面 (EB CLI)。有关安装和配置 EB CLI 的详细说明&＃xff0c;请参阅使用安装脚本安装 EB CLI 和配置 EB CLI。

通过 Flask 设置 Python 虚拟环境

为应用程序创建项目目录和虚拟环境并安装 Flask。

设置项目环境

1. 创建项目目录。

   ~$ mkdir eb-flask
~$ cd eb-flask

2. 创建和激活名为 virt 的虚拟环境&＃xff1a;

   ~/eb-flask$ virtualenv virt
~$ source virt/bin/activate
(virt) ~/eb-flask$

   您将看到您的命令提示符前面带有 (virt)&＃xff0c;表明您在虚拟环境中。在本教程的其余部分中使用虚拟环境。

3. 使用 pip install 安装 Flask&＃xff1a;

   (virt)~/eb-flask$ pip install flask&＃61;&＃61;1.0.2

4. 使用 pip freeze 查看已安装的库&＃xff1a;

   (virt)~/eb-flask$ pip freeze
click&＃61;&＃61;6.7
Flask&＃61;&＃61;1.0.2
itsdangerous&＃61;&＃61;0.24
Jinja2&＃61;&＃61;2.10
MarkupSafe&＃61;&＃61;1.0
Werkzeug&＃61;&＃61;0.14.1

   此命令列出虚拟环境中已安装的所有程序包。由于您在虚拟环境中&＃xff0c;因此不会显示全局安装的程序包&＃xff0c;例如 EB CLI。

5. 将来自 pip freeze 的输出保存到名为 requirements.txt 的文件中。

   (virt)~/eb-flask$ pip freeze > requirements.txt

   在部署期间&＃xff0c;此文件将指示 Elastic Beanstalk 安装库。有关更多信息&＃xff0c;请参阅 要求文件。

创建 Flask 应用程序

接下来&＃xff0c;创建您将使用 Elastic Beanstalk 部署的应用程序。我们会创建一个“Hello World”RESTful Web 服务。

在此目录中创建名为 application.py 的新文本文件&＃xff0c;包含以下内容&＃xff1a;

本示例输出根据访问服务所使用的路径而变化的自定义问候语。

使用 application.py 作为文件名并提供可调用的 application 对象&＃xff08;在本示例中为 Flask 对象&＃xff09;可允许 Elastic Beanstalk 轻松地找到应用程序代码。

将 application.py 与 Python 一起运行&＃xff1a;

(virt) ~/eb-flask$ python application.py* Serving Flask app "application" (lazy loading)* Environment: productionWARNING: Do not use the development server in a production environment.Use a production WSGI server instead.* Debug mode: on* Running on http://127.0.0.1:5000/ (Press CTRL&＃43;C to quit)* Restarting with stat* Debugger is active!* Debugger PIN: 313-155-123

在您的 Web 浏览器中打开 http://127.0.0.1:5000/。您应该看到应用程序正在运行&＃xff0c;并且会显示索引页面&＃xff1a;

检查服务器日志&＃xff0c;查看请求的输出。您可键入 Ctrl&＃43;C&＃xff0c;停止 Web 服务器并返回到虚拟环境。

如果您看到的是调试输出&＃xff0c;请修复错误并确保应用程序正在本地运行&＃xff0c;然后再为 Elastic Beanstalk 配置应用程序。

使用 EB CLI 部署站点

您已添加在 Elastic Beanstalk 上部署应用程序所需的全部内容。您的项目目录现在应该如下所示&＃xff1a;

~/eb-flask/
|-- virt
|-- application.py
&＃96;-- requirements.txt

不过&＃xff0c;不需要 virt 文件夹即可使应用程序在 Elastic Beanstalk 上运行。在部署时&＃xff0c;Elastic Beanstalk 会在服务器实例上创建新的虚拟环境&＃xff0c;并安装 requirements.txt 中列出的库。要最大程度地减小部署期间上传的源包的大小&＃xff0c;请添加 .ebignore 文件&＃xff0c;此文件告知 EB CLI 忽略 virt 文件夹。

下一步&＃xff0c;您将创建应用程序环境并使用 Elastic Beanstalk 部署已配置的应用程序。

创建环境和部署 Flask 应用程序

1. 使用 eb init 命令&＃xff0c;初始化 EB CLI 存储库&＃xff1a;

   ~/eb-flask$ eb init -p python-3.6 flask-tutorial --region us-east-2
Application flask-tutorial has been created.

   此命令创建名为 flask-tutorial 的新应用程序&＃xff0c;并配置本地存储库&＃xff0c;以最新的 Python 3.6 平台版本创建环境。

2. (可选) 再次运行 eb init&＃xff0c;以配置默认密钥对&＃xff0c;以便连接到使用 SSH 运行应用程序的 EC2 实例&＃xff1a;

   ~/eb-flask$ eb init
Do you want to set up SSH for your instances?
(y/n): y
Select a keypair.
1) my-keypair
2) [ Create new KeyPair ]

   如果您已有密钥对&＃xff0c;请选择一个密钥对&＃xff0c;或按提示创建新密钥对。如果您没有看到提示或需要以后更改设置&＃xff0c;请运行 eb init -i。

3. 使用 eb create 创建环境并将应用程序部署到此环境中&＃xff1a;

   ~/eb-flask$ eb create flask-env

环境创建大约需要 5 分钟&＃xff0c;将创建以下资源&＃xff1a;

所有这些资源均由 Elastic Beanstalk 管理。当您终止环境时&＃xff0c;Elastic Beanstalk 会终止其包含的所有资源。

当环境创建过程完成时&＃xff0c;请使用 eb open 打开网站&＃xff1a;

~/eb-flask$ eb open

这将使用为应用程序创建的域名打开一个浏览器窗口。您应该看到在本地创建和测试的相同 Flask 网站。

如果您没有看到应用程序运行&＃xff0c;或者出现错误消息&＃xff0c;请查看排查部署问题以获取有关如何确定错误原因的帮助。

如果您确实 看到应用程序在运行&＃xff0c;那么恭喜&＃xff0c;您已使用 Elastic Beanstalk 部署了第一个 Flask 应用程序&＃xff01;

清除

Elastic Beanstalk 使用完毕时&＃xff0c;您可以终止您的环境。Elastic Beanstalk 会终止与环境关联的所有 AWS 资源&＃xff0c;例如 Amazon EC2 实例、数据库实例、负载均衡器、安全组和警报。

终止 Elastic Beanstalk 环境

1. 打开 Elastic Beanstalk 控制台。

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

3. 选择 Actions (操作)&＃xff0c;然后选择 Terminate Environment (终止环境)。

4. 在 Confirm Termination (确认终止) 对话框中&＃xff0c;输入环境名称&＃xff0c;然后选择 Terminate (终止)。

利用 Elastic Beanstalk&＃xff0c;可以随时为您的应用程序轻松创建新环境。

或者&＃xff0c;使用 EB CLI&＃xff1a;

~/eb-flask$ eb terminate flask-env

后续步骤

有关 Flask 的更多信息&＃xff0c;请访问 flask.pocoo.org。

如果您希望尝试其他 Python Web 框架&＃xff0c;请浏览向 Elastic Beanstalk 部署 Django 应用程序。