README

Simple handling of cronjobs in your deployment process using the Cron builder library.

Installation

$ composer require shop25/deployer-cron

Usage

The easiest usage is to include the cron recipe which hooks into default Deployer events:

<?php
// deploy.php

require_once 'recipe/cron.php';

Deployer parameters

The following Deployer parameters are defined:

NOTICE that the default value of cron_variable_resolvers is an empty array, but this lib will always add a ReplacingVariableResolver with the variables described in the section below.

Build context

The default build context is defined in the Deployer parameter cron_context. It adds the stage as context which means you can use the condition key in your cronjob config:

# /etc/cronjobs/jobs.yaml

- schedule: "0 0 * * *"
  command: "%php_bin% %release_path%/bin/console my:dev:command"
  condition: "context.stage === 'dev'"

The above cronjob will only be added to the final cron file if the deployment stage equals dev.

Extra variables available

This library also adds more variables you can use in your cronjob configs:

• %application%: Will output the application name
• %stage%: Will output the stage, i.e. dev, staging, or prod
• %php_bin%: Will output the path to the PHP binary
• %release_path%: Will output the release path on the server

With these variables you can define a cronjob like:

# /etc/cronjobs/jobs.yaml

- schedule: "0 0 * * *"
  command: "%php_bin% %release_path%/bin/console my:command"

And that will translate into the following line in your crontab:

0 0 * * * /usr/bin/php /var/www/your_application/releases/23/bin/console my:command