Cloud: update migrate files section (#8552)

* Add the correct cli commands for migrating files

* fix problems from test

* Improved rsync remote to remote, added better example to cli

* add remote to remote recommendation

* some fixes for the notes

Author: hguthrie

src/cloud/live/stage-prod-migrate.md

@@ -14,7 +14,7 @@ Previous step
 To migrate your database and static files to Staging and Production:
 
 -  [Deploy code](#code)
--  [Migrate static files](#cloud-live-migrate-static)
+-  [Migrate static files](#migrate-static-files)
 -  [Migrate the database](#cloud-live-migrate-db)
 
 If you encounter errors or need to change project configuration, complete the required updates in your local environment. Then, push the code changes to the Integration environment to deploy and test before pushing to Staging and Production environments.
@@ -27,21 +27,23 @@ You can use the [Project Web Interface](#interface) or [SSH and CLI commands](#s
 
 The Project Web Interface provides features to create, manage, and deploy code in Integration, Staging, and Production environments for Starter and Pro plans.
 
-For Pro projects, deploy the Integration branch you created to Staging and Production:
+{:.procedure}
+For Pro projects, deploy the Integration branch to Staging and Production:
 
 1. [Log in](https://accounts.magento.cloud) to your project.
 1. Select the Integration branch.
 1. Select the **Merge** option to deploy to Staging. Complete all testing.
 1. Select the Staging branch.
 1. Select the **Merge** option to deploy to Production.
 
-For Starter, deploy the development branch you created to Staging and Production:
+{:.procedure}
+For Starter, deploy the development branch you created to Staging and Production (master):
 
 1. [Log in](https://accounts.magento.cloud) to your project.
 1. Select the prepared code branch.
 1. Select the **Merge** option to deploy to Staging. Complete all testing.
 1. Select the Staging branch.
-1. Select the **Merge** option to deploy to Production.
+1. Select the **Merge** option to deploy to Master.
 
 ![Use the merge option to deploy]({{ site.baseurl }}/common/images/cloud/cloud_project-merge.png)
 
@@ -54,7 +56,7 @@ You can use the [Magento Cloud CLI commands]({{ site.baseurl }}/cloud/reference/
 -  [Build and deploy on local]({{ site.baseurl }}/cloud/live/live-sanity-check.html)
 -  [Prepare to deploy to Staging and Production]({{ site.baseurl }}/cloud/live/stage-prod-migrate-prereq.html)
 
-#### Step 1:  Deploy and test the Integration environment:
+#### Step 1:  Deploy and test the Integration environment
 
 1. After logging into the project, check out the Integration environment:
 
@@ -112,7 +114,7 @@ You can use the [Magento Cloud CLI commands]({{ site.baseurl }}/cloud/reference/
 
 1. Complete site testing.
 
-#### Step 3: Deploy to Production:
+#### Step 3: Deploy to Production
 
 1. Check out, synchronize, and create a snapshot of your local Production environment.
 
@@ -124,13 +126,63 @@ You can use the [Magento Cloud CLI commands]({{ site.baseurl }}/cloud/reference/
 
 1. Complete site testing.
 
-## Migrate static files {#cloud-live-migrate-static}
+## Migrate static files
+
+[Static files](https://glossary.magento.com/static-files) are stored in `mounts`. There are two methods for migrating files from a source mount location, such as your local environment, to a destination mount location. Both methods use the `rsync` utility, but we recommend using the `magento-cloud` CLI for moving files between the local and remote environment. And we recommend using the `rsync` method when moving files from a remote source to a different remote location.
+
+### Migrate files using the CLI
+
+You can use the `mount:upload` and `mount:download` CLI commands to migrate files between the local and remote environment. Both commands use the `rsync` utility, but the CLI commands provide options and prompts tailored to the {{site.data.var.ece}} environment. For example, if you use the simple command with no options, the CLI prompts you to select which mount or mounts to upload or download.
+
+```bash
+magento-cloud mount:download
+```
+
+Sample response:
 
-You migrate [static files](https://glossary.magento.com/static-files) from your `pub/media` directory to Staging or Production.
+```terminal
+Enter a number to choose a mount to download from:
+  [0] app/etc
+  [1] pub/static
+  [2] var
+  [3] pub/media
+  [4] All mounts
+ > 3
 
-We recommend using the Linux remote synchronization and file transfer command [`rsync`](https://en.wikipedia.org/wiki/Rsync). The rsync utility uses an algorithm that minimizes the amount of data by moving only the portions of files that have changed. Rsync also supports compression.
+Target directory: ~/pub/media/
 
-Use the following command to migrate files:
+Downloading files from the remote mount pub/media to pub/media
+
+Are you sure you want to continue? [Y/n] Y
+```
+
+{:.procedure}
+To upload files from a local `pub/media/` folder to the remote `pub/media/` folder for the current environment:
+
+```bash
+magento-cloud mount:upload --source /path/to/project/pub/media/ --mount pub/media/
+```
+
+Sample response:
+
+```terminal
+Uploading files from pub/media to the remote mount pub/media
+
+Are you sure you want to continue? [Y/n] Y
+
+  building file list ...   done
+  ./
+  sample-file.jpeg
+
+  sent 8.43K bytes  received 48 bytes  3.39K bytes/sec
+  total size is 154.57K  speedup is 18.23
+```
+
+Use the `--help` option for the `mount:upload` and `mount:download` commands to see more options. For example, there is a `--delete` option to remove extraneous files during the migration.
+
+### Migrate files using rsync
+
+Alternatively, you can use the `rsync` utility to migrate files.
 
 ```bash
 rsync -azvP <source> <destination>
@@ -139,38 +191,35 @@ rsync -azvP <source> <destination>
 This command uses the following options:
 
 -  `a`–archive
--  `z`–compress
+-  `z`–compress files during the migration
 -  `v`–verbose
 -  `P`–partial progress
 
-For additional options, see the [rsync man page](http://linux.die.net/man/1/rsync).
-
-To migrate static files from your local machine, use the `rsync` command to copy the `pub/media` directory from your local Magento server to staging or production:
+See the [rsync man page](http://linux.die.net/man/1/rsync).
 
-```bash
-rsync -azvP local_machine/pub/media/ <[email protected]>:pub/media/
-```
+{:.bs-callout-info}
+To transfer media from remote-to-remote environments directly, you must enable SSH agent forwarding, see [GitHub guidance](https://developer.github.com/v3/guides/using-ssh-agent-forwarding/).
 
 {:.procedure}
 To migrate static files from remote-to-remote environments directly (fast approach):
 
-{:.bs-callout-info}
-To transfer media from remote-to-remote environments directly, you must enable ssh agent forwarding, see [GitHub guidance](https://developer.github.com/v3/guides/using-ssh-agent-forwarding/).
-
-1. [Open an SSH connection]({{ site.baseurl }}/cloud/env/environments-ssh.html#ssh) to the source environment.
+1. Use SSH to log in to the source environment. Do not use the `magento-cloud` CLI. Using the `-A` option is very important because it enables forwarding of the authentication agent connection.
 
-   To find the **SSH access** link in your Project Web Interface, select the environment and click **Access Site**. The syntax for the SSH command is as follows:
+   {:.bs-callout-tip}
+   To find the **SSH access** link in your Project Web Interface, select the environment and click **Access Site**.
 
    ```bash
    ssh -A <[email protected]>
    ```
 
-1. Use the `rsync` command to copy the `pub/media` directory from your current environment to  another remote environment:
+1. Use the `rsync` command to copy the `pub/media` directory from your source environment to a different remote environment.
 
    ```bash
    rsync -azvP pub/media/ <[email protected]>:pub/media/
    ```
 
+1. Log in to the other remote environment to verify the files migrated successfully.
+
 ## Migrate the database {#cloud-live-migrate-db}
 
 {%include cloud/note-db-import-export-warning.md%}