A custom Deployment Configuration for a Lambda Deployment Group.

Bind the predefined deployment config to the environment of the given resource.

bindEnvironment

CustomLambdaDeploymentConfig

The interval, in number of minutes: - For LINEAR, how frequently additional traffic is shifted - For CANARY, how long to shift traffic before the full deployment.

interval

The integer percentage of traffic to shift: - For LINEAR, the percentage to shift every interval - For CANARY, the percentage to shift until the interval passes, before the full deployment.

percentage

The type of deployment config, either CANARY or LINEAR.

type

The verbatim name of the deployment config.

Must be unique per account/region.
Other parameters cannot be updated if this name is provided.

deploymentConfigName

A CodeDeploy Application that deploys to an Amazon ECS service.

EcsApplication

The physical, human-readable name of the CodeDeploy Application.

applicationName

A custom Deployment Configuration for an ECS Deployment Group.

EcsDeploymentConfig

The configuration that specifies how traffic is shifted from the 'blue' target group to the 'green' target group during a deployment.

trafficRouting

The physical, human-readable name of the Deployment Configuration.

A CodeDeploy deployment group that orchestrates ECS blue-green deployments.

Associates an additional alarm with this Deployment Group.

addAlarm

EcsDeploymentGroup

The configuration options for blue-green ECS deployments.

blueGreenDeploymentConfig

The ECS service to deploy with this Deployment Group.

service

The CloudWatch alarms associated with this Deployment Group.

CodeDeploy will stop (and optionally roll back)
a deployment if during it any of the alarms trigger.

Alarms can also be added after the Deployment Group is created using the `#addAlarm` method.

alarms

The reference to the CodeDeploy ECS Application that this Deployment Group belongs to.

application

The auto-rollback configuration for this Deployment Group.

autoRollback

The Deployment Configuration this Deployment Group uses.

deploymentConfig

The physical, human-readable name of the CodeDeploy Deployment Group.

deploymentGroupName

Whether to skip the step of checking CloudWatch alarms during the deployment process.

ignoreAlarmConfiguration

Whether to continue a deployment even if fetching the alarm status from CloudWatch failed.

ignorePollAlarmsFailure

The service Role of this Deployment Group.

role

A CodeDeploy Application that deploys to an AWS Lambda function.

LambdaApplication

LambdaDeploymentConfig

Associate a function to run after deployment completes.

addPostHook

Associate a function to run before deployment begins.

addPreHook

Grant a principal permission to codedeploy:PutLifecycleEventHookExecutionStatus on this deployment group resource.

[disable-awslint:no-grants]

grantPutLifecycleEventHookExecutionStatus

LambdaDeploymentGroup

Lambda Alias to shift traffic. Updating the version of the alias will trigger a CodeDeploy deployment.

[disable-awslint:ref-via-interface] since we need to modify the alias CFN resource update policy

alias

The reference to the CodeDeploy Lambda Application that this Deployment Group belongs to.

The Lambda function to run after traffic routing starts.

postHook

The Lambda function to run before traffic routing starts.

preHook

A CodeDeploy Application that deploys to EC2/on-premise instances.

ServerApplication

A custom Deployment Configuration for an EC2/on-premise Deployment Group.

ServerDeploymentConfig

minimumHealthyHosts

Configure CodeDeploy to deploy your application to one Availability Zone at a time within an AWS Region.

zonalConfig

A CodeDeploy Deployment Group that deploys to EC2/on-premise instances.

Adds an additional auto-scaling group to this Deployment Group.

addAutoScalingGroup

ServerDeploymentGroup

The CodeDeploy EC2/on-premise Application this Deployment Group belongs to.

The auto-scaling groups belonging to this Deployment Group.

Auto-scaling groups can also be added after the Deployment Group is created
using the `#addAutoScalingGroup` method.

[disable-awslint:ref-via-interface] is needed because we update userdata
for ASGs to install the codedeploy agent.

autoScalingGroups

The EC2/on-premise Deployment Configuration to use for this Deployment Group.

All EC2 instances matching the given set of tags when a deployment occurs will be added to this Deployment Group.

ec2InstanceTags

If you've provided any auto-scaling groups with the `#autoScalingGroups` property, you can set this property to add User Data that installs the CodeDeploy agent on the instances.

installAgent

The load balancer to place in front of this Deployment Group.

Can be created from either a classic Elastic Load Balancer,
or an Application Load Balancer / Network Load Balancer Target Group.

loadBalancer

CodeDeploy supports the deployment to multiple load balancers.

Specify either multiple Classic Load Balancers, or
Application Load Balancers / Network Load Balancers Target Groups.

loadBalancers

All on-premise instances matching the given set of tags when a deployment occurs will be added to this Deployment Group.

onPremiseInstanceTags

Indicates whether the deployment group was configured to have CodeDeploy install a termination hook into an Auto Scaling group.

terminationHook

The `AWS::CodeDeploy::Application` resource creates an AWS CodeDeploy application.

In CodeDeploy , an application is a name that functions as a container to ensure that the correct combination of revision, deployment configuration, and deployment group are referenced during a deployment. You can use the `AWS::CodeDeploy::DeploymentGroup` resource to associate the application with a CodeDeploy deployment group. For more information, see [CodeDeploy Deployments](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-steps.html) in the *AWS CodeDeploy User Guide* .

CfnApplication

A name for the application.

If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the application name. For more information, see [Name Type](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html) .

> Updates to `ApplicationName` are not supported.

The compute platform that CodeDeploy deploys the application to.

computePlatform

The metadata that you apply to CodeDeploy applications to help you organize and categorize them.

Each tag consists of a key and an optional value, both of which you define.

CfnDeploymentConfig

The destination platform type for the deployment ( `Lambda` , `Server` , or `ECS` ).

A name for the deployment configuration.

If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the deployment configuration name. For more information, see [Name Type](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html) .

> If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.

The minimum number of healthy instances that should be available at any time during the deployment.

There are two parameters expected in the input: type and value.

The type parameter takes either of the following values:

- HOST_COUNT: The value parameter represents the minimum number of healthy instances as an absolute value.
- FLEET_PERCENT: The value parameter represents the minimum number of healthy instances as a percentage of the total number of instances in the deployment. If you specify FLEET_PERCENT, at the start of the deployment, AWS CodeDeploy converts the percentage to the equivalent number of instance and rounds up fractional instances.

The value parameter takes an integer.

For example, to set a minimum of 95% healthy instance, specify a type of FLEET_PERCENT and a value of 95.

For more information about instance health, see [CodeDeploy Instance Health](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-health.html) in the AWS CodeDeploy User Guide.

The configuration that specifies how the deployment traffic is routed.

trafficRoutingConfig

Configure the `ZonalConfig` object if you want AWS CodeDeploy to deploy your application to one [Availability Zone](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-availability-zones) at a time, within an AWS Region.

For more information about the zonal configuration feature, see [zonal configuration](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations-create.html#zonal-config) in the *CodeDeploy User Guide* .

The `AWS::CodeDeploy::DeploymentGroup` resource creates an AWS CodeDeploy deployment group that specifies which instances your application revisions are deployed to, along with other deployment options.

For more information, see [CreateDeploymentGroup](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeploymentGroup.html) in the *CodeDeploy API Reference* .

> Amazon ECS blue/green deployments through CodeDeploy do not use the `AWS::CodeDeploy::DeploymentGroup` resource. To perform Amazon ECS blue/green deployments, use the `AWS::CodeDeploy::BlueGreen` hook. See [Perform Amazon ECS blue/green deployments through CodeDeploy using CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html) for more information.

CfnDeploymentGroup

The name of an existing CodeDeploy application to associate this deployment group with.

A service role Amazon Resource Name (ARN) that grants CodeDeploy permission to make calls to AWS services on your behalf.

For more information, see [Create a Service Role for AWS CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/getting-started-create-service-role.html) in the *AWS CodeDeploy User Guide* .

> In some cases, you might need to add a dependency on the service role's policy. For more information, see IAM role policy in [DependsOn Attribute](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-dependson.html) .

serviceRoleArn

Information about the Amazon CloudWatch alarms that are associated with the deployment group.

alarmConfiguration

Information about the automatic rollback configuration that is associated with the deployment group.

If you specify this property, don't specify the `Deployment` property.

autoRollbackConfiguration

A list of associated Auto Scaling groups that CodeDeploy automatically deploys revisions to when new instances are created.

Duplicates are not allowed.

Information about blue/green deployment options for a deployment group.

blueGreenDeploymentConfiguration

The application revision to deploy to this deployment group.

If you specify this property, your target application revision is deployed as soon as the provisioning process is complete. If you specify this property, don't specify the `AutoRollbackConfiguration` property.

deployment

A deployment configuration name or a predefined configuration name.

With predefined configurations, you can deploy application revisions to one instance at a time ( `CodeDeployDefault.OneAtATime` ), half of the instances at a time ( `CodeDeployDefault.HalfAtATime` ), or all the instances at once ( `CodeDeployDefault.AllAtOnce` ). For more information and valid values, see [Working with Deployment Configurations](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html) in the *AWS CodeDeploy User Guide* .

A name for the deployment group.

If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the deployment group name. For more information, see [Name Type](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html) .

> If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.

Attributes that determine the type of deployment to run and whether to route deployment traffic behind a load balancer.

If you specify this property with a blue/green deployment type, don't specify the `AutoScalingGroups` , `LoadBalancerInfo` , or `Deployment` properties.

> For blue/green deployments, CloudFormation supports deployments on Lambda compute platforms only. You can perform Amazon ECS blue/green deployments using `AWS::CodeDeploy::BlueGreen` hook. See [Perform Amazon ECS blue/green deployments through CodeDeploy using CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html) for more information.

deploymentStyle

The Amazon EC2 tags that are already applied to Amazon EC2 instances that you want to include in the deployment group.

CodeDeploy includes all Amazon EC2 instances identified by any of the tags you specify in this deployment group. Duplicates are not allowed.

You can specify `EC2TagFilters` or `Ec2TagSet` , but not both.

ec2TagFilters

Information about groups of tags applied to Amazon EC2 instances.

The deployment group includes only Amazon EC2 instances identified by all the tag groups. Cannot be used in the same call as `ec2TagFilter` .

ec2TagSet

The target Amazon ECS services in the deployment group.

This applies only to deployment groups that use the Amazon ECS compute platform. A target Amazon ECS service is specified as an Amazon ECS cluster and service name pair using the format `<clustername>:<servicename>` .

ecsServices

Information about the load balancer to use in a deployment.

For more information, see [Integrating CodeDeploy with Elastic Load Balancing](https://docs.aws.amazon.com/codedeploy/latest/userguide/integrations-aws-elastic-load-balancing.html) in the *AWS CodeDeploy User Guide* .

loadBalancerInfo

The on-premises instance tags already applied to on-premises instances that you want to include in the deployment group.

CodeDeploy includes all on-premises instances identified by any of the tags you specify in this deployment group. To register on-premises instances with CodeDeploy , see [Working with On-Premises Instances for CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-on-premises.html) in the *AWS CodeDeploy User Guide* . Duplicates are not allowed.

You can specify `OnPremisesInstanceTagFilters` or `OnPremisesInstanceTagSet` , but not both.

onPremisesInstanceTagFilters

Information about groups of tags applied to on-premises instances.

The deployment group includes only on-premises instances identified by all the tag groups.

You can specify `OnPremisesInstanceTagFilters` or `OnPremisesInstanceTagSet` , but not both.

onPremisesTagSet

Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the deployed application revision.

If this option is set to `UPDATE` or is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new Amazon EC2 instances.

If this option is set to `IGNORE` , CodeDeploy does not initiate a deployment to update the new Amazon EC2 instances. This may result in instances having different revisions.

outdatedInstancesStrategy

The metadata that you apply to CodeDeploy deployment groups to help you organize and categorize them.

Each tag consists of a key and an optional value, both of which you define.

Indicates whether the deployment group was configured to have CodeDeploy install a termination hook into an Auto Scaling group.

For more information about the termination hook, see [How Amazon EC2 Auto Scaling works with CodeDeploy](https://docs.aws.amazon.com//codedeploy/latest/userguide/integrations-aws-auto-scaling.html#integrations-aws-auto-scaling-behaviors) in the *AWS CodeDeploy User Guide* .

terminationHookEnabled

Information about triggers associated with the deployment group.

Duplicates are not allowed

AWS CodeDeploy

L2 Constructs10