adonis-cron

Easy task scheduling for AdonisJS

Usage no npm install needed!

<script type="module">
  import adonisCron from 'https://cdn.skypack.dev/adonis-cron';
</script>

README

Adonis Scheduler Provider

NPM Version

This library provides an easy way to schedule recurring tasks for AdonisJS v4.

Install

npm install --save adonis-cron

Configure

Register it in start/app.js:

const providers = [
  ...
  'adonis-cron/providers/SchedulerProvider'
]

const aliases = {
  ...
  Scheduler: 'Adonis/Addons/Scheduler'
}

Register the commands:

const aceProviders = [
  ...
  'adonis-cron/providers/CommandsProvider'
]

Usage

Starting the scheduler

Starting an instance of the kue listener is easy with the included ace command. Simply run node ace run:scheduler.

The provider looks for jobs in the app/Tasks directory of your AdonisJS project and will automatically register a handler for any tasks that it finds.

Creating your first task

Jobs are easy to create. Run node ace make:task Example. They expose the following properties:

Name Required Type Static Description
schedule true many true The schedule for which the task should run. More docs.
handle true function false A function that is called for this task.

Thanks

Special thanks to the creator(s) of AdonisJS for creating such a great framework.