快速入门:将 Node.js 应用程序部署到 Elastic Beanstalk
本快速入门教程将演练创建 Node.js 应用程序并将其部署到 Amazon Elastic Beanstalk 环境的过程。
不用于生产用途
示例仅用于演示。请勿在生产环境中使用示例应用程序。
各个部分
您的 Amazon 账户
如果您还不是 Amazon 客户,则需要创建一个 Amazon 账户。注册之后,您将能够访问 Elastic Beanstalk 以及您可能需要的其他 Amazon 服务。
如果您已有 Amazon 账户,则您可以继续 先决条件。
注册 Amazon Web Services 账户
如果您还没有 Amazon Web Services 账户,请完成以下步骤来创建一个。
注册 Amazon Web Services 账户
按照屏幕上的说明操作。
在注册时,将接到电话或收到短信,要求使用电话键盘输入一个验证码。
当您注册 Amazon Web Services 账户 时,系统将会创建一个 Amazon Web Services 账户根用户。根用户有权访问该账户中的所有 Amazon Web Services 服务和资源。作为最佳安全实践,请为用户分配管理访问权限,并且只使用根用户来执行需要根用户访问权限的任务。
注册过程完成后,Amazon 会向您发送一封确认电子邮件。在任何时候,您都可以通过转至 https://aws.amazon.com/
保护 IAM 用户
注册 Amazon Web Services 账户 后,启用多重身份验证(MFA)保护您的管理用户。有关说明,请参阅《IAM 用户指南》中的 为 IAM 用户启用虚拟 MFA 设备(控制台)。
要授予其他用户访问您的 Amazon Web Services 账户资源的权限,请创建 IAM 用户。为了保护您的 IAM 用户,请启用 MFA 并仅向 IAM 用户授予执行任务所需的权限。
有关创建和保护 IAM 用户的更多信息,请参阅《IAM 用户指南》中的以下主题:
先决条件
为了遵循本指南中的步骤,您需要命令行终端或 Shell,以便运行命令。命令显示在列表中,以提示符($)和当前目录名称(如果有)开头。
~/eb-project$ this is a command
this is output
在 Linux 和 macOS 中,您可使用您首选的 Shell 和程序包管理器。在 Windows 上,您可以安装适用于 Linux 的 Windows 子系统
EB CLI
本教程使用 Elastic Beanstalk 命令行界面 (EB CLI)。有关安装和配置 EB CLI 的详细信息,请参阅 使用设置脚本安装 EB CLI(推荐) 和 配置 EB CLI。
Node.js
按照 Node.js 网站上的 How to install Node.js
通过运行以下命令来验证您的 Node.js 安装。
~$ node -v
步骤 1:创建 Node.js 应用程序
创建项目目录。
~$ mkdir eb-nodejs
~$ cd eb-nodejs
接下来,创建一个您将使用 Elastic Beanstalk 部署的应用程序。我们会创建一个“Hello World”RESTful Web 服务。
例 ~/eb-nodejs/server.js
const http = require('node:http'); const hostname = '127.0.0.1'; const port = 8080; const server = http.createServer((req, res) => { res.statusCode = 200; res.setHeader('Content-Type', 'text/plain'); res.end('Hello Elastic Beanstalk!\n'); }); server.listen(port, hostname, () => { console.log(`Server running at http://${hostname}:${port}/`); });
此应用程序在端口 8080 上打开侦听器。默认情况下,对于 Node.js,Elastic Beanstalk 通过端口 8080 将请求转发到您的应用程序。
步骤 2:在本地运行应用程序
运行以下命令以在本地运行您的应用程序。
~/eb-nodejs$ node server.js
您应该看到以下文本。
Server running at http://127.0.0.1:8080/
在您的网络浏览器中输入 URL 地址 http://127.0.0.1:8080/。浏览器应显示“Hello Elastic Beanstalk!”。
步骤 3:使用 EB CLI 部署 Node.js 应用程序
运行以下命令为此应用程序创建 Elastic Beanstalk 环境。
创建环境和部署 Node.js 应用程序
-
使用 eb init 命令,初始化 EB CLI 存储库。
~/eb-nodejs$eb init -p node.js nodejs-tutorial --region us-east-2此命令创建名为
nodejs-tutorial的应用程序并配置您的本地存储库,以创建具有最新 Node.js 平台版本的环境。 -
(可选)再次运行 eb init 以配置默认密钥对,以便使用 SSH 连接到运行您的应用程序的 EC2 实例。
~/eb-nodejs$eb initDo you want to set up SSH for your instances? (y/n):ySelect a keypair. 1) my-keypair 2) [ Create new KeyPair ]如果您已有密钥对,请选择一个,或按提示创建一个。如果您没有看到提示或需要以后更改设置,请运行 eb init -i。
-
创建环境并使用 eb create 将应用程序部署到此环境中。Elastic Beanstalk 会自动为您的应用程序构建一个 zip 文件,并将其部署到环境中的 EC2 实例。部署应用程序后,Elastic Beanstalk 会在端口 8080 上启动它。
~/eb-nodejs$eb create nodejs-envElastic Beanstalk 大约需要五分钟来创建您的环境。
步骤 4:在 Elastic Beanstalk 上运行应用程序
当创建环境的过程完成后,使用 eb open 打开您的网站。
~/eb-nodejs$ eb open
恭喜您!您已使用 Elastic Beanstalk 部署了 Node.js 应用程序!这将使用为应用程序创建的域名打开一个浏览器窗口。
第 5 步:清理
应用程序使用完毕时,您可以终止您的环境。Elastic Beanstalk 会终止与您的环境关联的所有 Amazon 资源。
要使用 EB CLI 终止您的 Elastic Beanstalk 环境,请运行以下命令。
~/eb-nodejs$ eb terminate
适合您的应用程序的 Amazon 资源
您刚刚创建了一个单实例应用程序。它可用作带有单个 EC2 实例的简单示例应用程序,因此不需要负载平衡或自动扩缩。对于单实例应用程序,Elastic Beanstalk 创建以下 Amazon 资源:
-
EC2 实例 - 配置来在您选择的平台上运行 Web 应用程序的 Amazon EC2 虚拟机。
各平台运行一组不同的软件、配置文件和脚本以支持特定的语言版本、框架、Web 容器或其组合。大多数平台使用 Apache 或 nginx 作为在 Web 应用程序前处理 Web 流量的反向代理,向其转发请求、提供静态资产以及生成访问和错误日志。
-
实例安全组 - 配置为允许端口 80 上的传入流量的 Amazon EC2 安全组。通过此资源,HTTP 流量可以从负载均衡器到达运行您的 Web 应用程序的 EC2 实例。默认情况下,其他端口不允许流量进入。
-
Amazon S3 存储桶 – 使用 Elastic Beanstalk 时创建的源代码、日志和其他构件的存储位置。
-
Amazon CloudWatch 警报 - 用于监控环境中的实例负载的两个 CloudWatch 警报,它们将在负载过高或过低时触发。警报触发后,您的 Auto Scaling 组会扩展或收缩以进行响应。
-
Amazon CloudFormation 堆栈 – Elastic Beanstalk 使用 Amazon CloudFormation 启动您环境中的资源并传播配置更改。这些资源在您可通过 Amazon CloudFormation 控制台
查看的模板中定义。 -
域名 – 路由到您的 Web 应用程序的域名,采用形式
subdomain.region.eb.amazonaws.com.cn。
Elastic Beanstalk 管理所有这些资源。当您终止环境时,Elastic Beanstalk 会终止其包含的所有资源。
后续步骤
有了运行应用程序的环境以后,您随时可以部署新的应用程序版本或不同的应用程序。部署新应用程序版本非常快,因为不需要配置或重新启动 EC2 实例。您还可以使用 Elastic Beanstalk 控制台探索新环境。有关详细步骤,请参阅本指南入门一章中的探索您的环境。
尝试更多教程
如果您想尝试包含不同示例应用程序的其他教程,请参阅 更多适用于 Node.js 的 Elastic Beanstalk 示例应用程序和教程。
部署一到两个示例应用程序并准备好开始在本地开发和运行 Node.js 应用程序后,请参阅 为 Elastic Beanstalk 设置 Node.js 开发环境。
使用 Elastic Beanstalk 控制台进行部署
您还可以使用 Elastic Beanstalk 控制台来启动示例应用程序。有关详细步骤,请参阅本指南入门一章中的创建示例应用程序。