Deploying to AWS CodeDeploy

Components

The deployment of an artifact to AWS CodeDeploy involves several major components as follows:

Application – A name that uniquely identifies the application that you want to deploy.
- Application Revision – An archive file containing source content – such as source code, web pages, executable files, and deployment scripts – along with an Application Specification File (AppSpec file). Revisions are stored in Amazon S3 buckets or GitHub repositories.
- Deployment Configuration – A set of deployment rules and deployment success and failure conditions that AWS CodeDeploy uses during a deployment.
- Deployment Group – A set of individual instances. A deployment group contains individually-tagged Amazon EC2 instances, Amazon EC2 instances in Auto Scaling groups, or both.

On this page:

Related pages:

The deployment workflow is illustrated by the following diagram:

The binding between those components is established indirectly and comprises the following activities:

create an application – see the Create action of the AWS CodeDeploy Application task
1. create and/or specify a deployment group – see the Create action of the AWS CodeDeploy Deployment Group task
  - the target instances can be provisioned with AWS CloudFormation for example – see the Create action of the AWS CloudFormation Stack task
2. optionally specify a deployment configuration
commit or upload the application source code (the 'Revision') – see the Upload action of the Amazon S3 Object task
deploy an application revision for that application – see the Create action of the AWS CodeDeploy Deployment task

- the AWS CodeDeploy Agent on each participating instance pulls the revision from the specified Amazon S3 bucket or GitHub repository and starts deploying the contents to that instance, following the instructions in the AppSpec file that's provided