将 rails 应用程序部署到 Elastic Beanstalk

Rails 是一个适用于 Ruby 的开源 model-view-controller (MVC) 框架。本教程将引导您完成生成 Rails 应用程序并将其部署到 Amazon Elastic Beanstalk 环境中的过程。

先决条件

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

启动 Elastic Beanstalk 环境

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

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

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

安装 rails 并生成网站

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

~$ gem install rails
Fetching: concurrent-ruby-1.1.9.gem
Successfully installed concurrent-ruby-1.1.9
Fetching: rack-2.2.3.gem
Successfully installed rack-2.2.3
...

测试 Rails 安装。

~$ rails --version
Rails 6.1.4.1

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

~$ rails new ~/eb-rails

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

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

~$ cd eb-rails
~/eb-rails$ rails server
=> Booting Puma
=> Rails 6.1.4.1 application starting in development
=> Run `bin/rails server --help` for more startup options
Puma starting in single mode...
* Puma version: 5.5.2 (ruby 3.0.2-p107) ("Zawgyi")
*  Min threads: 5
*  Max threads: 5
*  Environment: development
*          PID: 77857
* Listening on http://127.0.0.1:3000
* Listening on http://[::1]:3000
Use Ctrl-C to stop
...

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

此页面仅在开发模式中可见。向应用程序的首页添加一些内容来支持至 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 覆盖现有文件的内容。

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

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

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

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

要使 Elastic Beanstalk 在 Ruby 平台上成功部署应用程序，我们需要更新 Gemfile.lock。Gemfile.lock 的一些依赖项可能是特定于平台的。因此，我们需要将 platform ruby 添加到 Gemfile.lock，以使所有必需的依赖项均随部署一起安装。

~/eb-rails$ bundle lock --add-platform ruby
Fetching gem metadata from https://rubygems.org/............
Resolving dependencies...
Writing lockfile to /Users/janedoe/EBDPT/RubyApps/eb-rails-doc-app/Gemfile.lock

配置 rails 设置

使用 Elastic Beanstalk 控制台为 Rails 配置环境属性。将 SECRET_KEY_BASE 环境属性设置为最多 256 个字母数字字符的字符串。

Rails 使用此属性来创建密钥。因此，您应该保密，不要将密钥以纯文本形式存储在源代码控制中。相反，您应通过环境属性在环境中向 Rails 代码提供该密钥。

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

部署您的应用程序

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

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

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

清除

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

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

后续步骤

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

当您继续开发应用程序时，您可能希望通过某种方式来管理环境和部署应用程序，而无需手动创建 .zip 文件并将该文件上传到 Elastic Beanstalk 控制台。Elastic Beanstalk 命令行界面 (EB CLI easy-to-use ) 提供了从命令行创建、配置应用程序并将其部署到 Elastic Beanstalk 环境的命令。

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