Information for: DEVELOPERS   PARTNERS   SUPPORT

Disk Storage on Acquia Cloud Platform

Important

EOL notice! Drupal 8 reached end-of-life on November 2, 2021. For more information, see Frequently Asked Questions.

Each Cloud Platform application has a set amount of disk storage allocated to it. This page explains how Cloud Platform allocates and uses that storage, and how you can determine how much of that storage is in use by your application.

Introduction

Acquia Cloud Platform includes various storage volumes that have each been allocated for a specific purpose related to content management or service delivery. Some of these volumes are provided with platform default size limitations and may not be counted against your total subscription utilization, while file system and database storage are always counted against subscription entitlements.

For directories without contractually-defined storage capacities, Acquia assigns a default allocation of storage capacity to ensure that normal platform operations can be executed properly, including code deployments and maintenance events. Acquia reserves the right to adjust the nature, size, and content of these volumes as needed, including unscheduled purges of such directories, if such actions are deemed necessary to maintain the performance, stability, security, or long-term supportability of one or more clusters.

Many directories on Acquia Cloud Platform consist of storage volumes that allow their contents to persist for days or weeks, sometimes even after maintenance events. However, environments running on the Acquia Cloud Next technologies have entirely ephemeral storage volumes on all directories, excluding the file system and database, unless otherwise noted. This means that only persistent directories or your codebase should ever be used to store files, content, or settings that need to persist for your application to operate as expected. For more information about disk storage on Cloud Classic environments, see Disk Storage on Classic Cloud Environments.

While working with different directories on Acquia Cloud Platform, ensure the following limitations and best practices:

  • On Cloud Classic environments, directories have a maximum disk limit of 1 TB. Whereas, on Acquia Cloud Next environments, Acquia doesn’t recommend exceeding 2 TB of utilization to ensure backup and restore operations can complete execution in a reasonable time should disaster recovery efforts ever be required.
  • Git repositories must never exceed 1 GB in size.
  • Code in a single branch must not exceed 500 MB to avoid the risk of code deployment failures.
  • Keep Git repositories and associated branches as small as practical to ensure optimal performance during code deployment, site scaling, and diagnostic operations. Avoid including large files or unnecessary media files, such as non-theme images and any video files, prune unnecessary versions from your branch periodically, and tag history to keep your repository small and manageable.
  • For environments running on Acquia Cloud Next, Drupal pods are limited to 5 GB of active ephemeral storage. This is typically used by the platform for code or log management activities and shouldn’t be expected to persist for more than a few minutes. Excess utilization can reduce uptime and site stability and may cause workloads to be evicted, leading to immediate loss of ephemeral storage.
  • For environments running on Acquia Cloud Next technologies, don’t use temporary directories to store the files that are required to persist for more than a few minutes. These directories and the files within them are not shared between executions and at most should only be assumed present within the same PHP request, SSH session, Cloud Hook, or Cron Job during which the directory was populated with data.

Examining your disk storage utilization

You can review your disk storage utilization from the command line by connecting to your Cloud Platform environment using SSH.

  • To assess disk utilization in your public files directory:

    ncdu /var/www/html/docroot/sites/default/files/
    
  • To assess disk utilization in the legacy files directory:

    $ ncdu -sh /var/www/html/docroot/files
    
  • To assess disk utilization in your private files directory:

    $ ncdu -sh /shared/private-files/
    

For more information about examining your file system, see Assessing disk space usage.

Filesystem

Cloud Platform environments on Acquia Cloud Next technologies use different filesystems, as described in the following table:

Directories Type/Scope Drupal Setting Description
/var/www/html/docroot/sites/default/files/ Persistent/Shared

This is where Drupal places public files for Acquia Cloud.
/var/www/html/docroot/files Persistent/Shared None This is for backward compatibility with Acquia Cloud applications created on Drupal 6. Do not place files here.
/shared/private-files/ Persistent/Shared
  • On Drupal 8+: $settings['file_private_path']
  • On Drupal 7: $conf['file_private_path']
This is where Drupal places private files for Acquia Cloud.
/shared/logs Persistent/Shared

This location is used primarily by cron-wrapper.sh for persistent log storage, but can also be utilized by custom log files. Subscribers should prune outdated logs here on a routine basis to avoid them exceeding 1 GB in size.
/tmp Ephemeral/Per Pod
  • On Drupal 8.8+: $config['system.file']['path']['temporary']
  • On Drupal 8.0-8.7: $settings['file_temp_path']
  • On Drupal 7: $conf['file_temp_path']
Drupal and other processes may write temporary files here. This is local to the web infrastructure and is not shared across webs.
All other paths Ephemeral


For more information about disk volumes on environments running on the Cloud Classic infrastructure, see Disk Storage on Cloud Classic Environments.