简介
如果你是一名 Ruby on Rails 开发者,你可能需要一个 Web 服务器来托管你的 Web 应用程序。本教程将向你展示如何使用 Phusion Passenger 作为你的 Rails 友好型 Web 服务器。Passenger 安装、配置和维护都很简单,而且可以与 Nginx 或 Apache 一起使用。在本教程中,我们将在 Ubuntu 14.04 上使用 Nginx 安装 Passenger。
另一种部署 Rails 应用程序的方法是使用 Nginx 与 Unicorn 的 1-Click Rails 安装,Unicorn 是一个可以同时处理多个请求的 HTTP 服务器。
在本教程结束时,你将在你的 Passenger/Nginx Web 服务器上部署一个测试的 Rails 应用程序,并可以通过域名或 IP 地址访问。
步骤一 — 创建你的 Droplet
创建一个新的 Ubuntu 14.04 Droplet。对于较小的站点,选择 512 MB 的计划就足够了。
!Droplet 大小
你可能想选择 32 位的 Ubuntu 镜像,因为它消耗的内存较小(64 位程序使用的内存约比 32 位程序多 50%)。但是,如果你需要更大的机器,或者有可能升级到超过 4 GB 的 RAM,你应该选择 64 位版本。
!Droplet 镜像
步骤二 — 添加一个 Sudo 用户
创建 Droplet 后,需要进行额外的系统管理工作。你应该创建一个系统用户并保护服务器。
请参考《初始化服务器设置》文章。
在本教程中,你应该创建一个具有 sudo 权限的基本用户。在本例中,我们将使用 rails 用户。如果你的用户有其他名称,请确保在接下来的步骤中使用正确的路径。
步骤三(可选) — 设置你的域名
为了确保你的站点可以正常访问,你需要设置你的 DNS 记录,将你的域名指向你的新服务器。你可以通过以下链接找到有关设置主机名的更多信息。
但是,这一步骤是可选的,因为你可以通过 IP 地址访问你的站点。
步骤四 — 安装 Ruby
我们将从源代码手动安装 Ruby。
在做其他任何事情之前,我们应该运行更新,确保我们要安装的所有软件包都是最新的:
sudo apt-get update
接下来,安装一些依赖项。这应该使安装尽可能顺利:
sudo apt-get install build-essential libssl-dev libyaml-dev libreadline-dev openssl curl git-core zlib1g-dev bison libxml2-dev libxslt1-dev libcurl4-openssl-dev nodejs libsqlite3-dev sqlite3
为 Ruby 源文件创建一个临时文件夹:
mkdir ~/ruby
切换到新文件夹:
cd ~/ruby
下载最新的稳定 Ruby 源代码。在撰写本文时,这是版本 2.1.3。你可以从 Download Ruby 网站获取当前最新版本。如果有新版本可用,你需要替换以下命令中的链接:
wget http://cache.ruby-lang.org/pub/ruby/2.1/ruby-2.1.3.tar.gz
解压下载的文件:
tar -xzf ruby-2.1.3.tar.gz
选择提取的目录:
cd ruby-2.1.3
运行配置脚本。这将花费一些时间,因为它会检查依赖关系并创建一个新的 Makefile,其中包含编译代码所需的步骤:
./configure
运行 make 实用程序,它将使用 Makefile 来构建可执行程序。这一步可能需要更长的时间:
make
现在,使用 install 参数再次运行相同的命令。它将尝试将已编译的二进制文件复制到 /usr/local/bin
文件夹。此步骤需要 root 访问权限才能写入此目录。这也需要一些时间:
sudo make install
Ruby 现在应该已安装在系统上。我们可以使用以下命令来检查,它应该打印出 Ruby 版本:
ruby -v
最后,我们可以删除临时文件夹:
rm -rf ~/ruby
步骤五 — 安装 Passenger 和 Nginx
过去安装 Passenger 的首选方法是使用 RubyGems 进行通用安装(passenger-install-nginx-module
)。
然而,现在你可以使用高级打包工具(APT)在 Ubuntu 上安装 Passenger,这就是我们将要使用的方法。通过这种方式,Passenger 与 Nginx 的安装,甚至更重要的是更新过程,都非常简单。
首先,安装一个 PGP 密钥:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 561F9B9CAC40B2F7
创建一个 APT 源文件(你将需要 sudo 权限):
sudo nano /etc/apt/sources.list.d/passenger.list
并在文件中插入以下行:
deb https://oss-binaries.phusionpassenger.com/apt/passenger trusty main
按下 CTRL+x 退出,输入 y 保存文件,然后按 ENTER 确认文件位置。
更改此文件的所有者和权限:
sudo chown root: /etc/apt/sources.list.d/passenger.list sudo chmod 600 /etc/apt/sources.list.d/passenger.list
更新 APT 缓存:
sudo apt-get update
最后,安装带有 Nginx 的 Passenger:
sudo apt-get install nginx-extras passenger
这一步将覆盖我们的 Ruby 版本为旧版本。要解决这个问题,只需删除错误的 Ruby 位置,并创建一个新的符号链接指向正确的 Ruby 二进制文件:
sudo rm /usr/bin/ruby sudo ln -s /usr/local/bin/ruby /usr/bin/ruby
第六步 — 设置 Web 服务器
打开 Nginx 配置文件:
sudo nano /etc/nginx/nginx.conf
在 http 块中找到以下行:
# passenger_root /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini; # passenger_ruby /usr/bin/ruby;
取消注释这两行。更新 passenger_ruby 行中的路径。它们应该如下所示:
passenger_root /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini; passenger_ruby /usr/local/bin/ruby;
保存并退出文件。
第七步 — 部署
此时,如果您已经准备好自己的 Rails 应用程序,可以部署您自己的应用程序。如果要部署现有应用程序,可以将项目上传到服务器并跳过 /etc/nginx/sites-available/default
步骤。
在本教程中,我们将直接在 Droplet 上创建一个新的 Rails 应用程序。我们将需要 rails gem 来创建新的应用程序。
移动到您的用户主目录(否则,您将收到错误 No such file or directory - getcwd
)–
cd ~
安装 rails gem(不安装额外文档以加快安装速度)。这仍然需要几分钟:
sudo gem install --no-rdoc --no-ri rails
现在我们可以创建一个新的应用程序。在我们的示例中,我们将使用名称 testapp。如果您想使用其他名称,请确保使用正确的路径。我们将跳过 Bundler 安装,因为我们希望稍后手动运行它。
rails new testapp --skip-bundle
进入目录:
cd testapp
现在我们需要安装一个 JavaScript 执行环境。它可以安装为 therubyracer gem。要安装它,请打开 Gemfile:
nano Gemfile
找到以下行:
# gem 'therubyracer', platforms: :ruby
取消注释它:
gem 'therubyracer', platforms: :ruby
保存文件,并运行 Bundler:
bundle install
我们需要禁用默认的 Nginx 配置。打开 Nginx 配置文件:
sudo nano /etc/nginx/sites-available/default
找到以下行:
listen 80 default_server; listen [::]:80 default_server ipv6only=on;
将其注释掉,如下所示:
# listen 80 default_server; # listen [::]:80 default_server ipv6only=on;
保存文件。
现在,为我们的应用程序创建一个 Nginx 配置文件:
sudo nano /etc/nginx/sites-available/testapp
添加以下 server
块。下面解释了这些设置。
server { listen 80 default_server; server_name www.mydomain.com; passenger_enabled on; passenger_app_env development; root /home/rails/testapp/public; }
在此文件中,我们启用在端口 80 上监听,设置您的域名,启用 Passenger,并将根目录设置为我们新项目的 public 目录。根行是您要编辑以匹配您的 Rails 应用程序上传位置的行。
如果您不想将您的域名分配给此应用程序,可以跳过 server_name 行,或使用您的 IP 地址。
为了测试我们的设置,我们希望看到 Rails Welcome aboard 页面。但是,这仅在应用程序以开发环境启动时才有效。Passenger 默认情况下以生产环境启动应用程序,因此我们需要使用 passenger_app_env
选项更改此设置。如果您的应用程序已准备好投入生产,您将希望省略此设置。
保存文件(CTRL+x, y, ENTER)。
为其创建一个符号链接:
sudo ln -s /etc/nginx/sites-available/testapp /etc/nginx/sites-enabled/testapp
重新启动 Nginx:
sudo nginx -s reload
现在您的应用程序的网站应该是可访问的。转到您的 Droplet 的域名或 IP 地址:
http://droplet_ip_address
并验证结果:
!Test page
您应该在服务器上看到 Rails 测试应用程序已上线。
第八步 — 定期更新
要更新 Ruby,您需要按照本教程中第四步中所示的方式编译最新版本。
要更新带有 Nginx 的 Passenger,您需要运行基本系统更新:
sudo apt-get update && sudo apt-get upgrade
但是,如果有新的系统 Ruby 版本可用,它可能会覆盖我们从源代码安装的 Ruby。因此,您可能需要重新运行删除现有版本的 Ruby 和创建新的符号链接到 Ruby 二进制文件的命令。它们列在本教程的第五步的末尾。
更新过程完成后,您需要重新启动 Web 服务器:
sudo service nginx restart