Acquia Cloud Actions for Drupal Deployments and Operations

Drupal

Acquia Cloud Actions for Drupal Deployments and Operations

A practical guide to Acquia Cloud actions for Drupal teams: code deploys, database and file copies, backups, Drush commands, Cloud Hooks, automation, and release runbooks.

When Drupal runs on Acquia Cloud Platform, many day-to-day operations are performed as Cloud actions: deploying code, copying databases, copying files, creating backups, running Drush commands, clearing caches, and reviewing task logs. Some teams perform these actions from the Acquia Cloud UI. Others automate them with Cloud Platform API, Acquia CLI, CI/CD pipelines, or Cloud Hooks.

This article explains how to think about Acquia Cloud actions as a release and operations system, not just a collection of buttons. The examples are Drupal-focused: database updates, configuration imports, cache rebuilds, content safety, and rollback planning.

Overview of Acquia Cloud actions for Drupal environments
Cloud actions change environments. Treat them as operational events with inputs, logs, verification, and rollback.

What Are Acquia Cloud Actions?

In practical terms, an Acquia Cloud action is a task that changes or inspects an environment. Examples include:

  • Deploying a branch or tag to an environment.
  • Copying a database from one environment to another.
  • Copying public files between environments.
  • Creating or downloading backups.
  • Running Drush commands.
  • Clearing Varnish or application caches.
  • Running cron or checking scheduled jobs.
  • Reviewing task status and logs.

The exact UI labels can change over time, and available actions can vary by subscription, application type, permissions, and hosting architecture. The important model stays the same: an action starts a task, the task runs against an environment, and the result must be verified.

Environments Matter

A standard Acquia Drupal workflow usually involves multiple environments:

  • Dev: active integration and early QA.
  • Stage: production-like verification.
  • Prod: live traffic and live content.

Actions are not equally safe in every direction. Code usually moves upward toward production. Content data usually moves downward from production to non-production. Mixing those directions casually is how teams overwrite work or leak production data into places it does not belong.

ActionTypical DirectionRisk
Deploy codeDev to Stage to ProdBroken release if not tested
Copy databaseProd to Stage or DevData loss or privacy exposure
Copy filesProd to Stage or DevLarge transfers and sensitive files
Run DrushSpecific target environmentWrong command on wrong environment
Clear cacheAny environmentCold cache and traffic spike

Code Deploy Actions

Code deploy actions move a Git branch, tag, or built artifact to an Acquia environment. For Drupal, code deploy is only the first part of the release. A real release may also require database updates, configuration import, cache rebuilds, queue checks, and smoke tests.

A safe code deploy flow looks like this:

Safe Acquia Cloud release workflow for Drupal
Release quality depends on the sequence: prepare, back up, deploy, run Drupal tasks, verify.
  1. Create a release branch or tag.
  2. Confirm CI passes: coding standards, tests, build, and Composer validation.
  3. Deploy to Stage first.
  4. Run drush updatedb -y if updates exist.
  5. Run drush config:import -y if configuration is deployed from Git.
  6. Run drush cache:rebuild.
  7. Smoke test important pages and workflows.
  8. Deploy the same tag to Production.

Do not deploy a moving branch to production if your team cannot prove which commit is live. Tags make release tracking and rollback much cleaner.

Database Copy Actions

Database copy actions are powerful and dangerous. They are usually used to refresh non-production environments from production so developers and QA can test against realistic content.

Before copying a database, ask:

  • Which environment is the source?
  • Which environment is the destination?
  • Will destination-only test content be lost?
  • Does production data need sanitization?
  • Will search indexes, queues, or external integration settings need reset afterward?

For non-production refreshes, run a sanitization step after the copy when needed. That may include replacing user emails, disabling outbound mail, disabling production API keys, clearing sessions, and resetting integration webhooks.

File Copy Actions

File copy actions move public or private files between environments. They are useful when Stage needs production-like images, PDFs, or uploaded assets.

Watch for these issues:

  • Large file sets can take time.
  • Private files may contain sensitive documents.
  • Image derivatives may need rebuilds.
  • Stage and Dev may not need every production asset.
  • File copies can hide broken media migration logic if they are used as a crutch.

When possible, copy only what the environment needs. For privacy-heavy sites, discuss whether non-production should use sanitized or sample files instead of production files.

Backups And Rollback

Before any production action that changes code, database, files, or configuration, confirm backups. Backups are not a ritual. They are your rollback option.

A production release should document:

  • Last successful database backup.
  • Release tag being deployed.
  • Config import expected changes.
  • Rollback tag or previous known-good tag.
  • Who can approve rollback.
  • How long the team will monitor after release.

Rollback is not always just “deploy the old code.” If the release ran destructive database updates or imported configuration that changed data structures, rollback may require database restore or a forward fix. Write that down before the release starts.

Drush Actions

Drupal teams often need to run Drush against the target environment. Common commands include:

drush status
drush updatedb -y
drush config:status
drush config:import -y
drush cache:rebuild
drush cron
drush watchdog:show --count=50

Good Drush action hygiene:

  • Confirm the environment before running the command.
  • Prefer release scripts over manual command typing.
  • Capture output in logs.
  • Use config:status before config:import when you are unsure.
  • Never run destructive commands from memory on production.

Cloud Hooks

Cloud Hooks let your repository run scripts around Acquia environment events, such as code deploys. They are useful for standardizing Drupal post-deploy tasks.

Acquia Cloud Hooks and Drupal post-deploy task example
Cloud Hooks are strongest when they are small, predictable, and logged clearly.

A typical post-code-deploy script may run:

drush updatedb -y
drush config:import -y
drush cache:rebuild
drush status

Keep hooks boring. They should not contain business logic nobody remembers. If a hook changes production state, it should be reviewed like application code and documented in the release process.

Cloud UI, CLI, API, Or CI/CD?

There are several ways to trigger Acquia actions:

  • Cloud UI: good for manual operations and visibility.
  • Acquia CLI: good for repeatable commands from a terminal or pipeline.
  • Cloud Platform API: good for custom automation and integrations.
  • CI/CD pipeline: best for predictable releases that need approvals, logs, and gates.
  • Cloud Hooks: useful for environment lifecycle automation after a Cloud action runs.

A mature team usually starts with the UI, then moves repetitive production steps into scripts or pipeline jobs. The goal is not automation for its own sake. The goal is fewer surprises.

Production Runbook

Production runbook checklist for Acquia Cloud actions
Every production action needs ownership, verification, and a recovery path.

Use a runbook like this for production releases:

Before

  • Confirm ticket, release owner, and approver.
  • Confirm release tag and commit SHA.
  • Confirm latest database backup.
  • Review expected database updates and configuration changes.
  • Pause risky integrations if needed.
  • Prepare rollback plan.

During

  • Deploy code.
  • Watch Acquia task logs.
  • Run database updates.
  • Import configuration.
  • Rebuild cache.
  • Clear Varnish/CDN cache only as needed.

After

  • Smoke test homepage, login, search, forms, APIs, and key editorial paths.
  • Check Drupal logs and PHP errors.
  • Confirm cron and queues are healthy.
  • Monitor traffic and response times.
  • Announce release result.

Common Mistakes

Copying Production Database To The Wrong Environment

This can overwrite test content, expose private data, or confuse integrations. Always read source and destination out loud before confirming.

Deploying Code Without Drupal Post-Deploy Tasks

New code may require schema updates or configuration import. A code deploy without Drupal deploy steps is only half a release.

Running Cache Rebuild As A Fix-All

Cache rebuild is useful, but it can hide real issues and cause cold-cache load. Use it intentionally, not as a reflex after every symptom.

Letting Hooks Grow Into Mystery Automation

If nobody knows what a Cloud Hook does, it is production risk. Keep hooks small, logged, and reviewed.

No Rollback Decision Point

Teams often know how to deploy but not when to roll back. Decide ahead of time what symptoms trigger rollback or a forward fix.

Suggested Release Script Shape

For Drupal, a simple deployment script or pipeline step should look like this:

set -euo pipefail

drush status
drush updatedb -y
drush config:status
drush config:import -y
drush cache:rebuild
drush cron
drush watchdog:show --count=20

For more advanced teams, add smoke tests, Slack notifications, New Relic markers, queue health checks, and rollback automation.

Reference Links

Final Takeaway

Acquia Cloud actions are not just operational conveniences. They are the control points for Drupal releases and environment management. Treat them with the same discipline you apply to code: review, automate, log, verify, and keep a rollback path.

The safest teams use Acquia Cloud UI for visibility, CLI/API for repeatability, Cloud Hooks for small lifecycle automation, and a runbook for production decision-making. That combination turns cloud actions from button clicks into a reliable release process.

Keep reading

Drupal Sep 7, 2026 6 min read

Build a Drupal Chatbot with Local AI

Learn how a Drupal chatbot finds relevant published articles, uses Ollama to generate answers, and displays source links while keeping inference on your own hardware.