How do I troubleshoot a failed CodeDeploy deployment on Amazon EC2 instances?

Short description

To troubleshoot the reason your deployment failed, use the AWS Systems Manager AWSSupport-TroubleshootCodeDeploy runbook.

Resolution

Prerequisite: Make sure that your AWS Identity and Access Management (IAM) user or role has the required permissions to use the runbook. For more information, see the Required IAM permissions section of AWSSupport-TroubleshootCodeDeploy.

To run the Systems Manager runbook, complete the following steps:

1. Open the Systems Manager console.
2. In the navigation pane, choose Documents.
3. In the search bar, enter AWSSupport-TroubleshootCodeDeploy.
4. Select the AWSSupport-TroubleshootCodeDeploy document.
5. Choose Execute automation.
6. Choose Execute.
   Note: For a list of the steps that the runbook performs, see Documents steps section of AWSSupport-TroubleshootCodeDeploy.
7. After the automation completes, review the troubleshooting steps and recommendations for how to resolve the issue that caused your deployment failure in the Outputs section.

Related information

Troubleshooting CodeDeploy

Troubleshoot EC2/On-Premises deployment issues