Choose a CodeDeploy repository type

The storage location for files required by CodeDeploy is called a repository. Use of a repository depends on which compute platform your deployment uses.

• EC2/On-Premises: To deploy your application code to one or more instances, your code must be bundled into an archive file and placed in a repository where CodeDeploy can access it during the deployment process. You bundle your deployable content and an AppSpec file into an archive file, and then upload it to one of the repository types supported by CodeDeploy.

• AWS Lambda and Amazon ECS: Deployments require an AppSpec file, which can be accessed during a deployment in one of the following ways:

  • From an Amazon S3 bucket.

  • From text typed directly into the AppSpec editor in the console. For more information, see Create an AWS Lambda Compute Platform deployment (console) and Create an Amazon ECS Compute Platform deployment (console).

  • If you use the AWS CLI, you can reference an AppSpec file that is on your hard drive or on a network drive. For more information, see Create an AWS Lambda Compute Platform deployment (CLI) and Create an Amazon ECS Compute Platform deployment (CLI).

CodeDeploy currently supports the following repository types:

Repository Type	Repository Details	Supported Compute Platform
Amazon S3	Amazon Simple Storage Service (Amazon S3) is the AWS solution for secure, scalable object storage. Amazon S3 stores data as objects in buckets. An object consists of a file and, optionally, any metadata that describes that file. To store an object in Amazon S3, you upload the file to a bucket. When you upload a file, you can set permissions and metadata on the object. Learn more: Create a bucket in Amazon S3 Push a revision for CodeDeploy to Amazon S3 (EC2/On-Premises deployments only) Automatically deploy from Amazon S3 using CodeDeploy	Deployments that use the following compute platforms can store the revision in an Amazon S3 bucket. EC2/On-Premises AWS Lambda Amazon ECS
GitHub	You can store your application revisions in GitHub repositories. You can trigger a deployment from a GitHub repository whenever the source code in that repository is changed. Learn more: Integrating CodeDeploy with GitHub Tutorial: Use CodeDeploy to deploy an application from GitHub	Only EC2/On-Premises deployments can store the revision in a GitHub repository.
Bitbucket	You can deploy code to deployment groups of EC2 instances by using the CodeDeploy pipe in Bitbucket Pipelines. Bitbucket Pipelines offers continuous integration and continuous deployment (CI/CD) features, including Bitbucket Deployments. The CodeDeploy pipe first pushes the artifact to an S3 bucket that you have specified, and then deploys the code artifact from the bucket. Learn more: See the CodeDeploy pipe for Bitbucket	Only EC2/On-Premises deployments can store the revision in a BitBucket repository.

Note

An AWS Lambda deployment works with an Amazon S3 repository only.