Information for: DEVELOPERS   PARTNERS

Creating a Drupal site archive for import

Importing a site archive

After you prepare your application, create a Drupal site archive.

A Drupal site archive is a gzip-compressed .tar file containing the following structure:

  • A single top-level directory containing your application’s Drupal docroot, including the index.php file, the modules and the /includes directory, and sites/*.

    Acquia Cloud imports your application’s user-uploaded files from the [docroot]/sites/*/files directory of the directory containing a settings.php file. For more information about docroots, see Docroot definition.

  • The uncompressed MySQL dump file from your Drupal application in the root of the .tar file. This file can have any name, but must have an .sql extension.

The following sample archive file shows the site archive structure of a Drupal 7 application with the tar -tzf archive.tar.gz command that lists the contents of the .tar file:

tar -tzf archive.tar.gz
./your-database-goes-here.sql
./drupal-7
./drupal-7/index.php
[... other Drupal files ...]
./drupal-7/sites
./drupal-7/sites/cleaninstall.localhost
./drupal-7/sites/cleaninstall.localhost/settings.php
./drupal-7/sites/cleaninstall.localhost/files/
./drupal-7/sites/cleaninstall.localhost/files/myimage.jpg

Creating a site archive file with Drush

  1. Check you have installed Drush version 8 or greater. You can download Drush from GitHub. Installing Composer may also be a prerequisite for installing Drush.

    Acquia Dev Desktop also includes Drush.

  2. Go to the Drupal directory and enter the following command:

    drush archive-dump --destination=../mysite.tar.gz
    

    Drush saves the mysite.tar.gz site archive file to the parent directory of your current Drupal directory. If the command displays error messages, ensure it has the required permissions to save files in that directory.

  3. Copy mysite.tar.gz to your local machine.

Making the site archive file available

To import a site archive file using the Acquia Cloud user interface, the file must be located at a publicly accessible URL. You can use services such as Dropbox or Google Drive, or a web server you control.