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

Create an Application for an In-Place Deployment (Console)

To use the AWS CodeDeploy console to create an application for an in-place deployment:

  1. Sign in to the AWS Management Console and open the AWS CodeDeploy console at


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

  2. If the AWS CodeDeploy home page appears, choose Get Started Now.

  3. Choose Create application.

  4. In the Application name box, type a name for the application. (In an AWS account, an AWS CodeDeploy application name can be used only once per region. You can reuse an application name in different regions.)

  5. In the Deployment group name box, type a name that describes the deployment group.


    If you want to use the same settings used in another deployment group (including the deployment group name; tags, Auto Scaling group names, or both; and the deployment configuration), specify those settings on this page. Although this new deployment group and the existing deployment group have the same name, AWS CodeDeploy treats them as separate deployment groups, because they are each associated with separate applications.

  6. Choose In-place deployment.

  7. In the Search by tags table, choose from the following:

    • Amazon EC2 or On-premises instance: In the Key and Value fields, type the values of the key-value pair you used to tag the instances. You can tag up to 10 key-value pairs.

      You can use wildcards in the Value field to identify all instances tagged in certain patterns, such as similar Amazon EC2 instance, cost center, and group names, and so on. For example, if you select Name in the Key field and type GRP-*a in the Value field, AWS CodeDeploy identifies all instances that fit that pattern, such as GRP-1a, GRP-2a, and GRP-XYZ-a.

      The Value field is case-sensitive.

      To remove a key-value pair from the list, choose the remove icon.

    • Auto Scaling group: Choose the name of an Auto Scaling group to deploy your application revision to. When new Amazon EC2 instances are launched as part of an Auto Scaling group, AWS CodeDeploy can deploy your revisions to the new instances automatically. You can add up to 10 Auto Scaling groups to a deployment group.

    As AWS CodeDeploy finds instances that match each specified key-value pair or Auto Scaling group name, it displays the number of matching instances. To see more information about the instances, click the number.

  8. (Optional) In Load balancer, choose the Classic load balancer that will manage traffic to the instances during the deployment processes.

    Each instance will be deregistered from the load balancer to prevent traffic from being routed to it during the deployment, and then re-registered when the deployment completes.

  9. In the Deployment configuration list, choose a deployment configuration to control the rate at which instances are deployed to, such as one at a time or all at once. For more information about deployment configurations, see Working with Deployment Configurations

  10. (Optional) In Advanced, configure any options you want to include in the deployment, such as Amazon SNS notification triggers, Amazon CloudWatch alarms, or automatic rollbacks.

    For information about specifying advanced options in deployment groups, see Configure Advanced Options for a Deployment Group.

  11. In the Service role ARN box, choose an Amazon Resource Name (ARN) for a service role that trusts AWS CodeDeploy with, at minimum, the trust and permissions described in Step 3: Create a Service Role. To get the service role ARN, see Get the Service Role ARN (Console) .

  12. Choose Create application.

The next step is to prepare a revision to deploy to the application and deployment group. For instructions, see Working with Application Revisions.