前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家。点击跳转到网站。

简介

Rails 是一个用 Ruby 编写的开源 Web 应用程序框架。它遵循“约定优于配置”的理念，通过假设有一种“最佳”做事方式，让你在不必浏览无尽的配置文件的情况下编写更少的代码，同时实现更多功能。

Nginx 是一个高性能的 HTTP 服务器、反向代理和负载均衡器，以其并发性、稳定性、可扩展性和低内存消耗而闻名。与 Nginx 类似，Puma 是另一个极快且并发性能出色的 Web 服务器，具有非常小的内存占用，专为 Ruby Web 应用程序而构建。

Capistrano 是一个远程服务器自动化工具，主要专注于 Ruby Web 应用程序。它通过在 SSH 上编写任意工作流程并自动化常见任务（如资源预编译和重启 Rails 服务器）来可靠地将 Web 应用程序部署到任意数量的远程机器上。

在本教程中，我们将在 DigitalOcean Ubuntu Droplet 上安装 Ruby 和 Nginx，并在我们的 Web 应用程序中配置 Puma 和 Capistrano。Nginx 将用于捕获客户端请求并将其传递给运行 Rails 的 Puma Web 服务器。我们将使用 Capistrano 自动化常见部署任务，因此每当我们需要将新版本的 Rails 应用程序部署到服务器上时，我们可以通过几个简单的命令来完成。

先决条件

要按照本教程操作，您必须具备以下条件：

• Ubuntu 14.04 x64 Droplet
• 一个名为 deploy 的非 root 用户，具有 sudo 权限（《使用 Ubuntu 14.04 进行初始服务器设置》解释了如何设置此权限。）
• 托管在远程 git 仓库中准备部署的工作中的 Rails 应用程序

可选地，为了提高安全性，您可以禁用 SSH 的 root 登录，并按照《使用 Ubuntu 14.04 进行初始服务器设置》中的说明更改 SSH 端口号。

本教程中的所有命令都应该以 deploy 用户身份运行。如果命令需要 root 访问权限，则会在命令之前加上 sudo。

步骤 1 — 安装 Nginx

一旦 VPS 安全，我们就可以开始安装软件包。更新软件包索引文件：

sudo apt-get update

然后，安装 Nginx：

sudo apt-get install curl git-core nginx -y

步骤 2 — 安装数据库

安装您将在 Rails 应用程序中使用的数据库。由于有很多数据库可供选择，我们不会在本指南中涵盖它们。您可以在这里查看主要数据库的说明：

• MySQL
• PostgreSQL
• MongoDB

还要确保查看：

• 《如何在 Ubuntu 14.04 上使用 MySQL 与您的 Ruby on Rails 应用程序》
• 《如何在 Ubuntu 14.04 上使用 PostgreSQL 与您的 Ruby on Rails 应用程序》

步骤 3 — 安装 RVM 和 Ruby

我们不会直接安装 Ruby。相反，我们将使用 Ruby 版本管理器。有很多选择（rbenv、chruby 等），但在本教程中我们将使用 RVM。RVM 允许您轻松在同一系统上安装和管理多个 Ruby，并根据您的应用程序使用正确的 Ruby。当您需要升级 Rails 应用程序以使用更新的 Ruby 时，这将大大简化生活。

在安装 RVM 之前，您需要导入 RVM GPG 密钥：

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3

然后安装 RVM 来管理我们的 Rubies：

curl -sSL https://get.rvm.io | bash -s stable

此命令使用 curl 从 https://get.rvm.io 下载 RVM 安装脚本。-sSL 选项由三个标志组成：

• -s 告诉 curl 以“静默模式”下载文件
• -S 告诉 curl 如果失败则显示错误消息
• -L 告诉 curl 在检索安装脚本时遵循所有 HTTP 重定向

下载完成后，脚本被 管道 到 bash。-s 选项将 stable 作为参数传递给 RVM 安装脚本，以下载并安装 RVM 的稳定版本。

我们需要加载 RVM 脚本（作为函数）以便开始使用它。然后我们需要运行 requirements 命令来自动安装 RVM 和 Ruby 正常运行所需的依赖和文件：

source ~/.rvm/scripts/rvm
rvm requirements

现在我们可以安装我们选择的 Ruby。我们将安装最新的 Ruby 2.2.1（在撰写本文时）作为我们的默认 Ruby：

rvm install 2.2.1
rvm use 2.2.1 --default

第四步 — 安装 Rails 和 Bundler

一旦 Ruby 安装完成，我们就可以开始安装 Rubygems。我们将首先安装 Rails gem，这将允许您的 Rails 应用程序运行，然后我们将安装 bundler，它可以读取您应用程序的 Gemfile 并自动安装所有所需的 gems。

要安装 Rails 和 Bundler：

gem install rails -V --no-ri --no-rdoc
gem install bundler -V --no-ri --no-rdoc

使用了三个标志：

• -V（详细输出）：打印有关 Gem 安装的详细信息
• --no-ri - （跳过 Ri 文档）：不安装 Ri 文档，节省空间并加快安装速度
• --no-rdoc - （跳过 RDocs）：不安装 RDocs，节省空间并加快安装速度

第五步 — 设置 SSH 密钥

由于我们希望进行平稳的部署，我们将使用 SSH 密钥进行授权。首先与 GitHub、Bitbucket 或任何其他托管 Rails 应用程序代码库的 Git 远程进行握手：

ssh -T git@github.com
ssh -T git@bitbucket.org

如果收到“Permission denied (publickey)”消息，不用担心。现在，为您的服务器生成 SSH 密钥（公钥/私钥对）：

ssh-keygen -t rsa 

将新创建的公钥（~/.ssh/id_rsa.pub）添加到您的代码库的部署密钥中：

• Github 指令
• Bitbucket 指令

如果所有步骤都完成正确，现在您应该能够在不输入密码的情况下通过 SSH 协议 clone 您的 git 仓库：

git clone git@example.com:username/appname.git

如果您需要一个用于测试的示例应用程序，您可以 fork 以下专门为本教程创建的测试应用程序：GitHub 上的示例 Rails 应用程序

git clone 命令将创建一个与您的应用程序同名的目录。例如，将创建一个名为 testapp_rails 的目录。

我们只是克隆以检查我们的部署密钥是否起作用，我们不需要每次推送新更改时都克隆或拉取我们的仓库。我们将让 Capistrano 为我们处理所有这些。如果您愿意，现在可以删除此克隆的目录。

在本地计算机上打开终端。如果您的本地计算机没有 SSH 密钥，请为其创建一个。在本地终端会话中：

ssh-keygen -t rsa 

将您的本地 SSH 密钥添加到您的 Droplet 的 Authorized Keys 文件（记得用您的自定义端口号替换端口号）：

cat ~/.ssh/id_rsa.pub | ssh -p your_port_num deploy@your_server_ip 'cat >> ~/.ssh/authorized_keys'

第六步 — 在 Rails 应用程序中添加部署配置

在本地计算机上，为您的 Rails 应用程序创建 Nginx 和 Capistrano 的配置文件。首先在 Rails 应用程序的 Gemfile 中添加以下行：

group :development do
    gem 'capistrano',         require: false
    gem 'capistrano-rvm',     require: false
    gem 'capistrano-rails',   require: false
    gem 'capistrano-bundler', require: false
    gem 'capistrano3-puma',   require: false
end

gem 'puma'

使用 bundler 安装您在 Gemfile 中指定的 gems。输入以下命令来捆绑您的 Rails 应用程序：

bundle

捆绑后，运行以下命令配置 Capistrano：

cap install

这将创建：

• Capfile 在您的 Rails 应用程序的根目录中
• deploy.rb 文件在 config 目录中
• deploy 目录在 config 目录中

用以下内容替换您的 Capfile 的内容：

# Load DSL and Setup Up Stages
require 'capistrano/setup'
require 'capistrano/deploy'

require 'capistrano/rails'
require 'capistrano/bundler'
require 'capistrano/rvm'
require 'capistrano/puma'

# Loads custom tasks from `lib/capistrano/tasks' if you have any defined.
Dir.glob('lib/capistrano/tasks/*.rake').each { |r| import r }

这个 Capfile 加载了一些预定义的任务到您的 Capistrano 配置文件中，使您的部署变得轻松无忧，例如自动：

• 选择正确的 Ruby
• 预编译资源
• 将您的 Git 仓库克隆到正确的位置
• 在您的 Gemfile 更改时安装新的依赖项

用以下内容替换 config/deploy.rb 的内容，并用您的应用程序和 Droplet 参数更新标记为红色的字段：

```markdown
# 更改这些
server 'your_server_ip', port: your_port_num, roles: [:web, :app, :db], primary: true

set :repo_url,        'git@example.com:username/appname.git'
set :application,     'appname'
set :user,            'deploy'
set :puma_threads,    [4, 16]
set :puma_workers,    0

# 除非你知道你在做什么，否则不要更改这些
set :pty,             true
set :use_sudo,        false
set :stage,           :production
set :deploy_via,      :remote_cache
set :deploy_to,       "/home/#{fetch(:user)}/apps/#{fetch(:application)}"
set :puma_bind,       "unix://#{shared_path}/tmp/sockets/#{fetch(:application)}-puma.sock"
set :puma_state,      "#{shared_path}/tmp/pids/puma.state"
set :puma_pid,        "#{shared_path}/tmp/pids/puma.pid"
set :puma_access_log, "#{release_path}/log/puma.error.log"
set :puma_error_log,  "#{release_path}/log/puma.access.log"
set :ssh_options,     { forward_agent: true, user: fetch(:user), keys: %w(~/.ssh/id_rsa.pub) }
set :puma_preload_app, true
set :puma_worker_timeout, nil
set :puma_init_active_record, true  # 当不使用 ActiveRecord 时更改为 false

## 默认值:
# set :scm,           :git
# set :branch,        :master
# set :format,        :pretty
# set :log_level,     :debug
# set :keep_releases, 5

## 链接的文件和目录（默认为无）:
# set :linked_files, %w{config/database.yml}
# set :linked_dirs,  %w{bin log tmp/pids tmp/cache tmp/sockets vendor/bundle public/system}

namespace :puma do
  desc '为 Puma Pids 和 Socket 创建目录'
  task :make_dirs do
    on roles(:app) do
      execute "mkdir #{shared_path}/tmp/sockets -p"
      execute "mkdir #{shared_path}/tmp/pids -p"
    end
  end

  before :start, :make_dirs
end

namespace :deploy do
  desc "确保本地 git 与远程同步。"
  task :check_revision do
    on roles(:app) do
      unless `git rev-parse HEAD` == `git rev-parse origin/master`
        puts "警告：HEAD 与 origin/master 不同"
        puts "运行 `git push` 来同步更改。"
        exit
      end
    end
  end

  desc '初始部署'
  task :initial do
    on roles(:app) do
      before 'deploy:restart', 'puma:start'
      invoke 'deploy'
    end
  end

  desc '重启应用'
  task :restart do
    on roles(:app), in: :sequence, wait: 5 do
      invoke 'puma:restart'
    end
  end

  before :starting,     :check_revision
  after  :finishing,    :compile_assets
  after  :finishing,    :cleanup
  after  :finishing,    :restart
end

# ps aux | grep puma    # 获取 puma pid
# kill -s SIGUSR2 pid   # 重启 puma
# kill -s SIGTERM pid   # 停止 puma

这个 deploy.rb 文件包含了一些合理的默认设置，可以立即使用，帮助你管理应用程序的发布，并在进行部署时自动执行一些任务：

• 使用 production 作为 Rails 应用程序的默认环境
• 自动管理应用程序的多个发布版本
• 使用优化的 SSH 选项
• 检查你的 git 远程是否是最新的
• 管理应用程序的日志
• 在管理 Puma 工作进程时，在内存中预加载应用程序
• 在完成部署后启动（或重新启动）Puma服务器
• 在你的发布中的特定位置打开到 Puma 服务器的套接字

你可以根据自己的需求更改所有选项。现在，需要配置 Nginx。在你的 Rails 项目目录中创建 config/nginx.conf，并添加以下内容（再次替换为你的参数）：

upstream puma {
  server unix:///home/deploy/apps/appname/shared/tmp/sockets/appname-puma.sock;
}

server {
  listen 80 default_server deferred;
  # server_name example.com;

  root /home/deploy/apps/appname/current/public;
  access_log /home/deploy/apps/appname/current/log/nginx.access.log;
  error_log /home/deploy/apps/appname/current/log/nginx.error.log info;

  location ^~ /assets/ {
    gzip_static on;
    expires max;
    add_header Cache-Control public;
  }

  try_files $uri/index.html $uri @puma;
  location @puma {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_redirect off;

    proxy_pass http://puma;
  }

  error_page 500 502 503 504 /500.html;
  client_max_body_size 10M;
  keepalive_timeout 10;
}

与之前的文件类似，这个 nginx.conf 包含了可以立即使用的默认设置，与你的 deploy.rb 文件中的配置相匹配。它在端口 80 上监听流量，并将请求传递到你的 Puma 套接字，在你的应用程序的 ‘current’ 发布中写入 nginx 日志，压缩所有资产并在浏览器中以最大到期时间进行缓存，将公共文件夹中的 HTML 页面作为静态文件提供，并设置默认的最大 Client Body Size 和 Request Timeout 值。

## 第7步 — 部署你的 Rails 应用程序

如果你正在使用自己的 Rails 应用程序，请提交你刚刚做的更改，并从本地机器推送它们到远程：

```command
git add -A
git commit -m "设置 Puma、Nginx 和 Capistrano"
git push origin master

再次从本地机器进行首次部署：

cap production deploy:initial

这将把你的 Rails 应用程序推送到 Droplet，安装应用程序所需的所有 gem，并启动 Puma web 服务器。这可能需要 5-15 分钟，具体时间取决于你的应用程序使用的 gem 数量。在此过程中，你将看到调试消息。

如果一切顺利，我们现在准备将你的 Puma web 服务器连接到 Nginx 反向代理。

在 Droplet 上，将 nginx.conf 创建符号链接到 sites-enabled 目录：

sudo rm /etc/nginx/sites-enabled/default
sudo ln -nfs "/home/deploy/apps/appname/current/config/nginx.conf" "/etc/nginx/sites-enabled/appname"

重新启动 Nginx 服务：

sudo service nginx restart

现在，你应该能够将你的 Web 浏览器指向你的服务器 IP，并看到你的 Rails 应用程序在运行！

普通部署

每当你对应用程序进行更改并希望将新版本部署到服务器时，请提交更改，像往常一样推送到你的 git 远程，并运行 deploy 命令：

git add -A
git commit -m "部署消息"
git push origin master
cap production deploy

结论

到目前为止，你应该在 Droplet 上运行一个带有 Puma 作为 Web 服务器的 Rails 应用程序，同时 Nginx 和 Capistrano 配置了基本设置。现在，你应该查看其他文档，以帮助你优化配置，以充分发挥你的 Rails 应用程序的潜力：

• Puma 配置
• Capistrano 中的 Puma DSL
• Capistrano 中的本地资源预编译
• 基于 RAM 自动重启 Puma 工作进程
• 优化 Nginx 以处理高流量负载