CodeDeploy resource kit reference
Many of the files CodeDeploy relies on are stored in publicly available, Amazon region-specific Amazon S3 buckets. These files include installation files for the CodeDeploy agent, templates, and sample application files. We call this collection of files the CodeDeploy Resource Kit.
Topics
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 CodeDeploy Resource Kit files.
Note
To access the Amazon S3 bucket in the Asia Pacific (Hong Kong) Region, you must enable the region in your Amazon account. For more information, see Managing Amazon Regions.
| Region name | Bucket-name replacement |
Region identifier |
|---|---|---|
| China (Beijing) | aws-codedeploy-cn-north-1 | cn-north-1 |
| China (Ningxia) | aws-codedeploy-cn-northwest-1 | cn-northwest-1 |
Resource kit contents
The following table lists the files in the CodeDeploy Resource Kit.
| File | Description |
|---|---|
LATEST_VERSION |
A file used by update mechanisms like Amazon EC2 Systems Manager to determine the latest version of the CodeDeploy agent. |
VERSION |
The auto-update mechanism was removed in CodeDeploy agent version 1.1.0 and this file is no longer used. A file used by CodeDeploy agents to update themselves as they are running on instances. |
codedeploy-agent.noarch.rpm |
The 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 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 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 CodeDeploy agent. |
|
|
An Amazon 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 |
CodeDeploy_SampleCF_ELB_Integration.json |
An Amazon 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. This template creates three Amazon EC2 instances and IAM instance profile to grant the instances access to the resources in Amazon S3, Amazon EC2 Auto Scaling, Amazon CloudFormation, and Elastic Load Balancing. It also creates a load balancer and a 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 |
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.
-
aws s3 ls --recursive s3://aws-codedeploy-cn-north-1 --region cn-north-1 -
aws s3 ls --recursive s3://aws-codedeploy-cn-northwest-1 --region cn-northwest-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:
-
aws s3 cp s3://aws-codedeploy-cn-north-1/samples/latest/SampleApp_Linux.zip . --region cn-north-1 -
aws s3 cp s3://aws-codedeploy-cn-northwest-1/samples/latest/SampleApp_Linux.zip . --region cn-northwest-1
To download all of the files, use one of the following commands for your region:
-
aws s3 cp --recursive s3://aws-codedeploy-cn-north-1 . --region cn-north-1 -
aws s3 cp --recursive s3://aws-codedeploy-cn-northwest-1 . --region cn-northwest-1