Run cron jobs and one-off jobs

​

Before you start

• Code that exits when its work is done. A run that exits with code 0 succeeded; any other exit code means it failed.

​

Create a cron job or a one-off job

1

Start a new app

On Apps, click New service. Pick GitHub or Docker image and choose your code.

2

Choose the type

Under What it is, choose Scheduled task for a cron job, or Runs once for a one-off job.

3

Set the schedule

For a scheduled task, enter the Schedule as a five-field cron expression, in UTC. 0 2 * * * runs every day at 02:00. You can pick another time zone later in Settings.

4

Deploy

Pick a Size, add environment variables if the code needs them, and click Deploy.

​

Start a run now

​

Read the run history

• Its state: pending, running, succeeded, failed or canceled.
• What started it: the schedule, or a manual run.
• When it started, and why it failed for a failed run.

​

Change the schedule, time zone or overlap rule

• Schedule: five fields, minute, hour, day of month, month and day of week. */15 * * * * runs every 15 minutes.
• Timezone: a time zone name such as Europe/London. The default is UTC. Set it here, not inside the schedule.
• Concurrency: what happens when a run is due while the last one is still running.

​

Pause a cron job

​

How runs are billed

​

Do it from your tools

# Start a run now
curl -X POST "https://api.rafftechnologies.com/api/v1/apps/services/$APP_ID/jobs/run" \
  -H "X-API-Key: $RAFF_API_KEY"

# List runs, newest first
curl "https://api.rafftechnologies.com/api/v1/apps/services/$APP_ID/jobs/runs" \
  -H "X-API-Key: $RAFF_API_KEY"

# Cancel a run ($RUN_ID is the run's id from the list)
curl -X POST "https://api.rafftechnologies.com/api/v1/apps/jobs/runs/$RUN_ID/cancel" \
  -H "X-API-Key: $RAFF_API_KEY"

curl -X PATCH "https://api.rafftechnologies.com/api/v1/apps/services/$APP_ID" \
  -H "X-API-Key: $RAFF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cron_schedule": "*/15 * * * *", "cron_timezone": "Europe/London", "cron_concurrency": "forbid"}'

​

Next steps