This page describes manually importing the codebase of an existing Drupal application into Cloud Platform using Git, as part of the process of manually importing the entire application. For information about other methods of importing an application, see Importing an existing application.
To prepare and import your application’s codebase into a Cloud Platform code repository:
Ensure your existing application’s most current Drupal code
docroot (the directory containing
files and directories including Drupal’s
/modules directory) is on your local computer.
Move any user-uploaded files directories (such as
/sites/[SITENAME]/files) out of your
docroot directory. There are separate instructions for importing
your user-uploaded files directories.
You must move the files because Cloud Platform stores files outside of your
docroot to simplify management of your repository, and to guarantee file
availability across redundant web nodes.
Decide where to store your code repository on your local computer. The
local code repository will contain the new
docroot for the application
you’re connecting to a Cloud Platform repository.
The remote Cloud Platform code repository comes with a default
directory containing a placeholder file called
index.html. To remove it
and commit the change back to your repository, complete the following steps:
Go to the directory for the new local code repository for
and then check out the current default application code repository
contents to your computer.
cd [LOCAL_REPOSITORY_DIRECTORY] git clone [REMOTE_REPOSITORY_URL] cd [SITENAME] git checkout master
[LOCAL_REPOSITORY_DIRECTORY] is the directory for the new local
code repository for your application’s
[REMOTE_REPOSITORY_URL] is the URL of the Cloud Platform code
repository. For help finding the Git URL of your application, see
Basic Git commands.
[SITENAME] is the name of your site on Cloud Platform. For more
information about your sitename, see the
Sitename definition page.
In the new local code repository for the
docroot directory, remove
the default website and send the changes to Cloud Platform.
git rm -r docroot git commit -m "Remove default docroot." git push origin master
From the new local code repository directory, make a copy of your
application’s most current
docroot directory using the following
cp -R [CURRENT_DOCROOT] docroot
[CURRENT_DOCROOT] is the complete path to the local location for
docroot for your Drupal application.
After you have imported your code, you should update your Drupal
settings.php file to include required settings for Cloud Platform:
a. Go to the Cloud Platform Databases page.
Click PHP to display the require statement for your database.
Add the previous
require statement at the end of the
file in your
require statement causes your application to use a unique
database for each Cloud Platform environment, which allows you to use the
settings.php file in each of your Cloud Platform environments.
Commit the prepared Drupal
docroot (without any
into your Cloud Platform repository:
git add docroot git commit -m "Import my docroot." git push origin master
After your codebase is ready, import your database and configure its website connection.