Information for: DEVELOPERS   PARTNERS

Acquia Cloud Site Factory Connector module

The Acquia Cloud Site Factory Connector module (available on Drupal.org) connects your website to the Acquia Cloud Site Factory platform. The modules enables several critical features, including the following:

Installing and enabling the module

For directions regarding installing and enabling the Acquia Cloud Site Factory Connector, select the tab that corresponds to your website’s installed version of Drupal:

Add the module to your codebase by using the blt recipes:acsf:init:all command.

Use the instructions at Installing a Drupal 8 module to install the most recent 8.x version of the Acquia Cloud Site Factory Connector module.

Note

Be sure to install the appropriate version of the module, based on the version of Drush that you are using. For more information, see the Acquia Cloud Site Factory Connector module page on Drupal.org.

Use the instructions at How to install a Drupal 7 module to install the most recent 7.x version of the Acquia Cloud Site Factory Connector module.

Do not install the module in more than one location in your code repository (such as both docroot/profiles/profilename/modules/contrib and docroot/modules/contrib). Multiple instances of the module can prevent Acquia Cloud Site Factory from discovering and using the module.

To determine if your code repository contains more than one version of the module, run the following Git command in the docroot directory:

git ls-files "*acsf.info*"

The Acquia Cloud Site Factory Connector module contains several sub-modules that provide additional functions. When you enable the main Connector module, you also enable most of the included sub-modules; however, some sub-modules must be enabled manually, depending on your website’s needs.

  • acsf_init – Required when preparing a custom Drupal distribution for development and deployment on Acquia Cloud Site Factory.
  • acsf_sj – Required for creating one-time complex data processing jobs to be completed as background processes.
  • acsf_sso – Required for Drupal 8-based websites that use single sign-on with Acquia Cloud Site Factory.

Upgrading the module

Keeping the Acquia Cloud Site Factory Connector module up-to-date in your codebase helps keep your platform secure, and gives you access to new platform features as they are developed.

Acquia publishes release notes for Acquia Cloud Site Factory that include information about new versions of the Acquia Cloud Site Factory connector module, bugfixes, and any necessary upgrade instructions.

Whenever you update the Acquia Cloud Site Factory Connector module to a newer version, be sure to update your codebase to use the module.