Tìm hiểu về Azure WebJob (Part 3)

Trong bài viết này, mình sẽ hướng dẫn các bạn cách tạo trigger Webjob, gọi WebJob bằng cách thiết lập CRON expression (trong file settings.job) hoặc sử dụng Azure Schedule.
Đặc điểm của trigger WebJob là chương trình chỉ chạy khi bạn gọi thủ công hoặc từ 1 schedule job nào đó.

CRON expression là gì?

CRON là 1 tiện ích về scheduler dựa trên thời gian trong hệ thống Unix. Bạn dùng CRON để thiết lập thời gian chạy 1 chương trình hoặc script nào đó theo thời gian đã định trước. Ví dụ như bạn muốn tạo report lúc 00:05 AM thì bạn sẽ thiết lập

 0 5 0 1/1 * ? *

Bạn có thể dùng tiện ích CronMaker để tạo ra CRON expression:
http://www.cronmaker.com/
CRON expression có thể khác đi đôi chút tùy theo hệ thống định nghĩa. Nhưng cơ bản gồm các field:
# ┌───────────── minute (0 - 59)
# │ ┌───────────── hour (0 - 23)
# │ │ ┌───────────── day of month (1 - 31)
# │ │ │ ┌───────────── month (1 - 12)
# │ │ │ │ ┌───────────── day of week (0 - 6) (Sunday to Saturday;
# │ │ │ │ │                                       7 is also Sunday on some systems)
# │ │ │ │ │
# │ │ │ │ │
# * * * * *  command to execute
Ví dụ:

• Chạy script 30 phút 1 lần: 0,30 * * * * command
• Chạy script 15 phút 1 lần: 0,15,30,45 * * * * command
• Chạy script vào 3 giờ sáng mỗi ngày: 0 3 * * * command
• Chạy script vào 23:45 (11:45 PM) vào thứ bảy: 45 23 * * 6 command

Bạn có thể tham khảo bảng định nghĩa nhanh về CRON

Entry	Description	Equivalent to
@yearly (or @annually)	Run once a year at midnight of 1 January	0 0 1 1 *
@monthly	Run once a month at midnight of the first day of the month	0 0 1 * *
@weekly	Run once a week at midnight on Sunday morning	0 0 * * 0
@daily	Run once a day at midnight	0 0 * * *
@hourly	Run once an hour at the beginning of the hour	0 * * * *
@reboot	Run at startup	N/A

Sử dụng CRON expresison trong Windows Azure

CRON expression bao gồm 6 fields: {second} {minute} {hour} {day} {month} {day of the week}. Ví dụ:

• Mỗi 15 phút: 0 */15 * * * *
• Mỗi giờ (that is, whenever the count of minutes is 0): 0 0 * * * *
• Mỗi giờ từ 9 AM tới 5 PM: 0 0 9-17 * * *
• Vào 9:30 AM mỗi ngày: 0 30 9 * * *
• Vào 9:30 AM mỗi ngày trong tuần: 0 30 9 * * 1-5

Để sử dụng CRON trong WebJob, bạn định nghĩa file settings.job trong thư mục gốc chứa source code WebJob hoặc khai báo CRON expression khi upload source code WebJob bằng file zip.

{
    "schedule": "0 */15 * * * *"
}

Tạo trigger WebJob từ file settings.job

Để đơn giản, bạn chỉ cần tạo Console Application và xuất câu chào Hello World. Bạn có thể tham khảo bài viết ở https://nhatkyhoctap.blogspot.com/2017/12/tim-hieu-ve-azure-webjob-part-1.html để biết cách tạo 1 console application và publish lên Azure.
Trong console application, bạn thêm file settings.job nằm ở thư mục root của WebJobs. Mở file properties, chọn Copy if newer (or Copy always).
File settings.job có nội dung như sau:

{
  "schedule": "0 * * * * *"
}

Sau đó bạn chọn Publish As Azure WebJob.
Trong popup Add Azure WebJob, bạn chọn Run on Demand

Gọi WebJob từ Azure Scheduler

Để thiết lập WebJob chạy định kỳ, ngoài việc sử dụng CRON expression, bạn có thể trigger WebJob từ Azure Scheduler, Time Trigger, hoặc từ 1 background Task nào đó, ví dụ như HangFire.

• Tạo Console Application Hello World, nhưng không bao gồm file settings.job.
• Publish WebJobs lên, chọn chế độ Trigger. WebJob sẽ không tự chạy trừ khi bạn gọi thủ công.
• Tạo Schedule Job theo các bước sau: Schedule Job Collections -> Add.
• Điền thông tin và tạo Schedule Job.

Tạo Job trong Scheduler Job Collections, cung cấp Name, Pricing Tier, Resource Group etc.

Bạn chọn Pricing tier. Nếu bạn chọn Free, thì tạo được tối đa 5 job và execute được 3600 lần. Khuyết điểm của cách chọn này là bạn không thể dùng Authentication trong request, và chỉ được gọi tối đa 1 lần/giờ.

Action Settings

Bạn điền thông tin về Action, Method, Url, và Authentication Setttings.

Trong cửa sổ Authentication, bạn điền thông tin tài khoản sử dụng WebJob.

Bạn có thể tìm thông tin đăng nhập tại WebJob Properties.

Kiểm tra thông tin bằng PostMan:

Bạn thiết lập chạy 1 lần:

Quan sát kết quả WebJob log:

Như vậy là bạn đã setup thành công để gọi WebJob từ bên ngoài rồi đó.

Tham khảo

https://nishantrana.me/2017/03/21/scheduling-a-web-job-console-application-using-azure-scheduler/
https://docs.microsoft.com/en-us/azure/app-service/web-sites-create-web-jobs#cron-expressions
https://en.wikipedia.org/wiki/Cron

Chúc các bạn thành công

Nhatkyhoctap's blog