Information for: DEVELOPERS   PARTNERS

Importing an existing application using Drush

This procedure is for Mac and Linux platforms. If your Drupal application is on a Windows platform, you must manually import your application to Cloud Platform.

To import your application to Cloud Platform using Drush, you must create a site archive file, and then import the file to Cloud Platform.

Before you import your application using Drush, review Importing an existing application to familiarize yourself with the other available import approaches.

Creating a site archive file

For information about how to create a site archive file with Drush, see Creating a Drupal site archive for import. Copy mysite.tar.gz to your local computer.

Importing the site archive file with Drush

To import the site archive file with Drush, complete the following steps:

  1. Confirm you’ve enabled SSH access to your Cloud Platform server.

  2. Copy mysite.tar.gz to /mnt/gfs/[site].[env]/import on your Cloud Platform server, using the following scp command:

    scp mysite.tar.gz [SITE].[ENV]@[SERVER]:/mnt/gfs/[SITE].[ENV]/import
    

    where

    • [SITE] is the sitename of your application on Cloud Platform.
    • [ENV] is the Cloud Platform environment (frequently prod, test, or dev).
    • [SERVER] is the full DNS name of the server hosting your website.

    To find your [SITE] and [SERVER] names, sign in to the Cloud Platform user interface and view the Servers page for the environment. For more information on obtaining server information, see Managing Cloud Platform servers.

  3. Using SSH, sign in to your environment on Cloud Platform using the SSH address displayed on the Servers page for the environment.

  4. In this SSH session, use the ah-site-archive-import command to import your application:

    drush @[SITE].[ENV] ah-site-archive-import /mnt/gfs/[SITE].[ENV]/import/mysite.tar.gz
    

    where:

    • [SITE] is the same value from step 2.
    • [ENV] is the environment you’re updating (frequently prod, test, or dev).

After you import your site archive, you can import your files and check out a local copy of the application from your Cloud Platform code repository.