terminal42 deployer recipes

This repository contains recipes to integrate with deployer.

Installing

composer require terminal42/deployer-recipes:dev-master@dev --dev

Usage

Include recipes manually

Include recipes in your deploy.php file:

require 'recipe/contao.php';
require 'recipe/database.php';
require 'recipe/deploy.php';
require 'recipe/encore.php'; // or 'recipe/gulp.php';
require 'recipe/maintenance.php';
require 'recipe/symfony.php';

Bootstrap file

Copy deploy-hosts.yml to your project root and one of the bootstrap files as your deploy.php file:

1. contao4-encore.php – Contao 4 setup with Encore for assets management
2. contao4-gulp.php – Contao 4 setup with Gulp for assets management

Pro Tips

Disable releases

If you would like to disable the releases (e.g. for a dev system) you can do it simply by including the recipe:

require 'recipe/disable-releases.php';

Contao Manager

Although Contao Manager seems to be redundant if the system can be deployed, you may still want to install it e.g. for trakked.io. To do that, simply add the following task to the list:

task('deploy', [
    // …
    'maintenance:enable',
+   'contao:download_manager'
    // …
])->desc('Deploy your project');

Further Reading

• https://deployer.org/docs/
• https://deployer.org/recipes.html
• https://github.com/eikona-media/deployer-recipes

License

Licensed under the MIT license.