Troubleshoot deployment

This topic discusses how to recover if you deployed the Magento application with the incorrect Magento authentication keys. For example, you might have used the keys for another account or you might have used Magento Community Edition (CE) keys instead of Magento Enterprise Edition (EE) keys.

If you used the incorrect keys, deployment fails. To recover, you must clone the project, add the correct keys to auth.json, and push the change to the master branch.

To redeploy with the correct authentication keys:

1. Log in to the machine that has your Magento Commerce (Cloud) SSH keys.

2. Log in to the project:

   magento-cloud login
   

3. Create a branch to update code with the name auth:

   magento-cloud environment:branch auth master

4. Change to the project root directory.

5. Open auth.json in a text editor.

   { “http-basic”: { “repo.magento.com”: { “username”: “", "password": "" } } }

6. Add the correct authentication keys.
7. Save your changes and exit the text editor.

8. Commit and merge your changes.

   git add -A
   git commit -m "<description of change>"
   git push origin master
   

9. Wait for the deployment to complete.

Messages indicate whether deployment was successful. You can confirm a successful deployment by going to one of the Environment routes displayed on your screen.