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

The procedures in this guide support the new console design. If you choose to use the older version of the console, you will find many of the concepts and basic procedures in this guide still apply. To access help in the new console, choose the information icon.

Working with On-Premises Instances for AWS CodeDeploy

An on-premises instance is any physical device that is not an Amazon EC2 instance that can run the AWS CodeDeploy agent and connect to public AWS service endpoints.

Deploying an AWS CodeDeploy application revision to an on-premises instance involves two major steps:

If you don't want an on-premises instance to be used in deployments anymore, you can simply remove the on-premises instance tags from the deployment groups. For a more robust approach, remove the on-premises instance tags from the instance. You can also explicitly deregister an on-premises instance so it can no longer be used in any deployments. For more information, see Managing On-Premises Instances Operations in AWS CodeDeploy.

The instructions in this section show you how to configure an on-premises instance and then register and tag it with AWS CodeDeploy so it can be used in deployments. This section also describes how to use AWS CodeDeploy to get information about on-premises instances and deregister an on-premises instance after you're no longer planning to deploy to it.