Document history - AWS CodeDeploy

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 CodeDeploy User Guide.

  • API version: 2014-10-06

ChangeDescriptionDate

CodeDeploy agent v1.7.0 release

The AWS CodeDeploy agent was updated to version 1.7.0. For more information, see Version history of the CodeDeploy agent.

March 6, 2024

Changed commands

The sudo service codedeploy-agent status|start|stop commands are no longer recommended because they do not use systemd for CodeDeploy agent process management, which is a best practice. To ensure systemd is used, use systemctl commands, as shown in the following example: sytemctl start codedeploy-agent. The following topics were updated with systemctl commands: Install the CodeDeploy agent for Amazon Linux or RHEL, Install the CodeDeploy agent for Ubuntu Server, Troubleshooting all lifecycle events skipped errors, and Create a new CodeDeploy log file if it was accidentally deleted.

January 12, 2024

Added topics

Added the Managing the CodeDeploy agent process and Referencing files in your lifecycle event scripts topics.

January 12, 2024

CodeDeploy now supports zonal configurations

Updated the Create a deployment configuration with CodeDeploy topic with zonal configuration information.

December 7, 2023

CodeDeploy now supports termination deployments

Added the Enabling termination deployments during Auto Scaling scale-in events topic to described the termination deployment feature. Also updated the AppSpec 'hooks' section for an EC2/On-Premises deployment, Create a deployment group for an in-place deployment (console), and Create a deployment group for an EC2/On-Premises blue/green deployment (console) topics to account for the feature.

December 7, 2023

Fixed JSON formatting

Fixed the formatting of the JSON code samples in the AppSpec 'resources' section (Amazon ECS and AWS Lambda deployments only) topic.

December 3, 2023

Added a troubleshooting topic

Added a Troubleshooting Amazon ECS deployment issues topic.

October 24, 2023

Updated the AppSpec file name

Updated the CodeDeploy AppSpec file reference to indicate that the AppSpec file must be named appspec.yml for EC2/On-Premises deployments.

October 5, 2023

CodeDeploy now supports multiple load balancers

Updated the Create a deployment group for an in-place deployment (console), Create a deployment group for an EC2/On-Premises blue/green deployment (console), and Set up a load balancer in Elastic Load Balancing for CodeDeploy Amazon EC2 deployments topics to indicate support for multiple load balancers.

September 26, 2023

Updated the Regions in the VPC topic

Updated the table in the Use CodeDeploy with Amazon Virtual Private Cloud topic to show additional Region support. Specifically, the Asia Pacific (Hyderabad), Asia Pacific (Melbourne), Europe (Milan), Europe (Spain), and Europe (Zurich) Regions were updated to show support for the agent endpoint.

September 22, 2023

Updated Regions in the resource kit topic

Added the following AWS Regions to the Resource kit bucket names by Region section: Asia Pacific (Osaka), Asia Pacific (Hyderabad), Canada (Central), Europe (Spain), Europe (Zurich), Middle East (UAE). Also updated IAM policies with these Regions and any others that were missing.

September 22, 2023

Shortened agent installation and update topics

Shortened the Install the CodeDeploy agent for Windows Server and Update the CodeDeploy agent on Windows Server topics. Removed redundant Amazon S3 bucket URLs and Amazon S3 copy commands.

September 21, 2023

Added the Asia Pacific (Jakarta) Region

Added Asia Pacific (Jakarta) to Resource kit bucket names by Region.

September 21, 2023

CodeDeploy updated an existing AWS managed policy

The AWSCodeDeployRole managed policy was updated. For more information, see AWS updates to AWS managed policies.

August 16, 2023

Added a limit

Added a limit to the CodeDeploy limits topic. The limit is Maximum number of alarms associated with a deployment group.

August 15, 2023

Fixed a step related to load balancers

Fixed the instructions in Create a deployment group for an EC2/On-Premises blue/green deployment (console). The load balancer step is now marked as optional.

August 3, 2023

Clarified wording in the Amazon ECS topic

Clarified the wording in Tutorial: Deploy an application into Amazon ECS. The wording now indicates you are deploying an application. Previously, the wording indicated you were deploying an Amazon ECS service.

August 3, 2023

CodeDeploy is now available in Israel (Tel Aviv) Region

CodeDeploy is now available in Israel (Tel Aviv) Region (il-central-1). Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new Region.

July 31, 2023

Topic update

Updated the Troubleshoot EC2/On-Premises deployment issues topic with a tip about using a runbook to perform troubleshooting tasks automatically.

July 7, 2023

Topic update

Updated the AppSpec 'resources' section for Amazon ECS deployments topic with more information about the task definition ARN.

July 7, 2023

Topic update

Updated the Step 1: Install and configure the AWS CLI on the on-premises instance topic with troubleshooting information.

July 7, 2023

Topic update

Updated the Cross-service confused deputy prevention topic with information about Amazon ECS blue/green deployments through AWS CloudFormation.

July 6, 2023

Topic update

The Cross-service confused deputy prevention topic was updated with information about Amazon ECS blue/green deployments through AWS CloudFormation.

July 6, 2023

Topic update

Updated the Predefined deployment configurations for an EC2/On-Premises compute platform topic. Added a note about the CodeDeployDefault.HalfAtATime predefined deployment configuration's behavior with Auto Scaling groups.

June 29, 2023

Topic update

Updated the Infrastructure security in AWS CodeDeploy topic to indicate the new minimum and recommended versions of the Transport Layer Security (TLS) protocol.

June 28, 2023

Limit update

The following limit was changed: 'Maximum number of hours an EC2/On-Premises in-place deployment can run'. For more information, see the Limits

June 27, 2023

Topic update

The Step 3: Limit the CodeDeploy user's permissions topic was updated with detailed instructions.

May 31, 2023

CodeDeploy updated an existing AWS managed policy

The AWSCodeDeployFullAccess managed policy was updated. For more information, see AWS updates to AWS managed policies.

May 16, 2023

CodeDeploy agent v1.6.0 release

The AWS CodeDeploy agent was updated to version 1.6.0. For more information, see Version history of the CodeDeploy agent.

March 30, 2023

CodeDeploy agent v1.5.0 release

The AWS CodeDeploy agent was updated to version 1.5.0. For more information, see Version history of the CodeDeploy agent.

March 3, 2023

Amazon ECS compute platform update

Deployments on an Amazon ECS compute platform are now supported in the Asia Pacific (Jakarta) Region.

February 8, 2023

CodeDeploy updated an existing AWS managed policy

The AWSCodeDeployRole managed policy was updated. For more information, see AWS updates to AWS managed policies.

February 3, 2023

Topic update

The Use CodeDeploy with Amazon Virtual Private Cloud topic was updated with new and changed AWS Regions.

February 2, 2023

Topic updates

CodeDeploy is now available in the Asia Pacific (Melbourne) Region (ap-southeast-4). Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of these new regions.

January 26, 2023

Security best practices updates

The Getting started with CodeDeploy section and a few other sections were updated to conform to AWS security best practices.

January 23, 2023

CodeDeploy agent v1.4.1 release

The AWS CodeDeploy agent was updated to version 1.4.1. For more information, see Version history of the CodeDeploy agent.

December 6, 2022

Added a troubleshooting topic

Added a topic on how to troubleshoot errors caused by long file paths used with the CodeDeploy agent for Windows. For more information, see Long file paths cause "No such file or directory" errors.

December 6, 2022

Changed a limit

The following limit was changed: 'Maximum number of custom deployment configurations associated with an AWS account'. The limit is now 200. For more information on limits, see the Limits topic.

September 7, 2022

CodeDeploy agent v1.4.0 release

The AWS CodeDeploy agent was updated to version 1.4.0. For more information, see Version history of the CodeDeploy agent.

August 31, 2022

Fixed a few limits.

The following limits were fixed: 'Maximum number of concurrent deployments associated with an AWS account' is now 1000. 'Maximum number of instances in a single deployment' is now 1000. 'Maximum number of instances that can be used by concurrent deployments that are in progress and associated with one account' is now 1000. 'Maximum number of custom deployment configurations associated with an AWS account' is now 100. For more information on limits, see the Limits topic.

August 8, 2022

Added a table that shows the CodeDeploy endpoints supported in each Region.

For more information, see Use CodeDeploy with Amazon Virtual Private Cloud.

April 20, 2022

Added a new limit for Amazon ECS blue/green deployments.

The maximum number of hours between the deployment of a revision and the shifting of traffic to the replacement environment during an Amazon ECS blue/green deployment is now 120. For more information, see Deployments in the Limits topic.

April 12, 2022

Added a topic on how to prevent the confused deputy problem

For more information, see AWS Identity and Access Management for AWS CodeDeploy.

March 14, 2022

CodeDeploy updated an existing AWS managed policy

The AmazonEC2RoleforAWSCodeDeployLimited role was updated. For more information, see AWS managed policy updates.

November 22, 2021

CodeDeploy updated an existing AWS managed policy

The AWSCodeDeployRole was updated. For more information, see AWS managed policy updates.

May 18, 2021

CodeDeploy agent v1.3.2 release

The AWS CodeDeploy agent was updated to version 1.3.2. For more information, see Version History of the CodeDeploy Agent.

May 6, 2021

CodeDeploy supports updating outdated Amazon EC2 instances

CodeDeploy now supports updating outdated Amazon EC2 instances automatically. For more information, see Configure advanced options for a deployment group.

February 23, 2021

CodeDeploy agent v1.3.1 release

The AWS CodeDeploy agent was updated to version 1.3.1. For more information, see Version History of the CodeDeploy Agent.

December 22, 2020

CodeDeploy agent v1.3.0 release

The AWS CodeDeploy agent was updated to version 1.3.0. For more information, see Version History of the CodeDeploy Agent.

November 10, 2020

CodeDeploy agent v1.2.1 release

The AWS CodeDeploy agent was updated to version 1.2.1. For more information, see Version History of the CodeDeploy Agent.

September 23, 2020

CodeDeploy supports Amazon VPC endpoints powered by AWS PrivateLink

If you use Amazon Virtual Private Cloud (Amazon VPC) to host your AWS resources, you can establish a private connection between your VPC and CodeDeploy. You can use this connection to enable CodeDeploy to communicate with your resources on your VPC without going through the public internet. For more information, see Use CodeDeploy with Amazon Virtual Private Cloud.

August 11, 2020

Updated CodeDeploy service limits

Updated the limit for both number of applications per account and number of deployment groups per application to 1000. For more information on CodeDeploy service limits, see CodeDeploy limits.

August 6, 2020

CodeDeploy agent v1.1.2 release

The AWS CodeDeploy agent was updated to version 1.1.2. For more information, see Version History of the CodeDeploy Agent.

August 4, 2020

CodeDeploy agent 1.1.0 release and integration with Amazon EC2 Systems Manager

Version 1.1.0 of the CodeDeploy agent is now available, for more information, see Version history of the CodeDeploy agent. You can now use Amazon EC2 Systems Manager to automatically manage your CodeDeploy agent installation and updates on your Amazon EC2 or on-premises instances. For more information, see Install the CodeDeploy agent using Amazon EC2 Systems Manager.

June 30, 2020

CodeDeploy supports managing Amazon ECS blue/green deployments with AWS CloudFormation

You can now use AWS CloudFormation to manage Amazon ECS blue/green deployments through CodeDeploy. You generate your deployment by defining your green and blue resources and specifying the traffic routing and stabilization settings to use in AWS CloudFormation. For more information, see Create an Amazon ECS blue/green deployment through AWS CloudFormation.

May 19, 2020

CodeDeploy supports weighted traffic shifting for Amazon ECS blue/green deployments

CodeDeploy now supports weighted traffic shifting for Amazon ECS blue/green deployments. You choose or create a deployment configuration to specify the number of traffic shifting intervals in the deployment and the percentage of traffic to shift in each interval. The following topic has been updated to reflect this change: Deployment configurations on an Amazon ECS compute platform.

February 6, 2020

Updated security, authentication, and access control topics

The security, authentication, and access control information for CodeDeploy has been organized into a new Security chapter. For more information, see Security.

November 26, 2019

CodeDeploy supports notification rules

You can now use notification rules to notify users of important changes in deployments. For more information, see Create a notification rule.

November 5, 2019

Updated topics

CodeDeploy is now available in the Asia Pacific (Hong Kong) Region (ap-east-1) region. Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new region. You must explicitly enable access to this region. For more informaiton, see Managing AWS Regions.

April 25, 2019

Updated topics

AWS CodeDeploy now supports blue/green deployments of a containerized application in an Amazon ECS service. A CodeDeploy application that uses the new Amazon ECS compute platform deploys a containerized application to a new, replacement task set in the same Amazon ECS service. Several topics have been added and updated to reflect this change, including Overview of AWS CodeDeploy compute platforms, Deployments on an Amazon ECS compute platform, AppSpec file structure for Amazon ECS deployments, and Create an application for an Amazon ECS service deployment (Console).

November 27, 2018

Updated CodeDeploy agent

The AWS CodeDeploy agent was updated to version 1.0.1.1597. For more information, see Version history of the CodeDeploy agent.

November 15, 2018

Updated console

Procedures in this guide were updated to match the new design of the CodeDeploy console.

October 30, 2018

New minimum supported version of the CodeDeploy agent

The minimum supported version of the AWS CodeDeploy agent is now 1.7.x. For more information, see Version history of the CodeDeploy agent.

August 7, 2018

Earlier updates

The following table describes important changes in each release of the AWS CodeDeploy User Guide before June 2018.

Change Description Date Changed
Topic updates CodeDeploy is now available in the Europe (Paris) Region (eu-west-3) region. Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new region. December 19, 2017
Updated topics

CodeDeploy is now available in the China (Ningxia) Region.

To use services in the China (Beijing) Region or China (Ningxia) Region, you must have an account and credentials for those regions. Accounts and credentials for other AWS regions do not work for the Beijing and Ningxia Regions, and vice versa.

Information about some resources for the China Regions, such as CodeDeploy Resource Kit bucket names and CodeDeploy agent installation procedures, are not included in this edition of the CodeDeploy User Guide.

For more information:

December 11, 2017
Updated topics CodeDeploy now supports the deployment of a Lambda function. An AWS Lambda deployment shifts incoming traffic from an existing Lambda function to an updated Lambda function version. You choose or create a deployment configuration to specify the number of traffic shifting intervals in the deployment and the percentage of traffic to shift in each interval. AWS Lambda deployments are supported by the AWS Serverless Application Model (AWS SAM) so that you can use an AWS SAM deployment preference to manage the way in which traffic is shifted durng an AWS Lambda deployment. Several topics have been added and updated to reflect this change, including Overview of CodeDeploy compute platforms, Deployments on an AWS Lambda Compute Platform, Create an AWS Lambda Compute Platform deployment (console), Create an application for an AWS Lambda function deployment (console), and Add an AppSpec file for an AWS Lambda deployment.

November 28, 2017

New topic

CodeDeploy now supports deployments directly to a local machine or instance where the CodeDeploy agent is installed. You can locally test a deployment and, if it has errors, use CodeDeploy agent error logs to debug them. You can also use a local deployment to test the integrity of an application revision, the contents of an AppSpec file, and more. For more information, see Use the CodeDeploy agent to validate a deployment package on a local machine.

November 16, 2017

Updated topics

CodeDeploy support for Elastic Load Balancing load balancers in deployment groups has been expanded to include Network Load Balancers for both blue/green deployments and in-place deployments. You can now choose an Application Load Balancer, Classic Load Balancer, or Network Load Balancer for your deployment group. Load balancers are required for blue/green deployments and optional for in-place deployments. A number of topics have been updated to reflect this support, including Integrating CodeDeploy with Elastic Load Balancing, Create an application for an in-place deployment (console), Deployment prerequisites, Integrating CodeDeploy with Elastic Load Balancing, and Create an application for an in-place deployment (console).

September 12, 2017

Updated topics

CodeDeploy support for Elastic Load Balancing load balancers in deployment groups has been expanded to include Application Load Balancers for both blue/green deployments and in-place deployments. You can now choose between an Application Load Balancer and a Classic Load Balancer for your deployment group. Load balancers are required for blue/green deployments, and optional for in-place deployments. Topics including Integrating CodeDeploy with Elastic Load Balancing, Create an application with CodeDeploy, and Create a deployment group with CodeDeploy have been updated to reflect this additional support.

August 10, 2017

New and updated topics CodeDeploy now supports using multiple tag groups to identify unions and intersections of instances to be included in a deployment group. If you use a single tag group, any instance identified by at least one tag in the group is included in the deployment group. If you use multiple tag groups, only instances that are identified by at least one tag in each of the tag groups are included. For information about the new method for adding instances to a deployment group, see Tagging Instances for Deployments. Other topics updated to reflect this support include Create an application for an in-place deployment (console), Create an application for a blue/green deployment (console), Create a deployment group for an in-place deployment (console), Create a deployment group for an EC2/On-Premises blue/green deployment (console), Deployments, and Step 5: Create an application and deployment group in Tutorial: Use CodeDeploy to deploy an application from GitHub. July 31, 2017
Updated topic Two additional methods for installing the CodeDeploy agent on Windows Server instances have been added to Install the CodeDeploy agent for Windows Server. In addition to Windows PowerShell commands, instructions are now available for downloading the installation file by using a direct HTTPS link and by using an Amazon S3 copy command. After the file is downloaded or copied to an instance, you can run the installation manually. July 12, 2017
Updated topics

CodeDeploy has improved how it manages connections to GitHub accounts and repositories. You can now create and store up to 25 connections to GitHub accounts in order to associate CodeDeploy applications with GitHub repositories. Each connection can support multiple repositories. You can create connections to up to 25 different GitHub accounts, or create more than one connection to a single account. After you connect an application to a GitHub account, CodeDeploy manages the required access permissions without requiring any further action from you. Updates to reflect this support have been made to Specify information about a revision stored in a GitHub repository, Integrating CodeDeploy with GitHub, and Tutorial: Use CodeDeploy to deploy an application from GitHub.

May 30, 2017
Updated topics

In the past, if the CodeDeploy agent detected files in a target location that weren't part of the application revision from the most recent successful deployment, it would fail the current deployment by default. CodeDeploy now provides options for how the agent handles these files: fail the deployment, retain the content, or overwrite the content. Create a deployment with CodeDeploy was updated to reflect this support, and the new section Rollback behavior with existing content was added to Redeploy and roll back a deployment with CodeDeploy.

May 16, 2017
Updated topics

A Classic Load Balancer in Elastic Load Balancing can now be assigned to a deployment group using the CodeDeploy console or AWS CLI. During an in-place deployment, a load balancer prevents internet traffic from being routed to an instance while it is being deployed to, and then makes the instance available for traffic again once the deployment to that instance completes. Several topics were updated to reflect this new support, including Integration with other AWS services, Integrating CodeDeploy with Elastic Load Balancing, Create an application for an in-place deployment (console), Create a deployment group for an in-place deployment (console), and AppSpec 'hooks' section. A new section was added to the troubleshooting guide, Troubleshooting a failed ApplicationStop, BeforeBlockTraffic, or AfterBlockTraffic deployment lifecycle event.

April 27, 2017
Updated topics

A Classic Load Balancer in Elastic Load Balancing can now be assigned to a deployment group using the CodeDeploy console or AWS CLI. During an in-place deployment, a load balancer prevents internet traffic from being routed to an instance while it is being deployed to, and then makes the instance available for traffic again once the deployment to that instance completes. Several topics were updated to reflect this new support, including Integration with other AWS services, Integrating CodeDeploy with Elastic Load Balancing, Create an application for an in-place deployment (console), Create a deployment group for an in-place deployment (console), and AppSpec 'hooks' section. A new section was added to the troubleshooting guide, Troubleshooting a failed ApplicationStop, BeforeBlockTraffic, or AfterBlockTraffic deployment lifecycle event.

May 1, 2017
Updated topics

CodeDeploy is now available in the China (Beijing) Region.

To use services in the China (Beijing) Region or China (Ningxia) Region, you must have an account and credentials for those regions. Accounts and credentials for other AWS regions do not work for the Beijing and Ningxia Regions, and vice versa.

Information about some resources for the China Regions, such as CodeDeploy Resource Kit bucket names and CodeDeploy agent installation procedures, are not included in this edition of the CodeDeploy User Guide.

For more information:

March 29, 2017
New and updated topics

Several new topics have been introduced to reflect new 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 CodeDeploy. Additional new topics include Create an application for a blue/green deployment (console). Create a deployment group for an EC2/On-Premises blue/green deployment (console), and Set up a load balancer in Elastic Load Balancing for CodeDeploy Amazon EC2 deployments.

Numerous topics have been updated as well, including Create a deployment with CodeDeploy, Working with deployment configurations in CodeDeploy, Create an application with CodeDeploy, Working with deployment groups in CodeDeploy , Working with deployments in CodeDeploy, 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 CodeDeploy is now available in the Europe (London) Region (eu-west-2). Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new region. December 13, 2016
Updated topics CodeDeploy is now available in the Canada (Central) Region (ca-central-1). Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new region. December 8, 2016
Updated topics CodeDeploy is now available in the US East (Ohio) Region (us-east-2). Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new region. October 17, 2016
New topics A new section, Authentication and Access Control, provides comprehensive information about using AWS Identity and Access Management (IAM) and 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 CodeDeploy agent on Windows Server has been updated to reflect the availability of the new 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

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.

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 with CodeDeploy, Create a deployment group with CodeDeploy, Change deployment group settings with CodeDeploy, Deployments, Redeploy and roll back a deployment with CodeDeploy, and Product and service integrations with CodeDeploy, along with a new topic, Monitoring deployments with CloudWatch alarms in CodeDeploy.

September 15, 2016
New and updated topics

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 a CodeDeploy deployment group. You can incorporate actions that invoke AWS Lambda functions; that publish to 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 CodeDeploy with Elastic Load Balancing and Integration with other AWS services have been updated to reflect an additional load balancing option. CodeDeploy now supports the Classic Load Balancer and Application Load Balancer available in Elastic Load Balancing. August 11, 2016
Topic updates CodeDeploy is now available in the Asia Pacific (Mumbai) Region (ap-south-1). Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new region. June 27, 2016
Topic updates

CodeDeploy is now available in the Asia Pacific (Seoul) Region (ap-northeast-2). Several topics, including those containing instructions for setting up the 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 CodeDeploy tutorials. For better usability, several long topics, including CodeDeploy AppSpec file reference and Troubleshooting CodeDeploy, have been divided into shorter topics. Configuration information for the CodeDeploy agent has been moved to a new topic, CodeDeploy 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 CodeDeploy deployments fail.

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

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 CodeDeploy agent, were updated to reflect the availability of this new region.

Working with the 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 CodeDeploy agent to archive.

March 10, 2016
New and updated topics

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 CodeDeploy has been updated.

CodeDeploy quotas 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.

February 17, 2016
New and updated topics

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

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

Managing CodeDeploy agent operations was updated with information about the new .version file added to instances to report the current version of the 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 application specification file to a revision for CodeDeploy 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 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 CodeDeploy integrations. December 16, 2015
Topic updates CodeDeploy is now available in the Asia Pacific (Singapore) Region (ap-southeast-1). Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new region. December 9, 2015
Topic updates

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

CodeDeploy 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 2: Create a service role for CodeDeploy was updated to reflect a new procedure for creating a service role for CodeDeploy and to incorporate other improvements. November 13, 2015
Topic updates CodeDeploy is now available in the Europe (Frankfurt) Region (eu-central-1). Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new region.

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

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

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

October 1, 2015
Topic updates Create a deployment group with CodeDeploy 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 CodeDeploy is now available in the Asia Pacific (Tokyo) Region (ap-northeast-1). Several topics, including those containing instructions for setting up the CodeDeploy agent, were updated to reflect the availability of this new region. August 19, 2015
Topic updates

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

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 CodeDeploy application, deployment group, and deployment lifecycle event, as well as the current CodeDeploy deployment identifier. For more information, see the end of the AppSpec 'hooks' section section in the CodeDeploy AppSpec file reference.

May 29, 2015
Topic updates

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 a user to register revisions with CodeDeploy only and then deploy them through CodeDeploy.

  • A policy for providing a user with full access to CodeDeploy resources.

  • A policy for providing a user with read-only access to CodeDeploy resources.

  • A policy to attach to a service role so that CodeDeploy can identify Amazon EC2 instances by their Amazon EC2 tags, on-premises instance tags, or Amazon EC2 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.

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

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

CodeDeploy resources was added.

April 2, 2015
Topic update

Troubleshooting CodeDeploy 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 CodeDeploy:

The AppSpec 'hooks' section section in the CodeDeploy 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 CodeDeploy: EC2 instances in an Amazon EC2 Auto Scaling group fail to launch and receive the error "Heartbeat Timeout".

A CloudBees section was added to Product and service integrations with CodeDeploy.

January 28, 2015
Topic updates

The following sections were added to Troubleshooting CodeDeploy:

January 20, 2015
New topics

The Product and service integrations with CodeDeploy section was updated to include the following topics:

January 9, 2015
Topic updates
January 8, 2015
New topic Monitoring Deployments was added. CodeDeploy is integrated with AWS CloudTrail, a service that captures API calls made by or on behalf of CodeDeploy in your AWS account and delivers the log files to an Amazon S3 bucket that you specify. December 17, 2014

Initial public release

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

November 12, 2014