Send Docs Feedback

Note: Most user interface tasks can be performed in Edge Classic or the New Edge experience. For an overview, getting started topics, and release notes specific to the New Edge experience, see the docs.

Working with Acquia

Apigee uses Acquia, a web site management service, for hosting cloud-based versions of the Developer Services portal in the European Union (EU). Acquia is designed to work with Drupal to let you develop, test, and publish your portal in a secure environment.

Acquia is provided as an alternative to customers that need to host the Developer Portal in the EU only due to EU regulations. Apigee uses Pantheon for hosting in the US. For more information about Pantheon, see Working with Pantheon.

Required reading: Acquia documentation

This document contains an overview of how you use Acquia with your portal. Refer to the Acquia documentation for complete details about working with Acquia.

Accessing the Acquia Cloud interface

After your Acquia Cloud account is set up, you can access your portal via the Acquia Cloud interface at at https://cloud.acquia.com/.

When you first log in, the Applications page is displayed, as shown in the following figure.

The Applications page displays all of the applications that you have access to that are hosted on Acquia Cloud. An application is the software entity that you are managing in the Acquia Cloud, such as your Drupal-based portal site.

The following sections describe how to use the Acquia Cloud interface to manage your portal content.

For more information about the Acquia Cloud interface, see Using the Acquia Cloud interface and Managing applications with Acquia Cloud in the Acquia Cloud documentation.

Managing your environments

Access the Acquia Cloud interface and on the Applications page click Manage associated with your portal site to access its dashboard.

To manage your workflow, three environments are provided for developing, testing, and publishing your portal, as outlined in the following table. Your portal is deployed to each environment, but might be in a different state with a unique code branch or tag, database, and so on. See Deploying code to your portal environments.

Environment Description Default URL
Dev Develop new features and customize your portal. http://{application-name}xxxxxx.devcloud.acquia-sites.com/

Where application-name is the name of your application and xxxxxx is a unique string of characters used to differentiate Dev and Stage.

Stage Test the latest code before pushing it to the production environment. http://{application-name}yyyyyy.devcloud.acquia-sites.com/

Where application-name is the name of your application and yyyyyy is a unique string of characters used to differentiate Dev and Stage.

Prod Publish your portal to production (live). http://{application-name}.devcloud.acquia-sites.com/

Where application-name is the name of your application.

Note: See also Configuring a custom domain.

For more information, see Working with environments in the Acquia Cloud documentation.

Developing your portal

The following sections describe how to develop your portal.

Required reading: Review the following sections in the Acquia Cloud documentation for best practices, considerations, and tips when developing code on Acquia Cloud:

Accessing your code

In order to access your code repository in Git, you need to perform the tasks described in the following sections:

Enabling SSH access to your server

Before you can use Git to manage your Drupal code, you must enable SSH to access your server. For more information, see Enabling SSH access in the Acquia Cloud documentation.

To enable SSH access:

  1. Log in to the Acquia Accounts interface at https://accounts.acquia.com.
  2. Click Credentials.
  3. If prompted, re-enter your password to confirm your identity.
  4. Under SSH keys, click Add SSH key.
  5. Enter the following information:
    Field Description
    Nickname Nickname for the SSH key. The nickname can contain alphanumeric characters and underscores.
    Public key Public key.

    For information about generating an SSH public key, see Generating an SSH public key in the Acquia Cloud documentation.

  6. Click Add key.

Accessing your code repository in Git

The Git repository contains all of your portal site's code. You can add new code or customize existing code to configure your portal. For more information, see Using your code repository in the Acquia Cloud documentation.

Even though the Git repository enables you to access to all of the Drupal and Apigee modules, do not modify the code in those modules. Create your own custom modules and themes inside the sites/all folder and restrict your changes to only those modules. See Adding custom modules and themes. For more best practices, see Developing on Acquia Cloud in the Acquia Cloud documentation.

To access your code repository in the Git repo:

  1. Log in to the Acquia Cloud interface at https://cloud.acquia.com/.
  2. On the Applications page, click Manage to view the details of the portal.
  3. Click Application Info in the navigation bar.

  4. Copy the clone command in the Application Information dialog.
  5. Clone the Git repository to your local environment by executing one of the following Git commands:

    To clone the Git repository and create a new branch:

    > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

    To clone the Git repository from the master branch:

    > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

  6. Repeat these steps when you are ready to stage, commit, and push your changes to the Git repository using the relevant commands shown in the Application window.

    When you commit a branch to your repository, Acquia Cloud updates the environment running that code branch. You can deploy code to your portal environments, as described in the next section.

Deploying code to your portal environments

To deploy, switch, or revert code in a portal environment, move your code between environments, or learn more about the repository structure and recommended workflow, see Working with code in the Acquia Cloud documentation.

When you deploy new code to an environment, you will need to run update.php to make the required database updates, as described in Run update.php in the Acquia Cloud documentation.

Adding custom modules and themes

You can expand the functionality of the portal by adding your own custom modules and themes, as summarized in the following table.

Module/Theme Folder in Git repository More information (Drupal documentation)
Custom modules sites/all/modules/custom Creating custom modules
Custom themes sites/all/themes Theming Drupal 7
Drupal Contributed modules sites/all/modules/contrib Contributed modules
Drupal Contributed themes sites/all/themes Contributed themes

After adding the custom module or theme in the Dev environment, you can deploy it to Stage for testing, and then to the Prod environment for production, as described in Deploying code to your portal environments.

Migrating your custom features

If you add custom code or configurations to the portal, you need to maintain and migrate them from Dev to Stage to Prod environments.

For code in the Git repository, you can use the process described in Deploying code to your portal environments to migrate the code from Dev to Stage to Prod.

If you have created any custom configurations, use one of the following methods to migrate them:

Method Description
Export your configuration to code Many common configurations are "exportable" to code using the Features module. For example, views, panels, image cache, and so on.
Implement hook_update_N() function Drupal manages database and configuration changes by using the hook_update_N() function.

If you have a custom module, you can:

  • Add hook_update_N() functions to your module's .install file to process your changes.
  • Deploy these changes along with your code.
  • Run update.php to migrate the changes in the Stage and Prod environments.

Applying module and theme updates to the portal

The following table summarizes the steps required to apply module and theme updates to the portal.

Module/Theme Description
Drupal core and contributed modules Install updates to Drupal core and contributed modules manually. Download the latest version to your local directory manually or using Drush. Then stage, commit, and push the updates to the Git repository.

To deploy the module updates to a portal environment, see Deploying code to your portal environments.

Apigee Edge module Apigee will communicate and manage updates to this module.
Apigee Responsive theme Apigee will communicate and manage updates to this theme.

Configuring a custom domain

As noted in Managing your environments, the default domain names for the portal environments all end in acquia-sites.com. It is recommended that you provide your own custom domain name that personalizes and better conveys the purpose of your site. For example, a popular alternative is:

https://developers.mycompany.com

To configure a custom domain:

  1. Add your domain to your portal site environment. See Managing domains in the Acquia Cloud documentation.
  2. Set up your custom domain with your DNS provider by pointing your domain name's DNS record entry to the public IP address (not to an acquia-sites.com domain). See Pointing DNS records to your public IP addresses in the Acquia Cloud documentation.

    Note: Do not set the domain name's CNAME entry to an acquia-sites.com domain. Doing so may cause latency issues or down time with your portal site.

Enabling SSL

To enable secure access to your site using HTTPS, you must enable SSL.

To enable SSL:

  1. Obtain an SSL certificate from a Certificate Authority (CA) or SSL certificate vendor. See Enabling SSL.
  2. Upload the SSL certificate on the SSL page in the Acquia Cloud interface. See Managing SSL certificates.

Securing your production environment

When you first create an application, you can freely manage the production environment and propagate changes from the development and staging environments. After you publish your content you may want to lock the production environment to prevent unauthorized or accidental updates to the content. For more information, see Using Production mode to protect your live application in the Acquia Cloud documentation.

To secure your production environment:

  1. Log in to the Acquia Cloud interface at https://cloud.acquia.com/.
  2. On the Applications page, click Manage to view the details of your portal site.
  3. Click Prod to view the production environment details.
  4. Click Production Mode in the navigation bar.
  5. Click Enable to enable production mode.

Optimizing your portal using Acquia Insight

Acquia Insight is a set of tools that enables you to optimize your portal site by monitoring its performance, security, and search engine optimization. For more information, see Acquia Insight.

Backing up your portal

The following tables summarize the options available for backing up your portal components.

Component Backup details More info in Acquia Cloud Docs
Code
  • Code is maintained by a version control system and tagged each time you commit.
  • Sync or revert to a specific tag at any time.
Code backups
Database
  • Daily backups are performed and maintained for three days.
  • Schedule automatic and on-demand backups.
  • Internal disaster snapshots of all data are taken every hour.
Files Perform manual backups or schedule a cron job.
Full application Perform manual backup using Drush.
.
Drupal file system Perform manual backups using one of the following options:
  • Copy your files using an FTP client or command-line tools (rsync and scp).
  • Create a compressed archive using Drush.

Note: The Backup and Migrate module is not supported on Acquia Cloud. For more information, see Backup and Migrate module not supported on Acquia Cloud.

Viewing activity notifications

You can view activity notifications to keep track of significant actions that occur with your portal site, such as code being installed or copied between environments, database updates and backups, server changes, and more. For more information, see Viewing activity notifications in the Acquia Cloud documentation.

To view the list of notifications:

  1. Log in to the Acquia Cloud interface at https://cloud.acquia.com/.
  2. On the Applications page, click Manage to view the details of your portal site.
  3. Click the bell icon in the upper right corner of the navigation bar to view your most recent notifications.

  4. Click the arrow next to a notification to view more information about the activity.

Subscribing to Acquia Cloud updates

The Acquia Status page provides information about the status of Acquia Cloud platform and any service interruptions, emergency maintenance, or security updates that are made to the platform.

To subscribe to Acquia Cloud updates:

  1. Navigate to the Acquia Status page.
  2. Click Subscribe to Updates.
  3. Select the method you want to use to receive updates (email, SMS, and so on).
  4. On the Notifications page, select the products for which you want to receive status updates. For example, Acquia Cloud Enterprise.
  5. Click Update Preferences.

 

Help or comments?