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

AWS CodeDeploy Resource Kit Reference

Many of the files AWS CodeDeploy relies on are stored in publicly available, AWS region-specific Amazon S3 buckets. These files include installation files for the AWS CodeDeploy agent, templates, and sample application files. We call this collection of files the AWS CodeDeploy Resource Kit.

Resource Kit Bucket Names by Region

This table lists the names of bucket-name replacements required for some procedures in the guide. These are the names of the Amazon S3 buckets that contain the AWS CodeDeploy Resource Kit files.

Region name bucket-name replacement Region identifier
US East (Ohio) aws-codedeploy-us-east-2 us-east-2
US East (N. Virginia) aws-codedeploy-us-east-1 us-east-1
US West (N. California) aws-codedeploy-us-west-1 us-west-1
US West (Oregon) aws-codedeploy-us-west-2 us-west-2
Canada (Central) aws-codedeploy-ca-central-1 ca-central-1
EU (Ireland) aws-codedeploy-eu-west-1 eu-west-1
EU (London) aws-codedeploy-eu-west-2 eu-west-2
EU (Frankfurt) aws-codedeploy-eu-central-1 eu-central-1
Asia Pacific (Tokyo) aws-codedeploy-ap-northeast-1 ap-northeast-1
Asia Pacific (Seoul) aws-codedeploy-ap-northeast-2 ap-northeast-2
Asia Pacific (Singapore) aws-codedeploy-ap-southeast-1 ap-southeast-1
Asia Pacific (Sydney) aws-codedeploy-ap-southeast-2 ap-southeast-2
Asia Pacific (Mumbai) aws-codedeploy-ap-south-1 ap-south-1
South America (São Paulo) aws-codedeploy-sa-east-1 sa-east-1

Resource Kit Contents

The following table lists the files in the AWS CodeDeploy Resource Kit.

File Description
VERSION A file used by AWS CodeDeploy agents to update themselves as they are running on instances.
codedeploy-agent.noarch.rpm The AWS CodeDeploy agent for Amazon Linux and Red Hat Enterprise Linux (RHEL). There may be several files with the same base file name, but different versions (such as -1.0-0).
codedeploy-agent_all.deb The AWS CodeDeploy agent for Ubuntu Server. There may be several files with the same base file name, but different versions (such as _1.0-0).
codedeploy-agent.msi The AWS CodeDeploy agent for Windows Server. There may be several files with the same base file name, but different versions (such as -1.0-0).
install A file you can use to more easily install the AWS CodeDeploy agent.

CodeDeploy_SampleCF_Template.json

An AWS CloudFormation template you can use to launch from one to three Amazon EC2 instances running Amazon Linux or Windows Server. There may be several files with the same base file name, but different versions (such as -1.0.0).

CodeDeploy_SampleCF_ELB_Integration.json An AWS CloudFormation template you can use to create a load-balanced sample Web site running on an Apache Web Server. The application is configured to span all Availability Zones in the region you create it in. Thes template creates three Amazon EC2 instances and IAM instance profile to grant the instances access to the resources in Amazon S3, Auto Scaling, AWS CloudFormation, and Elastic Load Balancing. It also creates the load balancer and an AWS CodeDeploy service role.
SampleApp_ELB_Integration.zip A sample application revision you can deploy to an Amazon EC2 instance that is registered to an Elastic Load Balancing load balancer.
SampleApp_Linux.zip

A sample application revision you can deploy to an Amazon EC2 instance running Amazon Linux or to a Ubuntu Server or RHEL instance. There may be several files with the same base file name, but different versions (such as -1.0).

SampleApp2_Linux.zip A sample application revision that is deployed to a replacement fleet of instances when you run theSample deployment wizard.
SampleApp_Windows.zip A sample application revision you can deploy to a Windows Server instance. There may be several files with the same base file name, but different versions (such as -1.0).

Display a List of the Resource Kit Files

To view a list of files, use the aws s3 ls command for your region.

Note

The files in each bucket are designed to work with resources in the corresponding region.

Copy
aws s3 ls --recursive s3://aws-codedeploy-us-east-2
Copy
aws s3 ls --recursive s3://aws-codedeploy-us-east-1
Copy
aws s3 ls --recursive s3://aws-codedeploy-us-west-1
Copy
aws s3 ls --recursive s3://aws-codedeploy-us-west-2
Copy
aws s3 ls --recursive s3://aws-codedeploy-ca-central-1
Copy
aws s3 ls --recursive s3://aws-codedeploy-eu-west-1
Copy
aws s3 ls --recursive s3://aws-codedeploy-eu-west-2
Copy
aws s3 ls --recursive s3://aws-codedeploy-eu-central-1
Copy
aws s3 ls --recursive s3://aws-codedeploy-ap-northeast-1
Copy
aws s3 ls --recursive s3://aws-codedeploy-ap-northeast-2
Copy
aws s3 ls --recursive s3://aws-codedeploy-ap-southeast-1
Copy
aws s3 ls --recursive s3://aws-codedeploy-ap-southeast-2
Copy
aws s3 ls --recursive s3://aws-codedeploy-ap-south-1
Copy
aws s3 ls --recursive s3://aws-codedeploy-sa-east-1

Download the Resource Kit Files

To download a file, use the aws s3 cp command for your region.

Note

Be sure to use the period (.) near the end. This downloads the file to your current directory.

For example, the following commands download a single file named SampleApp_Linux.zip from one of the buckets' /samples/latest/ folders:

Copy
aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Linux.zip . --region us-east-2
Copy
aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Linux.zip . --region us-east-1
Copy
aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Linux.zip . --region us-west-1
Copy
aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Linux.zip . --region us-west-2
Copy
aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Linux.zip . --region ca-central-1
Copy
aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Linux.zip . --region eu-west-1
Copy
aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Linux.zip . --region eu-west-2
Copy
aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Linux.zip . --region eu-central-1
Copy
aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Linux.zip . --region ap-northeast-1
Copy
aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Linux.zip . --region ap-northeast-2
Copy
aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Linux.zip . --region ap-southeast-1
Copy
aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Linux.zip . --region ap-southeast-2
Copy
aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Linux.zip . --region ap-south-1
Copy
aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Linux.zip . --region sa-east-1

To download all of the files, use one of the following commands for your region:

Copy
aws s3 cp --recursive s3://aws-codedeploy-us-east-2 . --region us-east-2
Copy
aws s3 cp --recursive s3://aws-codedeploy-us-east-1 . --region us-east-1
Copy
aws s3 cp --recursive s3://aws-codedeploy-us-west-1 . --region us-west-1
Copy
aws s3 cp --recursive s3://aws-codedeploy-us-west-2 . --region us-west-2
Copy
aws s3 cp --recursive s3://aws-codedeploy-ca-central-1 . --region ca-central-1
Copy
aws s3 cp --recursive s3://aws-codedeploy-eu-west-1 . --region eu-west-1
Copy
aws s3 cp --recursive s3://aws-codedeploy-eu-west-2 . --region eu-west-2
Copy
aws s3 cp --recursive s3://aws-codedeploy-eu-central-1 . --region eu-central-1
Copy
aws s3 cp --recursive s3://aws-codedeploy-ap-northeast-1 . --region ap-northeast-1
Copy
aws s3 cp --recursive s3://aws-codedeploy-ap-northeast-2 . --region ap-northeast-2
Copy
aws s3 cp --recursive s3://aws-codedeploy-ap-southeast-1 . --region ap-southeast-1
Copy
aws s3 cp --recursive s3://aws-codedeploy-ap-southeast-2 . --region ap-southeast-2
Copy
aws s3 cp --recursive s3://aws-codedeploy-ap-south-1 . --region ap-south-1
Copy
aws s3 cp --recursive s3://aws-codedeploy-sa-east-1 . --region sa-east-1