Role Detail


Deploy or install Drupal on your servers.
Type Ansible
Minimum Ansible Version 2.0
Installation $ ansible-galaxy install geerlingguy.drupal
Last Commit 2017-08-19 03:51:03 AM UTC
Last Imported 2017-08-30 18:01:06 PM UTC
Version History
Version Release Date
2.4.0 2017-08-19 03:51:03 AM
2.3.1 2017-08-08 13:49:01 PM
2.3.0 2017-07-27 03:36:03 AM
2.2.2 2017-06-03 22:59:10 PM
2.2.1 2017-04-21 15:22:03 PM
2.2.0 2017-04-20 21:13:09 PM
2.1.1 2017-03-27 20:11:08 PM
2.1.0 2017-03-24 19:31:07 PM
2.0.4 2017-03-12 05:23:05 AM
2.0.3 2017-03-12 04:10:04 AM
2.0.2 2017-03-11 22:36:10 PM
2.0.0 2017-03-02 15:16:03 PM
2.0.1 2017-03-02 15:16:03 PM
1.1.0 2016-08-30 02:27:02 AM
1.0.9 2016-02-27 00:22:12 AM
1.0.8 2015-09-26 16:11:04 PM
1.0.7 2014-10-22 15:59:03 PM
1.0.6 2014-10-02 04:00:04 AM
1.0.5 2014-07-30 01:47:01 AM
1.0.4 2014-06-11 17:14:05 PM
1.0.3 2014-05-29 14:10:02 PM
1.0.2 2014-05-23 19:16:07 PM
1.0.1 2014-05-23 04:34:04 AM
1.0.0 2014-05-23 04:14:04 AM
Supported Platforms
Platform Version
Debian etch
Debian jessie
Debian lenny
Debian sid
Debian squeeze
Debian stretch
Debian wheezy
EL 5
EL 6
EL 7
Ubuntu artful
Ubuntu lucid
Ubuntu maverick
Ubuntu natty
Ubuntu oneiric
Ubuntu precise
Ubuntu quantal
Ubuntu raring
Ubuntu saucy
Ubuntu trusty
Ubuntu utopic
Ubuntu vivid
Ubuntu wily
Ubuntu xenial
Ubuntu yakkety
Ubuntu zesty
Last 10 Imports
Completed Status
2017-08-30 18:01:06 PM UTC SUCCESS
2017-08-25 04:55:04 AM UTC SUCCESS
2017-08-21 19:21:07 PM UTC SUCCESS
2017-08-19 04:18:04 AM UTC SUCCESS
2017-08-19 04:05:04 AM UTC SUCCESS
2017-08-19 04:03:04 AM UTC SUCCESS
2017-08-13 19:12:07 PM UTC SUCCESS
2017-08-08 14:23:02 PM UTC SUCCESS
2017-08-08 14:12:02 PM UTC SUCCESS
2017-08-08 14:03:02 PM UTC SUCCESS

Ansible Role: Drupal

Build Status

Builds and installs Drupal, an open source content management platform.


Drupal is a PHP-based application that is meant to run behind a typical LAMP/LEMP/LEPP/etc. stack, so you'll need at least the following:

  • Apache or Nginx (Recommended: geerlingguy.apache or geerlingguy.nginx)
  • MySQL or similar Database server (Recommended: geerlingguy.mysql or geerlingguy.postgresql)
  • PHP (Recommended: geerlingguy.php along with other PHP-related roles like php-mysql).

Drush is not an absolute requirement, but it's handy to have, and also required if you use this role to Install a Drupal site (drupal_install_site: true). You can use geerlingguy.drush to install Drush.

Git is not an absolute requirement, but is required if you're deploying from a Git repository (e.g. drupal_deploy: true). You can use geerlingguy.git to install Git.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

Deploy an existing project with Git

drupal_deploy: false
drupal_deploy_repo: ""
drupal_deploy_version: master
drupal_deploy_update: true
drupal_deploy_dir: "/var/www/drupal"
drupal_deploy_accept_hostkey: no

Set drupal_deploy to true and drupal_build_composer* to false if you would like to deploy Drupal to your server from an existing Git repository. The other options all apply to the Git checkout operation:

  • repo: Git repository address
  • version: can be a branch, tag, or commit hash
  • update: whether the repository should be updated to the latest commit, if version is a branch
  • dir: The directory into which the repository will be checked out
  • accept_hostkey: Whether to automatically accept the Git server's hostkey on the first connection.

You can also control whether a composer install is run after the git clone is finished using the following variable:

drupal_deploy_composer_install: yes

Build a project from a Drush Make file

drupal_build_makefile: false
drush_makefile_path: "/path/to/drupal.make.yml"
drush_make_options: "--no-gitinfofile"

Set this to true and drupal_build_composer* to false if you would like to build a Drupal make file with Drush.

Build a project from a Composer file

drupal_build_composer: false
drupal_composer_path: "/path/to/drupal.composer.json"
drupal_composer_install_dir: "/var/www/drupal"
  - "drupal/devel:1.x-dev"

Set drupal_build_makefile to false and this to true if you are using a Composer-based site deployment strategy.

Create a new project using drupal-project (Composer)

drupal_build_composer_project: true
drupal_composer_project_package: "drupal-composer/drupal-project:8.x-dev"
drupal_composer_project_options: "--prefer-dist --stability dev --no-interaction"

Set this to true and drupal_build_makefile, drupal_build_composer to false if you are using Composer's create-project as a site deployment strategy.

Required Drupal site settings

drupal_core_path: "{{ drupal_deploy_dir }}/web"
drupal_core_owner: "{{ ansible_ssh_user | default(ansible_env.SUDO_USER, true) | default(ansible_env.USER, true) | default(ansible_user_id) }}"
drupal_db_user: drupal
drupal_db_password: drupal
drupal_db_name: drupal
drupal_db_backend: mysql
drupal_db_host: ""

Required Drupal settings. When used in a production or shared environment, you should update at least the drupal_db_password and use a secure password.

Drupal site installation options

drupal_install_site: true

Set this to false if you don't need to install Drupal (using the drupal_* settings below), but instead copy down a database (e.g. using drush sql-sync).

drupal_domain: ""
drupal_site_name: "Drupal"
drupal_install_profile: standard
drupal_site_install_extra_args: []
drupal_enable_modules: []
drupal_account_name: admin
drupal_account_pass: admin

Settings for installing a Drupal site if drupal_install_site is true. If you need to pass additional arguments to the drush site-install command, you can pass them in as a list to the drupal_site_install_extra_args variable.



Example Playbook

See the example playbooks used for Travis CI tests (tests/test.yml and tests/test-deploy.yml) for simple examples. See also: Drupal VM, which uses this role to set up Drupal.

- hosts: webserver
    - vars/main.yml
    - geerlingguy.apache
    - geerlingguy.mysql
    - geerlingguy.php
    - geerlingguy.php-mysql
    - geerlingguy.composer
    - geerlingguy.drush
    - geerlingguy.drupal

Inside vars/main.yml:

drupal_install_site: true
drupal_build_composer_project: true
drupal_composer_install_dir: "/var/www/drupal"
drupal_core_path: "{{ drupal_composer_install_dir }}/web"
drupal_domain: ""



Author Information

This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.