Ubuntu 14 + Nginx + Passenger + Solr 5.2.1 + Rails 4.2.1 + Sunspot

2015.6.24

Local 端開發、測試

使用 rvm, 安裝 ruby 2.2.1, rails 4.2.1

在 rails 專案資料夾下建檔 .ruby-version

ruby-2.2.1

在 rails 專案資料夾下建檔 .ruby-gemset

rails421

Local 端安裝、設定 Capistrano

edit local Gemfile

group :development do

  gem 'capistrano-rails'

  gem 'capistrano-rvm'

  gem 'capistrano-passenger'

end

group :production do

  gem 'pg'

end

安裝

bundle install --without production

Capistrano 初始化

cd [ProjectRoot]

cap install

編輯 Capfile

require 'capistrano/rvm'

require 'capistrano/bundler'

require 'capistrano/rails/assets'

require 'capistrano/rails/migrations'

require 'capistrano/passenger'

在 config/deploy.rb 裡設定共用資訊 (假設專案名稱為 xxx)

set :application, 'xxx'

set :repo_url, 'git@gitlab.com:dila/xxx.git'

set :deploy_to, '/project/path/on/server'

set :linked_files, fetch(:linked_files, []).push('config/database.yml', 'config/secrets.yml')

set :linked_dirs, fetch(:linked_dirs, []).push('db/import')

set :passenger_restart_with_sudo, true

上面的 deploy_to 是 server 上要放置本專案的路徑。

linked_files, 會建一個 symbolic link 由 current/config/database.yml 指到 shared/config/database.yml.

編輯 config/deploy/production.rb

server 'example.com.tw', user: 'UserName', roles: %w{web}

set :rvm_ruby_version, '2.2.1@rails421'

上面的 example.com.tw 要換成 server 的網址。

UserName 要換成連上 server 的 user name.

把 application 放上 gitlab

在 gitlab 新建一個 project

如果 gitlab project owner 不是自己，那要將自己的 gitlab 帳號加入這個 gitlab project 的 members，這樣待會才能 push.

在 local 端將 rails app project 初始化為 git repository

cd [ProjectRoot]

git init

gitnore

編輯 .gitignore 設定哪些東西不要放進 git

/public/data/*

/config/database.yml

/config/secrets.yml

/db/import

.DS_Store

我的某些專案裡，使用 public/data 放供下載的檔案，這些檔案不必放上 git。如果沒用到，可以不必設。

database.yml 裡面有密碼，不要放上 git.

secrets.yml 裡面有 secret key，也不放上 git.

我的某些專案裡，使用 /db/import 放一些要匯入資料庫的檔案，這些檔不放上 git。如果沒用到，可以不必設。

.DS_Store 是 mac 產生的檔，也可以使用以下命令設為 global ignore:

git config --global core.excludesfile '~/.gitignore_global'

如果有使用 sunspot solr 做全文檢索，要再忽略下列檔案，免得把一些索引檔放上 git：

/solr/data

/solr/default/data

/solr/development

/solr/pids

/solr/test

push

在 project roog 下執行以下命令，push 到 gitlab:

git add .

git commit -m 'first commit'

git remote add origin git@gitlab.com:xxx/xxx.git

git push -u origin master

上面的 git@gitlab.com:xxx/xxx.git 要改成真正的 git repository path.

Server 安裝 nginx + passenger

參考 在 Ubuntu 14 安裝 Nginx + Passenger

Server 安裝 rvm, ruby, rails

安裝 rvm (參考: https://rvm.io/)

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

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

使用 rvm 安裝 ruby 2.2.1

rvm install 2.2.1

rvm use 2.2.1

建立 gemset

rvm gemset create rails421

切換 gemset

rvm 2.2.1@rails421

安裝 rails 4.2.1

gem install rails -v 4.2.1

安裝 gem pg

sudo apt-get install libpq-dev

gem install pg

如果不先安裝 libpq-dev 的話，安裝 pg 會有問題。

rails 需要 Javascript 直譯器，安裝 Javascript runtime library：

sudo apt-get install nodejs

如果希望在 server 上執行 rake 命令時都是 production mode, 可以編輯 ~/.bashrc

export RAILS_ENV=production

安裝 Solr

如果不使用 Solr 可以跳過這部份。

參考 在 Ubuntu 14 安裝 Solr 5.2.1

安裝好 solr 之後，編輯 local 端 config/sunspot.yml

production:

  solr:

    hostname: localhost

    port: 8983

    log_level: WARNING

    path: /solr/xxx

注意上面的 xxx 要改為專案名稱。

PostgreSQL 設定

查看目前 server 上的 PostgreSQL 版本：

安裝 PostgreSQL

sudo apt-get update

sudo apt-get install postgresql postgresql-contrib

設定主機上的 PostgreSQL 資料庫。

新增資料庫 user

參考：PostgreSQL add or create a user account and grant permission for database

sudo adduser pg_xxx

上面的 pg_xxx 請改為真正的 user name, 通常我都是在 pg_ 後面加上專案名稱。

執行過程中要設定密碼，假設密碼設為 1234，後面會用到這個密碼。

新增 database, 並設權限

change to the postgres unix user

sudo su - postgres

執行

psql

create user pg_xxx with password '1234';

create database xxx;

grant all privileges on database xxx to pg_xxx;

ALTER DATABASE xxx OWNER TO pg_xxx;

ALTER USER pg_xxx CREATEDB;

\q

上面的 xxx 請改為專案名稱。

要給 create database 的權限，才能執行 rake db:reset。（如果沒有 create database 權限，db:reset 在 create database 時會失敗，但是好像也沒關係，因為它還是重建所有 table，而且在 create database 之前，通常 drop database 就會失敗了，因為有其他 connection 存在。）

切換為原 user

測試連線

sudo su - pg_xxx

psql -d xxx -U pg_xxx

成功後，輸入 \q 離開 psql，輸入 exit 切換回原 user。

在 server 上安裝 git

$ sudo apt-get update

$ sudo apt-get install git

將 rails project 從 Local 端 deploy 到 server 上

ssh private key 要放在 ~/.ssh 裡面，這樣才能由 server 連到 gitlab 取得 source.

在 local 端 project root 下執行

cap production deploy

它會在 server 端建立專案資料夾，但是它會抱怨找不到 database.yml。

設定 database.yml

rails 根據 database.yml 來連上資料庫。下一步在 server 上的 project root 建立 shared/config/database.yml

production:

  adapter: postgresql

  encoding: unicode

  database: xxx

  host: localhost

  pool: 5

  username: pg_xxx

  password: 1234

設定 secrets.yml

把 local 端的 config/secrets.yml 傳到 server 端 shared/config/secrets.yml

在 local 端執行 rake secret 得到一個新的 secret key

把這個新的 secret key 寫到 shared/config/secrets.yml

production:

  secret_key_base: xxxxxxxxxx

在 local 端再次執行

cap production deploy

這次應該就可以完成了。

設定 nginx

網址是獨立 DNS

例如 http://xxx.dila.edu.tw

新增 /etc/nginx/sites-available/xxx，內容範例：

server {

  listen 80;

  server_name xxx.dila.edu.tw;

  root /data/projects/xxx/current/public;

  passenger_enabled on;

  passenger_ruby /home/YourUserName/.rvm/wrappers/ruby-2.2.1@rails421/ruby;

}

上面的 YourUserName 要改為你的 user name.

在 sites-enabled 裡建一個 symbolic link

sudo ln -s /etc/nginx/sites-available/xxx /etc/nginx/sites-enabled/xxx

重新啟動 nginx

sudo service nginx restart

網址使用 subdirectory

例如 http://xxx.dila.edu.tw/xxx

編輯 /etc/nginx/sites-available/default

location ~ ^/xxx(/.*|$) {

  alias /path/to/project/root/current/public$1;  # <-- be sure to point to 'public'!

  passenger_base_uri /xxx;

  passenger_app_root /path/to/project/root/current;

  passenger_document_root /path/to/project/root/current/public;

  passenger_enabled on;

  passenger_ruby /home/YourUserName/.rvm/wrappers/ruby-2.2.1@rails421/ruby;

}

上面的 /path/to/project/root 要改為真正的專案路徑。

passenger_ruby 裡面的 YourUserName 要改為你的 user name.

重新啟動 nginx

sudo service nginx restart