Importing your codebase

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:

1. Ensure your existing application’s most current Drupal code docroot (the directory containing files and directories including Drupal’s index.php, /includes directory, and /modules directory) is on your local computer.
2. Move any user-uploaded files directories (such as /files, /sites/default/files, or /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.
3. 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.
4. The remote Cloud Platform code repository comes with a default docroot directory containing a placeholder file called index.html. To remove it and commit the change back to your repository, complete the following steps:

   1. Go to the directory for the new local code repository for docroot, and then check out the current default application code repository contents to your computer.

      copy

      cd [LOCAL_REPOSITORY_DIRECTORY]
      git clone [REMOTE_REPOSITORY_URL]
      cd [SITENAME]
      git checkout master
      

      where:

      • [LOCAL_REPOSITORY_DIRECTORY] is the directory for the new local code repository for your application’s docroot.
      • [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.

   2. In the new local code repository for the docroot directory, remove the default website and send the changes to Cloud Platform.

      copy

      git rm -r docroot
      git commit -m "Remove default docroot."
      git push origin master
      

5. From the new local code repository directory, make a copy of your application’s most current docroot directory using the following command:

   copy

   cp -R [CURRENT_DOCROOT] docroot
   

   where [CURRENT_DOCROOT] is the complete path to the local location for the current docroot for your Drupal application.

6. 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.

   1. Click PHP to display the require statement for your database.
   2. Add the previous require statement at the end of the settings.php file in your /sites directory.

   The database require statement causes your application to use a unique database for each Cloud Platform environment, which allows you to use the same settings.php file in each of your Cloud Platform environments.

7. Commit the prepared Drupal docroot (without any /files directories) into your Cloud Platform repository:

   copy

   git add docroot
   git commit -m "Import my docroot."
   git push origin master