Envoy Task Runner trong Laravel 5.3
Xin chào các bạn. Hôm nay mình sẽ tiếp tục về series về Laravel. Và hôm nay mình sẽ giới thiệu với các bạn về Envoy Task Runner trong laravel và cách sử dụng . Giới thiệu Viết Tasks Task Variables Nhiều Servers Task Macros Thực thi Tasks Thông báo HipChat Slack <a ...
Xin chào các bạn. Hôm nay mình sẽ tiếp tục về series về Laravel. Và hôm nay mình sẽ giới thiệu với các bạn về Envoy Task Runner trong laravel và cách sử dụng .
- Giới thiệu
- Viết Tasks
- Task Variables
- Nhiều Servers
- Task Macros
- Thực thi Tasks
- Thông báo
- HipChat
- Slack
<a name="introduction"></a>
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.
<a name="envoy-installation"></a>
Cài đặt
Trước tiên, bạn sử dụng Composer global để cài Envoy:
composer global require "laravel/envoy=~1.0"
Cần phải chắc chắn đã đặt thư mục ~/.composer/vendor/bin vào trong biến môi trường PATH để envoy có thể được tìm thấy khi được gọi trên terminal.
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
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.
Các tasks nội bộ
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')
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
HipChat
Sau khi thực thi một task, bạn có thể gửi thông báo tới team của bạn qua HipChat sử dụng @hipchat. Directive này nhận API token, tên room và username để hiển thị:
@servers(['web' => '192.168.1.1']) @task('foo', ['on' => 'web']) ls -la @endtask @after @hipchat('token', 'room', 'Envoy') @endafter
Nếu muốn, bạn cũng có thể gửi một message tuỳ ý khi gửi nội dung gới phòng HipChat. Bất cứ biến nào có thể sử dụng trong Envoy task cũng có thể sử dụng được khi tạo message:
@after @hipchat('token', 'room', 'Envoy', "$task ran in the $env environment.") @endafter
Slack
Ngoài HipChat, 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
Như vậy mình đã giới thiệu cho các bạn khá là chi tiết về Envoy Task Runner trong laravel. Mọi thắc mắc cần giải đáp hãy để lại comment ở phía dưới nhé! Tham Khảo https://laravel.com/docs/5.4