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

向 Elastic Beanstalk 部署 Rails 应用程序

Rails 是适用于 Ruby 的一种开源模型视图控制器 (MVC) 框架。本教程将演练生成 Rails 应用程序并将其部署到 AWS Elastic Beanstalk 环境的过程。

先决条件

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

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

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

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

Rails 需要 Ruby 2.2.2 或更新版本。在本教程中,我们使用 Ruby 2.5.1 和相应的 Elastic Beanstalk 平台版本。按照设置 Ruby 开发环境上的说明操作来安装 Ruby。

启动 Elastic Beanstalk 环境

使用 AWS 管理控制台创建 Elastic Beanstalk 环境。选择 Ruby 平台并接受默认设置和示例代码。

启动环境 (控制台)

  1. 使用下面的预配置链接打开 Elastic Beanstalk 控制台:console.aws.amazon.com/elasticbeanstalk/home#/newApplication?applicationName=tutorials&environmentType=LoadBalanced

  2. 对于平台,选择与应用程序使用的语言匹配的平台。

  3. 对于应用程序代码,选择示例应用程序

  4. 选择复查并启动

  5. 检查可用选项。对它们感到满意之后,选择创建应用程序

环境创建大约需要 5 分钟,将创建以下资源:

  • EC2 实例 – 配置来在您选择的平台上运行 Web 应用程序的 Amazon Elastic Compute Cloud (Amazon EC2) 虚拟机。

    各平台运行一组特定软件、配置文件和脚本以支持特定的语言版本、框架、Web 容器或其组合。大多数平台使用 Apache 或 nginx 作为 Web 应用程序前的反向代理,向其转发请求、提供静态资产以及生成访问和错误日志。

  • 实例安全组 – 配置来允许通过端口 80 访问的 Amazon EC2 安全组。通过此资源,HTTP 流量可以从负载均衡器到达运行您的 Web 应用程序的 EC2 实例。默认情况下,其他端口不允许流量进入。

  • 负载均衡器 – 配置来向运行您的应用程序的实例分配请求的 Elastic Load Balancing 负载均衡器。负载均衡器还使您无需将实例直接公开在 Internet 上。

  • 安全组 – 配置来允许通过端口 80 访问的 Amazon EC2 安全组。利用此资源,HTTP 流量可从 Internet 到达负载均衡器。默认情况下,其他端口不允许流量进入。

  • Auto Scaling 组 – 配置来在实例终止或不可用时替换实例的 Auto Scaling 组。

  • Amazon S3 存储桶 – 使用 Elastic Beanstalk 时创建的源代码、日志和其他项目的存储位置。

  • Amazon CloudWatch 警报 – 用于监控环境实例负载的两个 CloudWatch 警报,在负载过高或过低时触发。警报触发后,您的 Auto Scaling 组会扩展或收缩进行响应。

  • AWS CloudFormation 堆栈 – Elastic Beanstalk 使用 AWS CloudFormation 启动您的环境中的资源并传播配置更改。这些资源在您可通过 AWS CloudFormation 控制台查看的模板中定义。

  • 域名 – 一个域名,它以下面的形式路由到您的 Web 应用程序:subdomain.region.elasticbeanstalk.com

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

注意

Elastic Beanstalk 创建的 Amazon S3 存储桶将在多个环境之间共享并且在环境终止期间不会被删除。有关更多信息,请参阅 将 Elastic Beanstalk 用于 Amazon S3

安装 Rails 并生成网站

使用 gem 命令安装 Rails 及其依赖项。

~$ gem install rails Fetching: concurrent-ruby-1.0.5.gem (100%) Successfully installed concurrent-ruby-1.0.5 Fetching: i18n-1.0.1.gem (100%) Successfully installed i18n-1.0.1 ...

测试 Rails 安装。

~$ rails --version Rails 5.2.0

rails new 与应用程序的名称一起使用以创建新 Rails 项目。

~$ rails new ~/eb-rails

Rails 将创建具有指定名称的目录,生成在本地运行示例项目所需的所有文件,然后运行捆绑程序以安装在项目的 Gemfile 中定义的所有依赖项 (Gems)。

通过在本地运行默认项目测试 Rails 安装。

~$ cd eb-rails eb-rails $ rails server => Booting Puma => Rails 5.2.0 application starting in development => Run `rails server -h` for more startup options Puma starting in single mode... * Version 3.11.4 (ruby 2.5.1-p57), codename: Love Song * Min threads: 5, max threads: 5 * Environment: development * Listening on tcp://0.0.0.0:3000 Use Ctrl+C to stop ...

在 Web 浏览器中打开 http://localhost:3000 以查看运转中的默认项目。


        默认 Rails 站点开发页面。

此页面仅在开发模式中可见。向应用程序的首页添加一些内容来支持至 Elastic Beanstalk 的生产部署。使用 rails generate 为欢迎页面创建控制器、路由和视图。

~/eb-rails$ rails generate controller WelcomePage welcome create app/controllers/welcome_page_controller.rb route get 'welcome_page/welcome' invoke erb create app/views/welcome_page create app/views/welcome_page/welcome.html.erb invoke test_unit create test/controllers/welcome_page_controller_test.rb invoke helper create app/helpers/welcome_page_helper.rb invoke test_unit invoke assets invoke coffee create app/assets/javascripts/welcome_page.coffee invoke scss create app/assets/stylesheets/welcome_page.scss.

这将提供访问 /welcome_page/welcome 处的页面所需的一切。但是,在发布更改之前,请更改视图中的内容并添加路由以使此页面显示在网站的顶层。

使用文本编辑器编辑 app/views/welcome_page/welcome.html.erb 中的内容。在本示例中,您将使用 cat 覆盖现有文件的内容。

例 app/views/welcome_page/welcome.html.erb

<h1>Welcome!</h1> <p>This is the front page of my first Rails application on Elastic Beanstalk.</p>

最后,将以下路由添加到 config/routes.rb

例 config/routes.rb

Rails.application.routes.draw do get 'welcome_page/welcome' root 'welcome_page#welcome'

这将指示 Rails 将对网站的根目录的请求路由到欢迎页面控制器的欢迎方法,该方法将在欢迎视图中呈现内容 (welcome.html.erb)。

配置 Rails 设置

使用 Elastic Beanstalk 控制台为 Rails 配置环境属性。将 SECRET_KEY_BASE 环境属性设置为最多 256 个字母数字字符的字符串。您项目的 secrets.yml 文件夹中的 config 文件引用此属性。

此属性用于创建密钥,并且本身应该是一个私有密钥(正如其名称所示)。这就是您不想将其存储在其他人可能看得到的源代码管理中的原因。将 SECRET_KEY_BASE 环境属性设置为任何值。

在 Elastic Beanstalk 控制台中配置环境属性

  1. 打开 Elastic Beanstalk 控制台

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

  3. 选择 Configuration

  4. Software 配置卡上,选择 Modify

  5. Environment properties (环境属性) 下,输入键-值对。

  6. 选择 Apply

现在准备好将站点部署到环境中。

部署您的应用程序

创建包含 Rails 所创建文件的源包。以下命令将创建名为 rails-default.zip 的源包。

~/eb-rails$ zip ../rails-default.zip -r * .[^.]*

将源包上传到 Elastic Beanstalk 以将 Rails 部署到环境中。

部署源包

  1. 打开 Elastic Beanstalk 控制台

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

  3. 选择 Upload and Deploy

  4. 选择选择文件并使用对话框选择源包。

  5. 选择 Deploy

  6. 部署完成后,选择站点 URL 以在新选项卡中打开您的网站。

清除

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

终止 Elastic Beanstalk 环境

  1. 打开 Elastic Beanstalk 控制台

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

  3. 选择操作,然后选择终止环境

  4. Confirm Termination (确认终止) 对话框中,键入环境名称,然后选择 Terminate (终止)

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

后续步骤

有关 Rails 的更多信息,请访问 rubyonrails.org

如果要继续部署应用程序,您可能需要一种方式来管理环境和部署应用程序,而无需手动创建 .zip 文件并将其上传至 Elastic Beanstalk 控制台 控制台。Elastic Beanstalk 命令行界面 (EB CLI) 提供了易于使用的命令,可用于从命令行创建、配置应用程序并将应用程序部署到 Elastic Beanstalk 环境。

最后,如果计划在生产环境中使用应用程序,您会希望为环境配置自定义域名,并为安全连接启用 HTTPS