Menu
AWS CodeDeploy
User Guide (API Version 2014-10-06)

Change Deployment Group Settings with AWS CodeDeploy

You can use the AWS CodeDeploy console, the AWS CLI, or the AWS CodeDeploy APIs to change the settings of a deployment group.

Caution

Do not use these steps if you want the deployment group to use a not-yet-created custom deployment group. Instead, follow the instructions in Create a Deployment Configuration, and then return to this topic. Do not use these steps if you want the deployment group to use a different, not-yet-created service role. The service role must trust AWS CodeDeploy with, at minimum, the permissions described in Step 3: Create a Service Role. To create and configure a service role with the correct permissions, follow the instructions in Step 3: Create a Service Role, and then return to this topic.

Change Deployment Group Settings (Console)

To use the AWS CodeDeploy console to change deployment group settings:

  1. Sign in to the AWS Management Console and open the AWS CodeDeploy console at https://console.aws.amazon.com/codedeploy.

    Note

    Sign in with the same account or IAM user information you used in Getting Started.

  2. On the AWS CodeDeploy menu, choose Applications.

  3. In the list of applications, choose the application that is associated with the deployment group you want to change.

    Note

    If no entries are displayed, make sure the correct region is selected. On the navigation bar, in the region selector, choose one of one of the regions listed in Region and Endpoints in the AWS General Reference. AWS CodeDeploy supports these regions only.

  4. In the Application details page, in Deployment groups, choose the button next to the deployment group you want to change.

  5. On the Actions menu, choose Edit.

  6. Revise any of the deployment group options you want to change.

    For information about deployment group components, see Create a Deployment Group.

  7. If you want to deploy the last successful revision to the deployment group, select the Deploy changes made to deployment group name box, and then choose Save. When prompted, choose Deploy. AWS CodeDeploy updates the deployment group's information, starts a deployment of the last successful revision to the deployment group based on changes you specified, and displays the Deployments page.

    Note

    The Deploy changes made to deployment group name check box will appear only if there was a last successful deployment to this deployment group.

  8. If you want to update the deployment group's information with your changes, but do not want to deploy any applications to the deployment group at this time, clear the Deploy changes made to deployment group name box, and then choose Save. AWS CodeDeploy will update the deployment group's information, but will not deploy any applications to the deployment group.

Change Deployment Group Settings (CLI)

To use the AWS CLI to change deployment group settings, call the update-deployment-group command, specifying:

  • The application name. To view a list of application names, call the list-applications command.

  • The current deployment group name. To view a list of deployment group names, call the list-deployment-groups command.

  • (Optional) A different deployment group name.

  • (Optional) Replacement tags that uniquely identify the instances to be included in the deployment group.

  • (Optional) A different Amazon Resource Name (ARN) corresponding to a service role that allows AWS CodeDeploy to act on your AWS account's behalf when interacting with other related AWS services. To get the service role ARN, see Get the Service Role ARN (CLI) . For more information about service roles, see Roles Terms and Concepts in IAM User Guide.

  • (Optional) The names of replacement Auto Scaling groups to be added to the deployment group.

  • (Optional) The name of the deployment configuration. To view a list of deployment configurations, see View Deployment Configuration Details. (If not specified, AWS CodeDeploy uses a specific default deployment configuration.)

  • (Optional) Commands to create or update a trigger that publishes to a topic in Amazon Simple Notification Service, so that subscribers to that topic receive notifications about deployment and instance events in this deployment group. For information, see Monitoring Deployments with Amazon SNS Event Notifications.

  • (Optional) Commands to add one or more existing CloudWatch alarms to the deployment group that will be activated if a metric specified in an alarm falls below or exceeds a defined threshold.

  • (Optional) Commands for a deployment to roll back to the last known good revision when a deployment fails or a CloudWatch alarm is activated.