Information for: DEVELOPERS   PARTNERS   SUPPORT

Disk Storage on Cloud Next

Important

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

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

Note

For disk storage information on Cloud Classic infrastructure, see Disk Storage on Cloud Classic.

To determine if you are on Cloud Next infrastructure, see Cloud Next.

Introduction

Cloud Next 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 Cloud Next consist of storage volumes that allow their contents to persist for days or weeks, sometimes even after maintenance events. However, environments running on the 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.

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

  • Acquia does not 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.
  • 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.
  • Do not 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 Next environment using SSH.

  • To assess disk utilization in your public files directory:

    ncdu /shared/sites/default/files/
    
  • To assess disk utilization in your private files directory:

    $ ncdu /shared/sites/default/files-private
    
  • To assess disk utilization in the legacy files directory:

    $ ncdu /shared/files
    

The directories listed in /shared are symlinked to their respective locations in /var/www/html/docroot. The necessary directories may differ depending on your specific Drupal configuration to account for multisites or other non-standard locations.

Filesystem

Cloud Platform environments on 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 Cloud Platform.
/var/www/html/docroot/files
Persistent/Shared None This is for backward compatibility with Cloud Platform 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 Cloud Platform.
/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