Building a Drupal site root

Patrick Coffey edited this page Sep 11, 2015 · 9 revisions

The Aquifer CLI includes a build tool, which uses the drupal.make file to construct a Drupal site root in a working directory.

Using aquifer build

This command constructs a Drupal site root in the build directory that is set in aquifer.json.

  • aquifer build

Locking dependencies

By default, Aquifer utilizes drush make lock files to ensure that everyone on your team is building with the same dependencies and versions. After you run aquifer build for the first time, you will notice that a drupal.make.lock file is also generated in your project root. This file will contain fully resolved versions of the contrib projects defined in the drupal.make file and will be the make file that is used for subsequent builds.

aquifer build provides a couple of options to assist you when developing using the lock file:

  • --make or -m: Running aquifer build --make will build off of the drupal.make file even if a drupal.make.lock file already exists. The existing drupal.make.lock file is not modified when using this option. This can be useful for testing module updates or dependency changes on your local environment while ensuring your lock file won't be modified and perhaps accidentally committed.
  • --refresh-lock or -r: Running aquifer build --refresh-lock will build off of the drupal.make file and generate an updated drupal.make.lock file. Use this when you have tested changes made to your drupal.make file and want the lock file to reflect those changes.

Note: You must be using drush version 7 for lock file support to work. If you are using a lesser version and are unable to update drush for some reason or just plain don't like any of this lock file business, you can turn off this behavior by setting "lock" to false in the aquifer.json file.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.