Blog cộng đồng về Công nghệ thông tin

Capistrano là gì?

Capistrano đã rất nổi tiếng, hãy đọc Wikipedia, thông tin ở trang nhà, và tự google thêm. Nó hoạt động tương tự các công cụ tự động hóa như make, ant, maven. Điểm khác biệt là thay vì tác động lên máy của bạn, nó tác động lên server ở xa.

Capistrano viết bằng Ruby nên project viết bằng Ruby đều dùng, nhưng hiển nhiên project Java này nọ vẫn dùng được vô tư, miễn project có nhu cầu cài đặt từ xa thì đều dùng Capistrano được ngốc ạ.

Cài đặt Rails project để chạy với Mongrel

Để hiểu phần này, cần biết Rails và đọc qua ít nhất Getting Started.

Nếu make có makefile, ant có build.xml, maven có pom.xml, thì Capistrano có Capfile, là tập hợp các task. cho phép override và thêm before/after hook cho task. Ta override 3 task deploy:start, deploy:stop, deploy:restart như sau:

# If you use SSH key on Mac OS, run the following before running cap xxx:
# eval `ssh-agent`
# ssh-add

set :application, 'myapplication'
set :repository,  'http://path/to/mysubversion/repository/trunk'
set :host, 'myserver.com'
set :user, 'me'
set :deploy_to, "/home/#{user}/#{application}"

set :deploy_via, :export  # Use export rather than checkout
set :runner, nil
set :mongrel_conf, "#{deploy_to}/current/config/mongrel_cluster.yml"

#-------------------------------------------------------------------------------

role :app, host
role :web, host
role :db,  host, :primary => true

namespace :deploy do
  namespace :mongrel do
    [:stop, :start, :restart].each do |t|
      desc "#{t.to_s.capitalize} the mongrel appserver"
      task t, :roles => :app do
        run "mongrel_rails cluster::#{t.to_s} -C #{mongrel_conf}"
      end
    end
  end

  desc "Custom restart task for mongrel cluster"
  task :restart, :roles => :app, :except => {:no_release => true} do
    deploy.mongrel.restart
  end

  desc "Custom start task for mongrel cluster"
  task :start, :roles => :app do
    deploy.mongrel.start
  end

  desc "Custom stop task for mongrel cluster"
  task :stop, :roles => :app do
    deploy.mongrel.stop
  end
end

Lần cài đặt đầu chạy cap deploy:setup rồi cap deploy:cold là xong. Các lần sau chỉ cần chạy cap deploy. Tập tin mongrel_cluster.yml cần có dòng cwd (change working directory) như sau:

---
cwd: /absolute/path/to/myrails/app/current
log_file: log/mongrel.log
port: "3001"
environment: production
address: 127.0.0.1
pid_file: tmp/pids/mongrel.pid
servers: 5

Cấu hình riêng cho từng server

Nếu project cần cài lên nhiều server, thì vì thường mỗi server có cấu hình khác nhau, ta cần có phần cấu hình riêng cho từng server. Project Rails thường có 3 tập tin cấu hình cần điều chỉnh khi cài đặt:

• config/database.yml
• config/mongrel_cluster.yml
• config/initializers/config.rb

Ta giải quyết bằng cách cấu hình thủ công khi cài đặt lần đầu như sau:

• Khi viết chương trình, tạo database.yml.sample, mongrel_cluster.yml.sample, config.rb.sample có nội dug chung chung không ứng với server cụ thể.
• Thêm đoạn sau vào deploy.rb, vào trong namespace deploy:
  

    task :after_symlink, :roles => :app do
      run "ln -s #{deploy_to}/shared/config/database.yml #{deploy_to}/current/config/database.yml"
      run "ln -s #{deploy_to}/shared/config/mongrel_cluster.yml #{deploy_to}/current/config/mongrel_cluster.yml"
      run "ln -s #{deploy_to}/shared/config/initializers/config.rb #{deploy_to}/current/config/initializers/config.rb"
    end

• Lần cài đặt đầu: (1) chạy cap deploy:setup (2) SSH vào server, tạo thư mục config trong thư mục shared, copy các tập tin sample vào đó rồi sửa cho phù hợp (3) chạy cap deploy:cold.

Công cụ phụ trợ

Quản lí bằng giao diện web: Webistrano