Có lẽ mọi người cũng không xa lạ gì về Laravel Queue nên mình sẽ không giới thiệu lại nhé. Mọi người có thể lên Laravel doc để đọc nhé!
Như mọi người cũng biết để Queue được hoạt động, ta phải chạy lệnh:
|
1 2 |
php artisan queue:work |
Queue chạy liên tục ko ngừng nghỉ nên nếu chúng ta dùng terminal (hoặc cmd) thì khi tắt terminal/cmd đi thì coi như queue cũng tắt luôn (thấy khó chịu phải không mọi người). Và hôm nay mình sẽ giới thiệu mọi người dùng supervisor để hỗ trợ chúng ta làm điều này. Cùng tìm hiểu nhé!
1. Supervisor là gì?
Supervisor là công cụ giúp quản lý các tiến trình chạy trên Linux. Một số ưu điểm mà Supervisor như:
- Đảm bảo một tiến trình nào đó luôn luôn chạy không ngừng nghỉ. Nếu vì lý do gì mà nó bị tắt, Supervisor sẽ khởi động process đó lại.
- Tự động chạy một tiến trình khi khởi động hệ thống.
- Quản lý nhiều tiến trình dưới dạng một group các tiến trình , có thể được bật/tắt cùng lúc.
- Log được lại quá trình chạy Queue Job.
- Trong trường hợp tiến trình mà supervisor thực thi phát sinh lỗi, có thể cấu hình để Supervisor retry lại một số lần nhất định trước khi chính thức báo fail.
2. Cài đặt Supervisor
Để cài Supervisor, mọi người chạy lệnh sau trên Linux:
|
1 2 |
sudo apt-get install supervisor |
Sau khi cài đặt xong supervisor được tạo thư mục /etc của máy.
3. Cấu hình cơ bản Supervisor
Mỗi tiến trình do Supervisor giám sát sẽ được cấu hình ở file dạng .conf nằm trong thư mục /etc/supervisor/conf.d
Cấu trúc 1 file config cơ bản như sau:
|
1 2 3 4 5 6 7 8 9 10 11 |
<span class="token punctuation">[</span>program<span class="token punctuation">:</span>laravel<span class="token operator">-</span>worker<span class="token punctuation">]</span> process_name<span class="token operator">=</span><span class="token operator">%</span><span class="token punctuation">(</span>program_name<span class="token punctuation">)</span>s_<span class="token operator">%</span><span class="token punctuation">(</span>process_num<span class="token punctuation">)</span><span class="token number">02</span>d directory<span class="token operator">=</span><span class="token operator">/</span>path<span class="token operator">/</span>to<span class="token operator">/</span>your<span class="token operator">/</span>project command<span class="token operator">=</span>sendmail<span class="token punctuation">.</span>sh autostart<span class="token operator">=</span><span class="token boolean constant">true</span> autorestart<span class="token operator">=</span><span class="token boolean constant">true</span> user<span class="token operator">=</span>forge numprocs<span class="token operator">=</span><span class="token number">8</span> redirect_stderr<span class="token operator">=</span><span class="token boolean constant">true</span> stdout_logfile<span class="token operator">=</span><span class="token operator">/</span>path<span class="token operator">/</span>to<span class="token operator">/</span>your<span class="token operator">/</span>project<span class="token operator">/</span>logs<span class="token operator">/</span>worker<span class="token punctuation">.</span>log |
- [program: tên-bất-kì]: tên program. Mọi người có thể đặt tên bất kỳ gì.
- directory: đường dẫn tới program cần run.
- command: program muốn run.
- autostart: quy định tiến trình có tự chạy ngay khi Supervisor được khởi động hay ko. Thường thì Supervisor được chạy khi boot, nên việc quy định tiến trình có tự chạy hay không sẽ phụ thuộc vào boot.
- autorestart: quy định tiến trình có tự khởi động ngay sau khi nó bị tắt vì lý do nào đó (đã chạy xong, bị lỗi, bị timeout…) hay ko.
- user: user dùng để thực thi tiến trình.
- numprocs: số lượng tiến trình mà Supervisor sẽ chạy. Ví dụ để gửi mail, ta để numprocs=4, nghĩa là 4 tiến trình cùng chạy task gửi mail.
- redirect_stderr: nếu là true thì stderr sẽ bị redirect để xuất vào file chỉ định ở stdout_logfile
- stdout_logfile: đường dẫn tới file log của mình. File này ko cần tạo trước vì supervisor sẽ tự tạo cho mình
Sau khi cấu hình xong ta chạy lệnh sau để restart lại supervisor
|
1 2 3 4 |
systemctl restart supervisord # or sudo service supervisor restart |
Note: Mỗi khi thay đổi các thông tin cấu hình Supervisor, mọi người cần phải khởi động lại Supervisor nhé.
4. Thực thi Supervisor để chạy Laravel Queue
- Tạo file laravel-worker.conf trong thư mục /etc/supervisor/conf.d và sửa file
|
1 2 3 4 5 6 7 8 9 10 11 12 |
<span class="token punctuation">[</span>program<span class="token punctuation">:</span>laravel<span class="token operator">-</span>worker<span class="token punctuation">]</span> <span class="token shell-comment comment"># mình thường để trùng với tên file cho dễ nhớ :)</span> process_name<span class="token operator">=</span><span class="token operator">%</span><span class="token punctuation">(</span>program_name<span class="token punctuation">)</span>s_<span class="token operator">%</span><span class="token punctuation">(</span>process_num<span class="token punctuation">)</span><span class="token number">02</span>d directory<span class="token operator">=</span><span class="token operator">/</span><span class="token keyword">var</span><span class="token operator">/</span>www<span class="token operator">/</span>laravel <span class="token shell-comment comment"># mọi người tự thay cho phù hợp nhé</span> command<span class="token operator">=</span>php artisan queue<span class="token punctuation">:</span>work <span class="token operator">--</span>sleep<span class="token operator">=</span><span class="token number">1</span> <span class="token operator">--</span>tries<span class="token operator">=</span><span class="token number">1</span> autostart<span class="token operator">=</span><span class="token boolean constant">true</span> autorestart<span class="token operator">=</span><span class="token boolean constant">true</span> user<span class="token operator">=</span>root <span class="token shell-comment comment"># user thực hiện command</span> numprocs<span class="token operator">=</span><span class="token number">2</span> redirect_stderr<span class="token operator">=</span><span class="token boolean constant">true</span> <span class="token shell-comment comment"># Nếu có lỗi sẽ được log vào file này</span> stdout_logfile<span class="token operator">=</span><span class="token operator">/</span><span class="token keyword">var</span><span class="token operator">/</span>www<span class="token operator">/</span>laravel<span class="token operator">/</span>storage<span class="token operator">/</span>logs<span class="token operator">/</span>worker<span class="token punctuation">.</span>log |
- Khởi động queue
|
1 2 3 4 |
sudo supervisorctl reread sudo supervisorctl update sudo supervisorctl start laravel-worker:* |
5. Một số command thường dùng
| Command | Detail |
|---|---|
| sudo service supervisor restart | Khởi động lại toàn bộ supervisor |
| sudo supervisorctl start laravel-worker:* | Khởi động worker laravel-worker:* |
| sudo supervisorctl stop laravel-worker:* | Dừng worker laravel-worker:* |
| sudo supervisorctl restart laravel-worker:* | Khởi động lại worker laravel-worker:* |
Kết luận
Như vậy với supervisor thì việc quản lý và chạy Laravel Queue đã sẽ trở dễ dàng hơn, chúng ta cũng ít phải bận tâm tới tiến trình của nó đang chạy ra sao, trừ khi có lỗi thì mới phải vào check log thui
Hi vọng bài viết giúp ích được cho mọi người.
Thanks for reading
Tài liệu tham khảo http://supervisord.org/index.html
https://phambinh.net/bai-viet/cau-hinh-laravel-queue-tren-moi-truong-production/