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, andsites/*
.Cloud Platform imports your application’s user-uploaded files from the
[docroot]/sites/*/files
directory of the directory containing asettings.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
- Ensure that you have installed a Drush version that supports the
drush archive:dump
command. Certain Drush versions like Drush 9 do not support this command. For more information, see archive:dump. 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.- Copy
mysite.tar.gz
to your local machine.
Making the site archive file available
To import a site archive file using the Cloud Platform user interface, the file must be located at a publicly accessible URL. You can use services such as Dropbox or Google Drive, or an infrastructure you control.