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

Document History

The following table describes the major changes made to this user guide to support new and enhanced functionality since the last release of the AWS CodeDeploy User Guide.

  • API version: 2014-10-06

  • Latest documentation update: January 25, 2017

Change Description Date Changed
New and updated topics

Several new topics have been introduced to reflect new AWS CodeDeploy support for blue/green deployments, a deployment method in which the instances in a deployment group (the original environment) are replaced by a different set of instances (the replacement environment). Overview of a Blue/Green Deployment provides a high-level explanation of the blue/green methodology used by AWS CodeDeploy. Try a Sample Blue/Green Deployment in AWS CodeDeploy provides a guide for using the new Sample deployment wizard for blue/green deployments. Additional new topics include Create an Application for a Blue/Green Deployment (Console). Create a Deployment Group for a Blue/Green Deployment (Console), and Set Up a Classic Load Balancer in Elastic Load Balancing for Blue/Green Deployments.

Numerous topics have been updated as well, including Create a Deployment, Working with Deployment Configurations, Create an Application, Working with Deployment Groups , Working with Deployments, and AppSpec 'hooks' Section.

January 25, 2017
New and updated topics A new topic, Use the register-on-premises-instance Command (IAM Session ARN) to Register an On-Premises Instance , describes how to authenticate and register on-premises instances using periodically refreshed temporary credentials generated through AWS Security Token Service. This approach provides better support for supporting large fleets of on-premises instances than using only a static IAM user's credentials on each instance. Working with On-Premises Instances has also been updated to reflect this new support. December 28, 2016
Updated topics AWS CodeDeploy is now available in the EU (London) Region (eu-west-2). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of this new region. December 13, 2016
Updated topics AWS CodeDeploy is now available in the Canada (Central) Region (ca-central-1). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of this new region. December 8, 2016
Updated topics AWS CodeDeploy is now available in the US East (Ohio) Region (us-east-2). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of this new region. October 17, 2016
New topics A new section, Authentication and Access Control for AWS CodeDeploy, provides comprehensive information about using AWS Identity and Access Management (IAM) and AWS CodeDeploy to help secure access to your resources through the use of credentials. These credentials provide the permissions required to access AWS resources, such as retrieving application revisions from Amazon S3 buckets and reading the tags on Amazon EC2 instances. October 11, 2016
Updated topic

Update the AWS CodeDeploy Agent on Windows Server has been updated to reflect the availability of the new AWS CodeDeploy agent updater for Windows Server. When installed on a Windows Server instance, the updater will check periodically for new versions. When a new version is detected, the updater will uninstall the current version of the agent, if one is installed, before installing the newest version.

October 4, 2016
Updated topics

AWS CodeDeploy now integrates with Amazon CloudWatch alarms, making it possible to stop a deployment if there is a change in the state of a specified alarm for a number of consecutive periods, as specified in the alarm threshold.

AWS CodeDeploy also now supports automatically rolling back a deployment if certain conditions are met, such as a deployment failure or an activated alarm.

A number of topics have been updated to reflect these changes, including Create an Application, Create a Deployment Group, Change Deployment Group Settings, Deployments, Redeploy and Roll Back a Deployment, and Product and Service Integrations with AWS CodeDeploy, along with a new topic, Monitoring Deployments with CloudWatch Alarms in AWS CodeDeploy.

September 15, 2016
New and updated topics

AWS CodeDeploy now provides integration with Amazon CloudWatch Events. You can now use CloudWatch Events to initiate one or more actions when changes are detected in the state of a deployment or the state of an instance that belongs to an AWS CodeDeploy deployment group. You can incorporate actions that invoke AWS Lambda functions; that publish to Amazon Kinesis streams or Amazon SNS topics; that push messages to Amazon SQS queues; or that, in turn, trigger CloudWatch alarm actions. For more information, see Monitoring Deployments with Amazon CloudWatch Events.

September 9, 2016
Topic updates The topics Integrating AWS CodeDeploy with Elastic Load Balancing and Integration with Other AWS Services have been updated to reflect an additional load balancing option. AWS CodeDeploy now supports the Classic load balancer and Application load balancer available in Elastic Load Balancing. August 11, 2016
Topic updates AWS CodeDeploy is now available in the Asia Pacific (Mumbai) Region (ap-south-1). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of this new region. June 27, 2016
Topic updates

AWS CodeDeploy is now available in the Asia Pacific (Seoul) Region (ap-northeast-2). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of this new region.

The table of contents has been reorganized to include sections for instances, deployment configurations, applications, deployment groups, revisions, and deployments. A new section has been added for AWS CodeDeploy tutorials. For better usability, several long topics, including AppSpec File Reference and Troubleshooting, have been divided into shorter topics. Configuration information for the AWS CodeDeploy agent has been moved to a new topic, Agent Configuration Reference.

June 15, 2016
New and updated topics

Error Codes for AWS CodeDeploy provides information about some of the error messages that might be displayed when AWS CodeDeploy deployments fail.

The following sections in Troubleshooting were updated to better assist with resolving deployment problems:
April 20, 2016
Topic updates

AWS CodeDeploy is now available in the South America (São Paulo) Region (sa-east-1). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of this new region.

Working with the AWS CodeDeploy Agent was updated to reflect the new :max_revisions: configuration option, which you use to specify the number of application revisions for a deployment group that you want the AWS CodeDeploy agent to archive.

March 10, 2016
New and updated topics

AWS CodeDeploy now supports adding triggers to a deployment group to receive notifications about events related to deployments or instances in that deployment group. These notifications are sent to recipients who are subscribed to an Amazon Simple Notification Service topic you have made part of the trigger's action. You can also use JSON data that is created when a trigger is fired in your own customized notification workflow. For more information, see Monitoring Deployments with Amazon SNS Event Notifications.

Procedures were updated to reflect the redesign of the Application details page.

The Deployments do not fail for up to an hour when an instance is terminated during a deployment section in Troubleshooting has been updated.

Limits was updated to reflect revised limits for the number of deployment groups that can be associated with a single application; the allowed values for minimum healthy instances settings; and required versions of the AWS SDK for Ruby (aws-sdk-core).

February 17, 2016
New and updated topics

AWS CodeDeploy is now available in the US West (N. California) region (us-west-1). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the addition of this new region.

Choose a Repository Type lists and describes the repository types now supported by AWS CodeDeploy. This new topic will be updated as support for other repository types is introduced.

Managing AWS CodeDeploy Agent Operations was updated with information about the new .version file added to instances to report the current version of the AWS CodeDeploy agent, as well as information about supported versions of the agent.

Syntax highlighting for code samples, including JSON and YAML examples, has been added to the user guide.

Add an AppSpec File has been reorganized as step-by-step instructions.

January 20, 2016
New topic Deploy an Application in a Different AWS Account describes the setup requirements and process for initiating deployments that belong to another of your organization’s accounts, without needing a full set of credentials for that other account. This is most useful for organizations that use multiple accounts for different purposes, such as one associated with development and test environments and another associated with the production environment. December 30, 2015
Topic update The Product and Service Integrations with AWS CodeDeploy topic has been redesigned. It now includes a section for integration examples from the community, with lists of blog posts and video examples related to AWS CodeDeploy integrations. December 16, 2015
Topic updates AWS CodeDeploy is now available in the Asia Pacific (Singapore) Region (ap-southeast-1). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of this new region. December 9, 2015
Topic updates

Working with the AWS CodeDeploy Agent was updated to reflect the new :proxy_uri: option in the AWS CodeDeploy agent configuration file.

AppSpec File Reference was updated with information about using a new environment variable, DEPLOYMENT_GROUP_ID, which hook scripts can access during a deployment lifecycle event.
December 1, 2015
Topic update Step 3: Create a Service Role was updated to reflect a new procedure for creating a service role for AWS CodeDeploy and to incorporate other improvements. November 13, 2015
Topic updates AWS CodeDeploy is now available in the EU (Frankfurt) Region (eu-central-1). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of this new region.

The Troubleshooting topic was updated with information about ensuring that time settings on instances are accurate.

October 19, 2015
New topics AWS CloudFormation Template Reference was published to reflect new AWS CloudFormation support for AWS CodeDeploy actions.

Created a Primary Resources topic and introduced definition of a target revision.

October 1, 2015
Topic updates Create a Deployment Group was updated to reflect the ability to locate instances for a deployment group using wildcard searches.

Instance Health was updated to clarify the concept of minimum healthy instances.

August 31, 2015
Topic updates AWS CodeDeploy is now available in the Asia Pacific (Tokyo) Region (ap-northeast-1). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of this new region. August 19, 2015
Topic updates

AWS CodeDeploy now supports deployments to Red Hat Enterprise Linux (RHEL) on-premises instances and Amazon EC2 instances. For more information, see the following topics:

June 23, 2015
Topic update

AWS CodeDeploy now provides a set of environment variables your deployment scripts can use during deployments. These environment variables include information such as the name of the current AWS CodeDeploy application, deployment group, and deployment lifecycle event, as well as the current AWS CodeDeploy deployment identifier. For more information, see the end of the AppSpec 'hooks' Section section in the AppSpec File Reference.

May 29, 2015
Topic updates

AWS CodeDeploy now provides a set of AWS managed policies in IAM that you can use instead of manually creating the equivalent policies on your own. These include:

  • A policy for enabling an IAM user to register revisions with AWS CodeDeploy only and then deploy them through AWS CodeDeploy.

  • A policy for providing an IAM user with full access to AWS CodeDeploy resources.

  • A policy for providing an IAM user with read-only access to AWS CodeDeploy resources.

  • A policy to attach to a service role so that AWS CodeDeploy can identify Amazon EC2 instances by their Amazon EC2 tags, on-premises instance tags, or Auto Scaling group names and deploy application revisions to them accordingly.

For more information, see the Customer Managed Policy Examples section in Authentication and Access Control for AWS CodeDeploy.

May 29, 2015
Topic updates AWS CodeDeploy is now available in the EU (Ireland) Region (eu-west-1) and the Asia Pacific (Sydney) Region (ap-southeast-2). Several topics, including those containing instructions for setting up the AWS CodeDeploy agent, were updated to reflect the availability of these new regions. May 7, 2015
New topics

AWS CodeDeploy now supports deployments to on-premises instance and Amazon EC2 instances. The following topics were added to describe this new support:

April 2, 2015
New topic

AWS CodeDeploy Resources was added.

April 2, 2015
Topic update

Troubleshooting was updated:

April 2, 2015
Topic updates

The following topics were updated to reflect new recommendations for creating your own custom policies and then attaching them to users and roles in IAM:

Two sections were added to Troubleshooting:

The AppSpec 'hooks' Section section in the AppSpec File Reference was updated to more accurately describe the available deployment lifecycle events.

February 12, 2015
Topic updates

A new section was added to Troubleshooting: Amazon EC2 instances in an Auto Scaling group fail to launch and receive the error "Heartbeat Timeout".

A CloudBees section was added to Product and Service Integrations with AWS CodeDeploy.

January 28, 2015
Topic updates

The following sections were added to Troubleshooting:

Information was added to the Step 5: Try the Sample Deployment Wizard to clarify that certain permissions are required for the calling IAM user, specifically:

For information about the required permissions, see Prerequisites.

January 20, 2015
New topics

The Product and Service Integrations with AWS CodeDeploy section was updated to include the following topics

January 9, 2015
Topic updates
January 8, 2015
New topic Monitoring Deployments with AWS CloudTrail was added. AWS CodeDeploy is integrated with AWS CloudTrail, a service that captures API calls made by or on behalf of AWS CodeDeploy in your AWS account and delivers the log files to an Amazon S3 bucket that you specify. December 17, 2014
Topic update The Step 3: Configure instances section in Step 5: Try the Sample Deployment Wizard was updated. December 3, 2014

Initial public release

This is the initial public release of the AWS CodeDeploy User Guide.

November 12, 2014