AWS Tools for Microsoft Visual Studio Team Services
User Guide

AWS CodeDeploy Deployment Application Task


Deploys an application to Amazon EC2 instances by using AWS CodeDeploy.


This can be a variety of application content, such as code, web and configuration files, executable files, packages, scripts, and multimedia files.


You can set the following parameters for the task. Required parameters are noted by an asterisk (*). Other parameters are optional.


The default name of the task, AWS CodeDeploy Deployment. You can rename it.

AWS Credentials*

The AWS credentials to use. If needed, choose +, and then add a new AWS connection.

AWS Region*

The AWS Region name to use. For more information, see Regions and Endpoints in the Amazon Web Services General Reference.

Application Name*

The name of the AWS CodeDeploy application.

Deployment Group Name*

The name of the deployment group the revision is deployed to.

Revision Bundle*

The location of the application revision artifacts to deploy. You can supply a filename or folder. If a folder is supplied the task will recursively zip the folder contents into an archive file before uploading the archive to Amazon S3. If a filename is supplied the task uploads it unmodified to Amazon S3. CodeDeploy requires the appspec.yml file describing the application to exist at the root of the specified folder or archive file.

Bucket Name*

The name of the bucket to which the revision bundle is uploaded.

Target Folder

Optional folder (key prefix) for the uploaded revision bundle in the bucket. If not specified the, bundle is uploaded to the root of the bucket.


Optional description for the deployment.

Existing File Behavior

How AWS CodeDeploy should handle files that already exist in a deployment target location but weren't part of the previous successful deployment.


Update Outdated Instances Only

If checked, deploys to only those instances that are not running the latest application revision.

Default: not checked.

Ignore Application Stop Failures

When checked, if the deployment causes the ApplicationStop deployment lifecycle event to an instance to fail, the deployment to that instance is not considered failed at that point. It continues on to the BeforeInstall deployment lifecycle event.

Default: not checked.


Output Variable

The name of the variable that will contain the deployment ID on task completion. You can use the variable $(variableName) to refer to the function result in subsequent tasks.