Tự động triển khai Laravel với Capistrano

Chủ Nhật, 22/12/2019

Tram Ho

Với việc hỗ trợ của các tool tự động thì việc thự hiện “Zero Downtime Deployment” không còn là vấn đề khó cho hầu hết các project web. Vấn đề hiện tại là chọn tool nào cho dự án của mình. Với Laravel, chúng ta có khá là nhiều lựa chọn được viết bằng PHP như:

Rocketeer – http://rocketeer.autopergamene.eu/
Envoy – https://laravel.com/docs/6.x/envoy
Deployer – https://deployer.org/

Tuy nhiên trong bài này, mình sẽ nói về việc triển khai auto deploy project Laravel với capistrano – 1 gem của ruby.

1. Giới thiệu

Có khá là nhiều bài viết về Capistrano trên viblo nên mình chỉ giới thiệu sơ lược về Capistrano.

Capistrano là 1 tool được viết bằng ngôn ngữ Ruby cho phép việc tự động thực hiện một tập hợp các câu lệnh trên 1 hay 1 vài remote server bằng cách sử dụng SSH. Capistrano có thể chạy song song trên nhiều server cùng lúc, việc này giúp chúng ta giảm thiểu đáng kể thời gian deploy khi cần deploy lên nhiều server.

2. Triển khai

Mình đã triển khai và đẩy code lên laravel-capistrano, và trong bài viết này mình sẽ dựa vào code trên github trên.

Sau khi triển khai, cấu trúc thư mục của project sẽ tương tự như sau:

<span class="token operator">=</span><span class="token keyword">begin</span> <span class="token constant">Deploy</span> directory structure<span class="token punctuation">:</span>
<span class="token operator">/</span>var<span class="token operator">/</span>www<span class="token operator">/</span>test<span class="token operator">-</span>deploy
├── current <span class="token operator">-</span><span class="token operator">&gt;</span> <span class="token operator">/</span>var<span class="token operator">/</span>www<span class="token operator">/</span>test<span class="token operator">-</span>deploy<span class="token operator">/</span>releases<span class="token operator">/</span><span class="token number">20191216080141</span>
├── releases
│   ├── <span class="token number">20191216075447</span>
│   ├── <span class="token number">20191216075558</span>
│   ├── <span class="token number">20191216075711</span>
│   ├── <span class="token number">20191216075932</span>
│   └── <span class="token number">20191216080141</span>
├── repo
│   ├── <span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span>
│   └── <span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span>
├── revisions<span class="token punctuation">.</span>log
└── shared
    ├── <span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span>
    └── storage 
<span class="token operator">=</span><span class="token keyword">end</span>

=begin Deploy directory structure:

/var/www/test-deploy

├── current -> /var/www/test-deploy/releases/20191216080141

├── releases

│ ├── 20191216075447

│ ├── 20191216075558

│ ├── 20191216075711

│ ├── 20191216075932

│ └── 20191216080141

├── repo

│ ├── ....

│ └── ....

├── revisions.log

└── shared

├── ....

└── storage

=end

2.1. Cài đặt các thành phần cần thiết

Bạn cần cài đặt ruby và gem capistrano trên máy đặt config của Capistrano
Bạn cần chắc chắn máy này có thể ssh vào server mà bạn muốn deploy
Bạn cần chắc chắn server phải có quyền truy cập vào git/svn/… chứa code cần deploy
Cài đặt gem capistrano

gem <span class="token function">install</span> capistrano

1 2	gem <span class="token function">install</span> capistrano

optional: nếu các bạn muốn thông báo lên slack thì các bạn cần cài đặt thêm gem slackistrano

gem <span class="token function">install</span> slackistrano

1 2	gem <span class="token function">install</span> slackistrano

2.2. Configure

Sau khi clone code trên github, chúng ta chỉ cần chỉnh sửa file config là có thể thực hiện deploy luôn.

<span class="token function">cp</span> config/deploy.rb.example config/deploy.rb
<span class="token function">cp</span> config/deploy/staging.rb.example config/deploy/staging.rb
<span class="token function">cp</span> config/deploy/production.rb.example config/deploy/production.rb

cp config/deploy.rb.example config/deploy.rb

cp config/deploy/staging.rb.example config/deploy/staging.rb

cp config/deploy/production.rb.example config/deploy/production.rb

`config/deploy.rb`

Trong file này bạn cần cập nhật lại thông tin của các thành phần như sau:

<span class="token comment"># Config application</span>
set <span class="token symbol">:application</span><span class="token punctuation">,</span> <span class="token string">"test-deploy"</span>
set <span class="token symbol">:repo_url</span><span class="token punctuation">,</span> <span class="token string">"<a href="/cdn-cgi/l/email-protection" class="__cf_email__" data-cfemail="d9beb0ad99beb0adb1acbbf7bab6b4">[email protected]</a>:YOUR_USER_NAME/REPOSITORY.git"</span>

<span class="token comment"># Config for deploy path</span>
set <span class="token symbol">:deploy_to</span><span class="token punctuation">,</span> <span class="token string">'/var/www/test-deploy'</span>
set <span class="token symbol">:releases_dir</span><span class="token punctuation">,</span> <span class="token string">'/var/www/test-deploy/releases'</span>

<span class="token comment"># Default env</span>
set <span class="token symbol">:dotenv_file</span><span class="token punctuation">,</span> <span class="token string">'/PATH/TO/.env'</span>

<span class="token comment"># Default value for keep_releases is 5</span>
set <span class="token symbol">:keep_releases</span><span class="token punctuation">,</span> <span class="token number">5</span>

<span class="token comment"># List of worker servers</span>
set <span class="token symbol">:workers_servers</span><span class="token punctuation">,</span> <span class="token punctuation">[</span><span class="token punctuation">]</span>

<span class="token comment"># Slack configure</span>
set <span class="token symbol">:slackistrano</span><span class="token punctuation">,</span> <span class="token punctuation">{</span>
   klass<span class="token punctuation">:</span> <span class="token constant">Slackistrano</span><span class="token punctuation">:</span><span class="token punctuation">:</span><span class="token constant">CustomMessaging</span><span class="token punctuation">,</span>
   channel<span class="token punctuation">:</span> <span class="token string">'#your-channel'</span><span class="token punctuation">,</span>
   webhook<span class="token punctuation">:</span> <span class="token string">'your-incoming-webhook-url'</span>
<span class="token punctuation">}</span>

# Config application

set :application, "test-deploy"

set :repo_url, "<a href="/cdn-cgi/l/email-protection" class="__cf_email__" data-cfemail="d9beb0ad99beb0adb1acbbf7bab6b4">[email protected]</a>:YOUR_USER_NAME/REPOSITORY.git"

# Config for deploy path

set :deploy_to, '/var/www/test-deploy'

set :releases_dir, '/var/www/test-deploy/releases'

# Default env

set :dotenv_file, '/PATH/TO/.env'

# Default value for keep_releases is 5

set :keep_releases, 5

# List of worker servers

set :workers_servers, []

# Slack configure

set :slackistrano, {

klass: Slackistrano::CustomMessaging,

channel: '#your-channel',

webhook: 'your-incoming-webhook-url'

}

Nếu dự án của bạn không dùng slack, bạn có thể comment đoạn code config của slack ở trên lại.

`config/deploy/production.rb`

<span class="token comment"># server web detail</span>
<span class="token comment"># You need to change ip and user for your server</span>
server <span class="token string">'10.0.0.10'</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 laravel}</span>

<span class="token comment"># Config ssh option</span>
set <span class="token symbol">:ssh_options</span><span class="token punctuation">,</span> <span class="token punctuation">{</span>
   keys<span class="token punctuation">:</span> <span class="token string">%w(LINK/TO/YOUR/private_key)</span><span class="token punctuation">,</span>
   forward_agent<span class="token punctuation">:</span> <span class="token keyword">false</span><span class="token punctuation">,</span>
   auth_methods<span class="token punctuation">:</span> <span class="token string">%w(publickey)</span>
<span class="token punctuation">}</span>

# server web detail

# You need to change ip and user for your server

server '10.0.0.10', user: 'deploy', roles: %w{web app laravel}

# Config ssh option

set :ssh_options, {

keys: %w(LINK/TO/YOUR/private_key),

forward_agent: false,

auth_methods: %w(publickey)

}

2.3. Deploy

Để deploy, các bạn có thể tham khảo cách sử dụng bên dưới

<span class="token comment"># Deploy with default branch in config deploy.rb</span>
cap staging deploy

<span class="token comment"># Deploy with tag 1.0.1</span>
cap staging deploy branch<span class="token operator">=</span>1.0.1

<span class="token comment"># Deploy with tag 1.0.2 and run Seeder_0_0_1 and Seeder_0_0_2</span>
cap staging deploy branch<span class="token operator">=</span>1.0.2 seeders<span class="token operator">=</span>Seeder_0_0_1,Seeder_0_0_2

<span class="token comment"># Rollback deploy</span>
cap staging rollback

<span class="token comment"># Rollback deploy to specific release</span>
cap staging rollback ROLLBACK_RELEASE<span class="token operator">=</span>20191001101213

# Deploy with default branch in config deploy.rb

cap staging deploy

# Deploy with tag 1.0.1

cap staging deploy branch=1.0.1

# Deploy with tag 1.0.2 and run Seeder_0_0_1 and Seeder_0_0_2

cap staging deploy branch=1.0.2 seeders=Seeder_0_0_1,Seeder_0_0_2

# Rollback deploy

cap staging rollback

# Rollback deploy to specific release

cap staging rollback ROLLBACK_RELEASE=20191001101213

2.4. Run single task

Ngoài việc thực hiện 1 tập hợp các task/câu lệnh như trên thì chúng ta có thể thực hiện từng câu lệnh riêng rẽ:

<span class="token comment"># Rollback migrate</span>
cap staging laravel:migrate_rollback

<span class="token comment"># List all release (for rollback release above)</span>
cap staging web:release_list

# Rollback migrate

cap staging laravel:migrate_rollback

# List all release (for rollback release above)

cap staging web:release_list

2.5. Mở rộng

Code của mình ở trên chỉ đáp ứng được việc deploy một project laravel cơ bản. Nếu các bạn cần thêm các tác vụ đặc biệt khác, các bạn có thể viết thêm và đặt vào thư mục lib/capistrano/tasks, nó sẽ tự động được include trong quá trình chạy.

Kết

Như các bạn thấy, việc thực hiện deploy project laravel với capistrano khá là đơn giản. Chỉ cần vài config cơ bản là bạn có thể deploy ngay

Chia sẻ bài viết ngay

Nguồn bài viết : Viblo