Update Cloud manage disk space (#7216)

* Correct Manage disk space section (#7171)

moving to another branch for continued edits

* Update manage-disk-space.md

* Update manage-disk-space.md

Co-authored-by: Suman <[email protected]>

Author: hguthrie

src/cloud/project/manage-disk-space.md

@@ -7,72 +7,104 @@ functional_areas:
 ---
 You can find the total storage capacity for your Cloud project in your {{site.data.var.ece}} contract and on your [Magento account page](https://accounts.magento.cloud/user). Each project card in your account shows the number of _environments_, the _storage_ capacity in GB, and the number of _users_.
 
-You can check disk space usage in each environment using the _disk free_ command, which reports the amount of disk space used by the file system. You must use SSH to log in to a remote environment.
+## Check Integration environment
+
+You can check disk space usage for your Integration environment using the `magento-cloud` CLI.
+
+**To check approximate disk space usage:**
 
 ```bash
-df -h
+magento-cloud db:size
 ```
 
-The `-h` option displays the report using a human-readable format (KB, MB, or GB).
-
 Sample response:
 
 ```terminal
-Filesystem                     Size  Used Avail Use% Mounted on
-/dev/loop25                    518M  518M     0 100% /
-tmpfs                           12K     0   12K   0% /dev
-fake-sysfs                      30G     0   30G   0% /sys
-tmpfs                           30G     0   30G   0% /sys/fs/cgroup
-tmpfs                          5.0M     0  5.0M   0% /dev/shm
-tmpfs                           50M  324K   50M   1% /run
-tmpfs                          5.0M     0  5.0M   0% /run/lock
-/dev/loop64                    121M  121M     0 100% /app
-/dev/mapper/35xdpijwfe         2.0G  1.9G     0 100% /mnt
-/dev/mapper/platform-mxeox5xy  8.0G  141M  7.9G   2% /tmp
-/dev/mapper/platform-lxc       313G   13G  285G   5% /run/shared
+Checking database service mysql...
+
++----------------+-----------------+--------+
+| Allocated disk | Estimated usage | % used |
++----------------+-----------------+--------+
+| 2.0 GiB        | 193.3 MiB       | ~ 9%   |
++----------------+-----------------+--------+
 ```
 
-You can limit the response by specifying a directory. For example:
+All the mounts share the same disk. You can check disk space usage for mounts using the `magento-cloud` CLI.
+
+**To check approximate disk space usage for mounts:**
 
 ```bash
-df -h var/
+magento-cloud mount:size
 ```
 
 Sample response:
 
 ```terminal
-Filesystem                     Size  Used Avail Use% Mounted on
-/dev/mapper/35xdpijwfe         2.0G  1.9G     0 100% /app/var
+Checking disk usage for all mounts on <project>-<branch>[email protected]...
+
++------------+-----------+---------+-----------+-----------+--------+
+| Mount(s)   | Size(s)   | Disk    | Used      | Available | % Used |
++------------+-----------+---------+-----------+-----------+--------+
+| app/etc    | 184 KiB   | 1.9 GiB | 481.3 MiB | 1.4 GiB   | 24.7%  |
+| pub/media  | 128 KiB   |         |           |           |        |
+| pub/static | 158.2 MiB |         |           |           |        |
+| var        | 316.7 MiB |         |           |           |        |
++------------+-----------+---------+-----------+-----------+--------+
 ```
 
-For the database, you can use the {{ site.data.var.ece }} CLI to check approximate disk space usage:
+## Check dedicated clusters
+
+For Pro Staging and Production environments, you can check disk space usage in each environment using the _disk free_ command, which reports the amount of disk space used by the file system. You must use SSH to log in to a remote environment.
 
 ```bash
-magento-cloud db:size
+df -h
 ```
 
-Sample response:
+The `-h` option displays the report using a human-readable format (KB, MB, or GB).
+
+In the following sample response, the `/data/exports/` mount shows the disk space for media and `/data/mysql/` mount shows disk space for the database:
 
 ```terminal
-Checking database service mysql...
+Filesystem                                    Size  Used Avail Use% Mounted on
+udev                                           16G     0   16G   0% /dev
+tmpfs                                         3.2G  9.1M  3.2G   1% /run
+/dev/xvda1                                     59G  8.9G   48G  16% /
+tmpfs                                          16G   36K   16G   1% /dev/shm
+tmpfs                                         5.0M     0  5.0M   0% /run/lock
+tmpfs                                          16G     0   16G   0% /sys/fs/cgroup
+/dev/xvdj                                     9.8G  2.3G  7.6G  23% /data/mysql
+/dev/xvdi                                     9.8G  491M  9.3G   5% /data/exports
+192.168.5.5:/shared                           9.8G  591M  9.3G   6% /mnt/shared
+/dev/loop0                                     91M   91M     0 100% /app/project
+192.168.5.5:/shared/project/var         9.8G  591M  9.3G   6% /app/project/var
+192.168.5.5:/shared/project/app/etc     9.8G  591M  9.3G   6% /app/project/app/etc
+192.168.5.5:/shared/project/pub/media   9.8G  591M  9.3G   6% /app/project/pub/media
+192.168.5.5:/shared/project/pub/static  9.8G  591M  9.3G   6% /app/project/pub/static
+```
 
-+----------------+-----------------+--------+
-| Allocated disk | Estimated usage | % used |
-+----------------+-----------------+--------+
-| 2.0 GiB        | 193.3 MiB       | ~ 9%   |
-+----------------+-----------------+--------+
+You can limit the response by specifying a directory. For example:
+
+```bash
+df -h var/
+```
+
+Sample response:
+
+```terminal
+Filesystem                                    Size  Used Avail Use% Mounted on
+192.168.5.5:/shared/project/var         9.8G  591M  9.3G   6% /app/project/var
 ```
 
-## Allocating disk space
+## Allocate disk space
 
 Two configuration files control the allocation of disk space in the Cloud environments: the `.magento.app.yaml` file and the `.magento/services.yaml` file. Each file contains the `disk` property, which defines the disk size value in MB for the respective configuration.
 
 {:.bs-callout-info}
-You can change disk space allocation on Pro Integration and Starter enviroments only. You must submit a Magento support ticket to change disk space allocation on Pro Production and Staging environments.
+You can change disk space allocation on Pro Integration and Starter environments only. You must submit a Magento support ticket to change disk space allocation on Pro Production and Staging environments.
 
 ### Application disk space
 
-The `.magento.app.yaml` file controls the [persistent disk space]({{ site.baseurl }}/cloud/project/project-conf-files_magento-app.html#disk) available to the Magento application.
+The `.magento.app.yaml` file controls the [persistent disk space][disk-key] available to the Magento application.
 
 {:.procedure}
 To increase disk space for your application:
@@ -124,7 +156,7 @@ To increase disk space for a service:
 
    The changes take effect after you push the updated YAML file to the remote environment.
 
-## Monitoring disk space
+## Monitor disk space
 
 On Pro Production environments, you can monitor disk space and other performance indicators using Adobe-generated alert policies for New Relic. For details, see [New Relic]({{ site.baseurl }}/cloud/project/new-relic.html).
 
@@ -135,3 +167,7 @@ The build cache can grow over time. If you receive a warning that states `No spa
 ```bash
 magento-cloud project:clear-build-cache
 ```
+
+<!-- link definitions -->
+
+[disk-key]: {{ site.baseurl }}/cloud/project/project-conf-files_magento-app.html#disk