Auto deploy bằng Envoy laravel

Giới thiệu

Laravel Envoy cung cấp một cú pháp đơn giản và gọn gàng cho việc khai báo các tác vụ thường được thực thi trên servers. Bằng việc sử dụng cú pháp của Blade, bạn có thể dễ dàng thiết lập các tác vụ cho triển khai dự án, chạy câu lệnh Artisan và nhiều nữa. Ở thời điểm hiện tại, Envoy chỉ hỗ trợ trên hệ điều hành của Mac và Linux.

Cài đặt

Trước tiên, bạn sử dụng Composer global để cài Envoy:

composer global require "laravel/envoy=~1.0"

Tiếp theo bạn cần export path ~/.composer/vendor/bin vào biến môi trường để chạy:

Đối với linux và macos chạy lệnh sau:

export PATH="$PATH:~/.composer/vendor/bin" // export vào biến mỗi trường
source ~/.bashrc  // reload lại biến
echo $PATH // kiểm tra xem đã có thư mục ~/.composer/vendor/bin chưa
result: .. /snap/bin:/home/nguyenvanduong/.composer/vendor/bin // ok có rồi này.

Cập nhật Envoy

Bạn cũng có thể sử dụng Composer để đảm bảo Envoy luôn là bản mới nhất:

composer global update

Viết Tasks Nào

Tất cả các Envoy task phải được khai báo trong một file Envoy.blade.php tại root của project. Đây là một ví dụ để bạn làm quen:

@servers(['web' => 'user@192.168.1.1'])

@task('foo', ['on' => 'web'])
    ls -la
@endtask

Như bạn thế, một mảng các @servers được khai báo ở ngay đầu file, cho phép bạn tham chiếu tới các server này trong tuỳ chọn on của khai báo task. Bên trong khai báo @task, bạn nên đặt đoạn mã Bash sẽ được thực thi trên server khi mà task được gọi.

Mặc định envoy sẽ connect tới server của bạn bằng ssh với port 22, vì vậy bạn cần phải add ssh key máy của bạn vào server để có thể chạy. Nếu ssh không dùng port 22 thì chỉ cần đổi chỗ này 'web' => 'user@192.168.1.1 -p 44, 44 chính là port của server.

Các tasks đến local

Bạn có thể khai báo một script để chạy local bằng cách khai báo tham chiếu tới server local:

@servers(['localhost' => '127.0.0.1'])

Khởi tạo

Đôi lúc, bạn cần thực thi một số đoạn mã PHP trước khi thực thi Envoy task. Bạn có thể sử dụng @setup để khai báo các biến và thực thi các mã PHP bên trong:

@setup
    $now = new DateTime();

    $environment = isset($env) ? $env : "testing";
@endsetup

Bạn cũng có thể sử dụng @include để thêm vào các file PHP ở bên ngoài:

@include('vendor/autoload.php')

Vì envoy sử dụng file `.Blade' để thực thi nên bạn hoàn toàn có thể dùng cú pháp của blade để viết.

Xác nhận thực hiện task

Nếu bạn muốn yêu cầu xác nhận thực thi trước khi chạy một task trên server, bạn có thể thêm vào confirm trong khai báo task:

@task('deploy', ['on' => 'web', 'confirm' => true])
    cd site
    git pull origin {{ $branch }}
    php artisan migrate
@endtask

Task Variables

Khi cần thiết, bạn có thể truyền biến vào trong file Envoy, cách này sẽ cho phép bạn tuỳ biến tasks:

envoy run deploy --branch=master

Bạn có thể sử dụng tuỳ chọn trong task thông qua cú pháp "echo" của Blade:

@servers(['web' => '192.168.1.1'])

@task('deploy', ['on' => 'web'])
    cd site
    git pull origin {{ $branch }}
    php artisan migrate
@endtask

Nhiều Servers

Bạn có thể dễ dàng thực thi một task trên nhiều servers. Đầu tiên, khai báo các server trong khai báo @servers. Mỗi server phải được gán một tên khác biệt. Khi mà bạn đã khai báo đầy đủ, thì đơn giản chỉ cần đưa ra tên các server muốn thực thi trong khai báo task ở mảng on:

@servers(['web-1' => '192.168.1.1', 'web-2' => '192.168.1.2'])

@task('deploy', ['on' => ['web-1', 'web-2']])
    cd site
    git pull origin {{ $branch }}
    php artisan migrate
@endtask

Mặc định, task sẽ được thực thi trên các server một cách lần lượt. Nghĩa là, khi task thực thi xong ở server thì mới tiếp tục chuyển sang thực thi ở server tiếp theo.

Thực thi song song

Nếu bạn muốn thực thi task trên nhiều servers một cách song song, thêm vào tuỳ chọn parallel vào trong khai báo task:

@servers(['web-1' => '192.168.1.1', 'web-2' => '192.168.1.2'])

@task('deploy', ['on' => ['web-1', 'web-2'], 'parallel' => true])
    cd site
    git pull origin {{ $branch }}
    php artisan migrate
@endtask

Task Macros

Macros cho phép bạn định nghĩa một tập hợp task được chạy lần lượt sử dụng một câu lệnh. Ví dụ, một macro deploy có thể chạy hai task git và composer:

@servers(['web' => '192.168.1.1'])

@macro('deploy')
    git
    composer
@endmacro

@task('git')
    git pull origin master
@endtask

@task('composer')
    composer install
@endtask

Khi mà macro được định nghĩa, bạn có thể chạy qua câu lệnh đơn giản:

envoy run deploy

Thực thi Tasks

Để thực thi task từ Envoy.blade.php, thực thi câu lệnh run, chỉ cần truyền vào tên của task hay macro bạn muốn thực thi. Envoy sẽ thực thi task và hiển thị kết quả từ servers khi task đang chạy:

envoy run task

Thông báo Đến Slack

Envoy cũng hỗ trợ gửi thông báo tới Slack. Directive @slack nhận link hook, tên channel và nội dung tin bạn muốn gửi tới channel:

@after
    @slack('hook', 'channel', 'message')
@endafter

Bạn có thể nhận webhook URL bằng cách tạo một tích hợp Incoming WebBooks trên trang chủ của Slack. Đối số hook phải là giá trị đầy đủ của webhook URL được tạo ra qua Incoming WebHooks của Slack. Ví dụ:

https://hooks.slack.com/services/ZZZZZZZZZ/YYYYYYYYY/XXXXXXXXXXXXXXX

Bạn có thể cung cấp một trong những đối số channel sau:

• To send the notification to a channel: #channel
• To send the notification to a user: @user

Tài liệu

• https://laravel.com/docs/5.5/envoy