Tập tành deploy với Capistrano

Chủ Nhật, 18/10/2020

Tram Ho

Chào các bạn, bài viết hôm nay mình sẽ viết về 1 chủ đề khá quen thuộc: Deploy 1 Rails app với Capistrano.

Bước vào thế giới của Ruby và Rails, hẳn các bạn sẽ đọc qua cuốn Ruby on Rails Tutorial, cuốn sách giúp bạn tiếp cận với Ruby on Rails từ zero tới deploy.

Các bạn sẽ được làm quen với các lệnh như git push heroku master, heroku run rails db:migrate, … và Rails app của bạn sẽ chạy ngon lành trên server của Heroku.

Bước vào những dự án thực tế, bạn sẽ bắt đầu xa dần với Heroku, thay vào đó sẽ là server AWS, server vật lý, và làm thế nào để deploy Rails app của bạn lên các server đó. Kể ra thì có khá là nhiều cách, từ dùng Docker, Codedeploy, Capistrano, … hay thậm chí là các bạn có thể access trực tiếp vào server rồi làm mọi thứ bằng cơm

Bài viết hôm nay mình sẽ hướng dẫn các bạn dựng 1 server trên máy local, mô phỏng các bước deploy 1 Rails app lên server đó bằng Capistrano – một thư viện hỗ trợ deploy có thể nói là tốt nhất hiện nay của Rails.

Dựng server deploy

Để deploy thì chắc chắn rồi, đầu tiên bạn cần phải có 1 server để Rails app chạy trên đó chứ nhỉ

Khá là dễ dàng, bạn có thể bỏ tiền ra mua 1 con server vật lý nào đó, hoặc đăng ký 1 tài khoản AWS, GCP tạo 1 cái instance. Mục đích cuối cùng là có 1 cái máy cài đặt môi trường đầy đủ để Rails app của bạn có thể chạy trên đó.

Tuy nhiên, nếu không có điều kiện thì các bạn có thể theo mình tự dựng 1 con server ảo ngay trên PC của chính mình.

Mình sẽ hướng dẫn các bạn cài Docker và run 1 container cài sẵn Ubuntu 18.04

<span class="token comment"># cài docker</span>
<span class="token function">curl</span> -fsSL https://get.docker.com/ <span class="token operator">|</span> <span class="token function">sh</span>
<span class="token comment"># Thêm current user vào docker group để khỏi dùng sudo</span>
<span class="token function">sudo</span> <span class="token function">usermod</span> -aG docker <span class="token environment constant">$USER</span>
<span class="token comment"># Nếu vẫn phải dùng sudo thì reset máy lại cho chắc</span>
<span class="token function">sudo</span> <span class="token function">reboot</span>

<span class="token comment"># Kiểm tra docker đã cài đặt thành công</span>
docker --version

<span class="token comment"># Run 1 container cài sẵn Ubuntu 18.04</span>
docker run --name ubuntu_server -it ubuntu:18.04 <span class="token function">bash</span>

<span class="token comment"># Lúc này con trỏ trong terminal của bạn đang nháy ở dòng có dạng</span>
<a class="__cf_email__" href="/cdn-cgi/l/email-protection">[email protected]</a>:/<span class="token comment">#</span>
<span class="token comment"># thì chúc mừng bạn đã có 1 server để sẵn sàng deploy rồi đấy</span>

# cài docker

curl -fsSL https://get.docker.com/ | sh

# Thêm current user vào docker group để khỏi dùng sudo

sudo usermod -aG docker $USER

# Nếu vẫn phải dùng sudo thì reset máy lại cho chắc

sudo reboot

# Kiểm tra docker đã cài đặt thành công

docker --version

# Run 1 container cài sẵn Ubuntu 18.04

docker run --name ubuntu_server -it ubuntu:18.04 bash

# Lúc này con trỏ trong terminal của bạn đang nháy ở dòng có dạng

<a class="__cf_email__" href="/cdn-cgi/l/email-protection">[email protected]</a>:/#

# thì chúc mừng bạn đã có 1 server để sẵn sàng deploy rồi đấy

Mà docker là gì? Đây lại là 1 kiến thức khá rộng nên mình sẽ không giải thích trong bài viết này. Nếu các bạn vẫn muốn tò mò muốn biết vì sao chỉ vài lệnh trên mà mình đã có 1 server thì có thể research Docker nhé. Các bạn cungx có thể xem nó như là 1 cái máy ảo, nhưng thực chất nó không phải là máy ảo đâu nhé. À mà nếu không muốn dùng Docker thì các bạn cũng có thể cài một cái máy ảo chạy trên HĐH của mình, tuy nhiên hãy chắc chắn rằng phần cứng của mình đảm bảo chạy được không lag nhé.

OK, vậy là chúng ta đã có 1 server đang chạy Ubuntu 18.04

Cài đặt môi trường

Hãy tưởng tượng các bạn vừa mua 1 chiếc máy tính mới toanh, cài đặt hệ điều hành Ubuntu 18.04. Bây giờ, muốn run 1 Rails app lên đó thì làm gì? Hãy làm điều tương tự với con server mà mình vừa dựng ở trên.

Hãy trở lại với terminal của chúng ta, khi bạn đang đứng ở

<a class="__cf_email__" href="/cdn-cgi/l/email-protection">[email protected]</a>:/<span class="token comment"># </span>

1 2	<a class="__cf_email__" href="/cdn-cgi/l/email-protection">[email protected]</a>:/<span class="token comment"># </span>

Lúc này bạn đang truy cập vào máy tên là 3788a1e70189 dưới quyền root.

À mà nếu lỡ tắt terminal hoặc thoát khỏi cái máy deploy ở trên, các bạn có thể bật lại bằng lệnh

docker start ubuntu_server

<span class="token comment"># Rồi access vào server bằng lệnh</span>
docker <span class="token builtin class-name">exec</span> -it ubuntu_server <span class="token function">bash</span>

docker start ubuntu_server

# Rồi access vào server bằng lệnh

docker exec -it ubuntu_server bash

Thực tế thì bạn sẽ phải tạo thêm user, cấp quyền vừa đủ để deploy chứ không deploy bằng root. Thử tạo user tên là deploy

adduser deploy
<span class="token comment"># Nhập password cho user deploy, các thông tin khác có thể để default</span>

<span class="token comment"># Install sudo</span>
<span class="token function">apt-get</span> update
<span class="token function">apt-get</span> <span class="token function">install</span> <span class="token function">sudo</span>

<span class="token comment"># Cấp quyền sudo cho deploy</span>
<span class="token function">apt-get</span> <span class="token function">install</span> <span class="token function">nano</span>
<span class="token function">sudo</span> <span class="token function">nano</span> /etc/sudoers

<span class="token comment"># Add thêm dòng này vào rồi lưu lại</span>
%deploy <span class="token assign-left variable">ALL</span><span class="token operator">=</span><span class="token punctuation">(</span>ALL<span class="token punctuation">)</span> ALL

<span class="token comment"># Chuyển sang user deploy để cài đặt môi trường</span>
<span class="token function">sudo</span> <span class="token function">su</span> - deploy

adduser deploy

# Nhập password cho user deploy, các thông tin khác có thể để default

# Install sudo

apt-get update

apt-get install sudo

# Cấp quyền sudo cho deploy

apt-get install nano

sudo nano /etc/sudoers

# Add thêm dòng này vào rồi lưu lại

%deploy ALL=(ALL) ALL

# Chuyển sang user deploy để cài đặt môi trường

sudo su - deploy

Ok bây giờ hãy cài đặt môi trường theo hướng dẫn quen thuộc này https://gorails.com/setup/ubuntu/18.04

Config deploy

Bây giờ hãy add thêm Capistrano và các gem hỗ trợ vào project của bạn. Bạn chỉ cần add các Gem này vào group development. Vì bản chất nó sẽ đứng ở local của bạn để deploy code lên server staging, production, …

<span class="token comment"># Gemfile</span>
group <span class="token symbol">:development</span> <span class="token keyword">do</span>
  gem <span class="token string">"capistrano"</span>
  gem <span class="token string">"capistrano3-puma"</span>
  gem <span class="token string">"capistrano-rails"</span><span class="token punctuation">,</span> <span class="token keyword">require</span><span class="token punctuation">:</span> <span class="token boolean">false</span>
  gem <span class="token string">"capistrano-bundler"</span><span class="token punctuation">,</span> <span class="token keyword">require</span><span class="token punctuation">:</span> <span class="token boolean">false</span>
  gem <span class="token string">"capistrano-rvm"</span>
<span class="token keyword">end</span>

# Gemfile

group :development do

gem "capistrano"

gem "capistrano3-puma"

gem "capistrano-rails", require: false

gem "capistrano-bundler", require: false

gem "capistrano-rvm"

end

bundle install để cài các thư viện của Capistrano vào máy local của bạn.

bundle exec cap install và Capistrano sẽ generate các file config sau

├── Capfile # Đây là file require các thư viện liên quan
├── config
│   ├── deploy
│   │   ├── production.rb # File config deploy cho môi trường production
│   │   └── staging.rb # File config deploy cho môi trường staging
│   └── deploy.rb # File config deploy chung
└── lib
    └── capistrano
            └── tasks

├── Capfile # Đây là file require các thư viện liên quan

├── config

│ ├── deploy

│ │ ├── production.rb # File config deploy cho môi trường production

│ │ └── staging.rb # File config deploy cho môi trường staging

│ └── deploy.rb # File config deploy chung

└── lib

└── capistrano

└── tasks

Khi bạn thực hiện deploy, Capistrano sẽ thực hiện require các thư viện từ Capfile, đọc các config từ config/deploy.rb rồi đọc các config từ config/deploy/{env}.rb. Cùng 1 config nhưng giá trị khác nhau giữa 2 file deploy.rb và {env}.rb thì giá trị ở {env}.rb là giá trị cuối cùng.

Bây giờ, hãy thử vọc vạch một số config cơ bản:

set <span class="token symbol">:repo_url</span><span class="token punctuation">,</span> <span class="token string">"<a class="__cf_email__" href="/cdn-cgi/l/email-protection">[email protected]</a>:{your_repo}.git"</span> <span class="token comment"># Chir ra cho Cap biết bạn sẽ muốn lấy code từ repo nào</span>
set <span class="token symbol">:branch</span><span class="token punctuation">,</span> <span class="token symbol">:master</span> <span class="token comment"># Bạn sẽ deploy code mới nhất từ branch nào, cái này sẽ khác nhau giữa các môi trường</span>
server <span class="token string">"172.17.0.2"</span><span class="token punctuation">,</span> user<span class="token punctuation">:</span> <span class="token string">"deploy"</span><span class="token punctuation">,</span> roles<span class="token punctuation">:</span> <span class="token string">%w(web app db)</span> <span class="token comment"># Thông tin về host và user của server deploy</span>
set <span class="token symbol">:stage</span><span class="token punctuation">,</span> <span class="token symbol">:production</span>
set <span class="token symbol">:rails_env</span><span class="token punctuation">,</span> <span class="token symbol">:production</span> <span class="token comment"># Set biến môi trường cho Rails app</span>
set <span class="token symbol">:deploy_to</span><span class="token punctuation">,</span> <span class="token string">"~/my_app"</span> <span class="token comment"># Chọn folder (ở máy server) để deploy vào</span>
set <span class="token symbol">:keep_releases</span><span class="token punctuation">,</span> <span class="token number">5</span> <span class="token comment"># Số phiên bản release mà bạn muốn giữ lại</span>
<span class="token comment"># 2 config tiếp theo sẽ lưu lại những file, folder cần giữ lại mỗi lần deploy, chúng sẽ được lưu ở folder "shared"</span>
set <span class="token symbol">:linked_files</span><span class="token punctuation">,</span> <span class="token string">%w{.env}</span>
set <span class="token symbol">:linked_dirs</span><span class="token punctuation">,</span> <span class="token string">%w{log tmp/pids tmp/cache tmp/sockets vendor/bundle public/upload node_modules}</span>

set :repo_url, "<a class="__cf_email__" href="/cdn-cgi/l/email-protection">[email protected]</a>:{your_repo}.git" # Chir ra cho Cap biết bạn sẽ muốn lấy code từ repo nào

set :branch, :master # Bạn sẽ deploy code mới nhất từ branch nào, cái này sẽ khác nhau giữa các môi trường

server "172.17.0.2", user: "deploy", roles: %w(web app db) # Thông tin về host và user của server deploy

set :stage, :production

set :rails_env, :production # Set biến môi trường cho Rails app

set :deploy_to, "~/my_app" # Chọn folder (ở máy server) để deploy vào

set :keep_releases, 5 # Số phiên bản release mà bạn muốn giữ lại

# 2 config tiếp theo sẽ lưu lại những file, folder cần giữ lại mỗi lần deploy, chúng sẽ được lưu ở folder "shared"

set :linked_files, %w{.env}

set :linked_dirs, %w{log tmp/pids tmp/cache tmp/sockets vendor/bundle public/upload node_modules}

Capistrano là một tool deploy tự động được xây dựng dựa trên Ruby, Rake và SSH. Nó sẽ đứng ở máy local của bạn SSH vào server và thực thi các Rake tasks theo trình tự. Vì vậy điều kiện đầu tiên để có thể deploy là tại máy local của bạn có thể access vào máy server bằng SSH.

Để có thể access vào server bằng SSH, rất đơn giản ta chỉ cần cung cấp SSH public key cho server deploy là xong. Từ máy local của bạn gõ cat ~/.ssh/id_rsa.pub để lấy SSH public key

Hãy trở lại với Terminal của chúng ta, nơi mà chúng ta đang access vào server deploy với user deploy. Chắc chắn rằng bạn đang đứng ở user deploy nhé

<a class="__cf_email__" href="/cdn-cgi/l/email-protection">[email protected]</a>:~$

<span class="token comment"># Cho phép server run SSH ở port 22</span>
<span class="token function">sudo</span> <span class="token function">apt-get</span> <span class="token function">install</span> -y openssh-server
<span class="token function">sudo</span> <span class="token function">service</span> <span class="token function">ssh</span> start

<span class="token comment"># Tạo folder .ssh</span>
<span class="token function">mkdir</span> ~/.ssh
<span class="token builtin class-name">cd</span> ~./ssh
<span class="token comment"># Tạo file authorized_keys để add các SSH key được phép truy cập vào server</span>
<span class="token function">touch</span> authorized_keys
<span class="token comment"># Cấp quyền thực thi cho authorized_keys</span>
<span class="token function">chmod</span> <span class="token number">600</span> authorized_keys

<a class="__cf_email__" href="/cdn-cgi/l/email-protection">[email protected]</a>:~$

# Cho phép server run SSH ở port 22

sudo apt-get install -y openssh-server

sudo service ssh start

# Tạo folder .ssh

mkdir ~/.ssh

cd ~./ssh

# Tạo file authorized_keys để add các SSH key được phép truy cập vào server

touch authorized_keys

# Cấp quyền thực thi cho authorized_keys

chmod 600 authorized_keys

Bây giờ open file authorized_keys và paste SSH public key của bạn vào đó, và bạn có thể từ local access vào server bằng lệnh ssh {user}@{host}. Trong đó user chính là deploy, host là địa chỉ của server. Để lấy địa chỉ của server bạn dựng trước đó, gõ docker inspect ubuntu_server | grep IPAddress, giá trị IPAddress chính là IP của máy server trên. Giả sử giá trị này là 172.17.0.2, hãy thử connect vào server bằng lệnh ssh [email protected]

Vậy là sắp xong công tác chuẩn bị, bây giờ giả sử bạn set môi trường cho con server deploy kia là production. Hãy config lại các giá trị cho file config/deploy.rb và config/deploy/production.rb. Đứng ở project folder của bạn ở máy local gõ lệnh cap production deploy, Cap sẽ giúp bạn tự động lấy code từ repo Github, và triển khai nó trên server deploy của bạn. Hãy đọc tất cả những dòng log sinh ra để hiểu Capistrano nó sẽ làm những bước gì khi triển khai code của bạn trên 1 server.

Tuy nhiên, đời sẽ không như mơ, những lần deploy đầu tiên bạn sẽ gặp tương đối là nhiều lỗi, chẳng hạn như chưa tạo file .env, cài Ruby chưa đúng phiên bản, chưa có DB, thiếu RAILS_MASTER_KEY, …. Đừng nản chí, hãy cố gắng đọc log (Capistrano nó ghi log khá rõ ràng) và fix từng lỗi một, khổ trước sướng sau mà

Mà lỗi rắc rối nhất chính là bật puma. Trên server, capistrano sẽ không bật puma ở port 3000 như máy local của chúng ta, nó sẽ run puma dưới dạng socket thông qua file config được lưu ở #{your_project_path}/shared/puma.rb trên máy server. SSH vào server của bạn, tạo file #{your_project_path}/shared/puma.rb

<span class="token comment">#!/usr/bin/env puma</span>

directory <span class="token string">"<span class="token interpolation"><span class="token delimiter tag">#{</span>project_path<span class="token delimiter tag">}</span></span>/current"</span>
rackup <span class="token string">"<span class="token interpolation"><span class="token delimiter tag">#{</span>project_path<span class="token delimiter tag">}</span></span>/current/config.ru"</span>
environment <span class="token string">"production"</span>

tag <span class="token string">""</span>

pidfile <span class="token string">"<span class="token interpolation"><span class="token delimiter tag">#{</span>project_path<span class="token delimiter tag">}</span></span>/shared/tmp/pids/puma.pid"</span>
state_path <span class="token string">"<span class="token interpolation"><span class="token delimiter tag">#{</span>project_path<span class="token delimiter tag">}</span></span>/shared/tmp/pids/puma.state"</span>
stdout_redirect <span class="token string">"<span class="token interpolation"><span class="token delimiter tag">#{</span>project_path<span class="token delimiter tag">}</span></span>/shared/log/puma_access.log"</span><span class="token punctuation">,</span> <span class="token string">"<span class="token interpolation"><span class="token delimiter tag">#{</span>project_path<span class="token delimiter tag">}</span></span>/shared/log/puma_error.log"</span><span class="token punctuation">,</span> <span class="token boolean">true</span>

threads <span class="token number">0</span><span class="token punctuation">,</span><span class="token number">8</span>

bind <span class="token string">"unix://<span class="token interpolation"><span class="token delimiter tag">#{</span>project_path<span class="token delimiter tag">}</span></span>/shared/tmp/sockets/puma.sock"</span>

workers <span class="token number">2</span>
daemonize <span class="token boolean">true</span>

prune_bundler


on_restart <span class="token keyword">do</span>
  puts <span class="token string">"Refreshing Gemfile"</span>
  <span class="token constant">ENV</span><span class="token punctuation">[</span><span class="token string">"BUNDLE_GEMFILE"</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token string">""</span>
<span class="token keyword">end</span>

#!/usr/bin/env puma

directory "#{project_path}/current"

rackup "#{project_path}/current/config.ru"

environment "production"

tag ""

pidfile "#{project_path}/shared/tmp/pids/puma.pid"

state_path "#{project_path}/shared/tmp/pids/puma.state"

stdout_redirect "#{project_path}/shared/log/puma_access.log", "#{project_path}/shared/log/puma_error.log", true

threads 0,8

bind "unix://#{project_path}/shared/tmp/sockets/puma.sock"

workers 2

daemonize true

prune_bundler

on_restart do

puts "Refreshing Gemfile"

ENV["BUNDLE_GEMFILE"] = ""

end

Hãy thử deploy lại, fix các lỗi lặt vặt cho đến khi Capistrano thông báo rằng tất cả các tasks của bạn đều success đồng nghĩa với code của bạn đã được triển khai thành công trên server deploy.

Public thành quả

Vì puma trên server deploy đang chạy dưới socket nên không thể truy cập vào ứng dụng của bạn bằng URL public được. Bước cuối cùng, cài đặt và config nginx cho phép từ bên ngoài xem được sản phẩm của bạn

Access vào server deploy bằng SSH, cài đặt nginx sudo apt-get install nginx.
Xóa file config mặc định của nginx sudo rm /etc/nginx/sites-enabled/default
Tạo file config sudo touch /etc/nginx/conf.d/default.conf
Open file config và thử với đoạn config sau (Mình xin phép không giải thích về các config trong bài viết này)

upstream app {
   # Path to Puma SOCK file, as defined previously
   server unix:{your_project_folder}/shared/tmp/sockets/puma.sock fail_timeout=0;
 }

 server {
   listen 80;

   root {your_project_folder}/current/public;

   try_files $uri/index.html $uri @app;

   location / {
     proxy_set_header X-Forwarded-Proto $scheme;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header Host $host;
     proxy_redirect off;
     proxy_set_header Connection '';
     proxy_pass http://app;
     proxy_read_timeout 150;
   }

   location ~ ^/(assets|fonts|system)/|favicon.ico|robots.txt {
     gzip_static on;
     expires max;
     add_header Cache-Control public;
   }

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

upstream app {

# Path to Puma SOCK file, as defined previously

server unix:{your_project_folder}/shared/tmp/sockets/puma.sock fail_timeout=0;

}

server {

listen 80;

root {your_project_folder}/current/public;

try_files $uri/index.html $uri @app;

location / {

proxy_set_header X-Forwarded-Proto $scheme;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header Host $host;

proxy_redirect off;

proxy_set_header Connection '';

proxy_pass http://app;

proxy_read_timeout 150;

}

location ~ ^/(assets|fonts|system)/|favicon.ico|robots.txt {

gzip_static on;

expires max;

add_header Cache-Control public;

}

error_page 500 502 503 504 /500.html;

client_max_body_size 4G;

keepalive_timeout 10;

}

Save lại và restart lại nginx sudo service nginx restart

Mở browser và truy cập vào server của bạn, như ví dụ của chúng ta là 172.17.0.2 và đón nhận thành quả

Chúc các bạn thành công và qua đó hi vọng các bạn có cái nhìn tổng quát về cách triển khai 1 ứng dụng Rails trên server của Capistrano.

Chia sẻ bài viết ngay

Nguồn bài viết : Viblo

Tập tành deploy với Capistrano

Dựng server deploy

Cài đặt môi trường

Config deploy

Public thành quả

TikTok trở thành nền tảng mảng xã hội lớn thứ hai ở Nam Phi

Mất giá nhanh nhất sau 9 tháng ra mắt, iPhone 14 Pro Max tiếp tục phá đáy tại Việt Nam

Hướng dẫn sử dụng ngôn ngữ R cho người mới bắt đầu

10 plugin cần thiết của SublimeText dành cho các lập trình viên JavaScript