deployer/docs/recipe/drupal8.md

How to Deploy Drupal 8

Source

How to deploy a Drupal 8 project with zero downtime?

• First, install the Deployer.
• Second, require recipe/drupal8.php recipe into your deploy.php or deploy.yaml file.
• Third, and now you can have a zero downtime deployment!

Did you know that you can deploy Drupal 8 project with a single command? Just execute dep deploy. Something went wrong? Just run dep rollback to rollback your changes. Also, you can take an advantage of the Deployer's CLI to deploy your project.

Another cool feature of the Deployer is provisioning. Take any server, and run dep provision command. This command will configure webserver, databases, php, ssl certificates, and more. You will get everything you need to run your Drupal 8 application.

Deployer does next steps to deploy Drupal 8:

• Displays info about deployment
• Prepares host for deploy
• Locks deploy
• Prepares release
• Updates code
• Creates symlinks for shared files and dirs
• Makes writable dirs
• Creates symlink to release
• Unlocks deploy
• Cleanup old releases

The drupal8 recipe is based on the common recipe.

Configuration

drupal_site

Source

Set drupal site. Change if you use different site

'default'

shared_dirs

Source

Overrides shared_dirs from recipe/deploy/shared.php.

Drupal 8 shared dirs

[
    'sites/{{drupal_site}}/files',
]

shared_files

Source

Overrides shared_files from recipe/deploy/shared.php.

Drupal 8 shared files

[
    'sites/{{drupal_site}}/settings.php',
    'sites/{{drupal_site}}/services.yml',
]

writable_dirs

Source

Overrides writable_dirs from recipe/deploy/writable.php.

Drupal 8 Writable dirs

[
    'sites/{{drupal_site}}/files',
]

Tasks

deploy

Source

This task is group task which contains next tasks:

• deploy:prepare
• deploy:publish