AWS Documentation » AWS CodeDeploy » User Guide » Working with Instances for CodeDeploy » Working with On-Premises Instances for CodeDeploy » Register an On-Premises Instance with CodeDeploy

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.

Register an On-Premises Instance with CodeDeploy

To register an on-premises instance, you must use an IAM identity to authenticate your requests. You can choose from the following options for the IAM identity and registration method you use:

• Use an IAM user ARN to authenticate requests.

  • Use the register command for the most automated registration process. Best for registering a single on-premises instance. For information, see Use the register Command (IAM User ARN) to Register an On-Premises Instance.

  • Use the register-on-premises-instance command to manually configure most registration options. Suitable for registering a small number of on-premises instances. For information, see Use the register-on-premises-instance Command (IAM User ARN) to Register an On-Premises Instance.

• Use an IAM role ARN to authenticate requests.

  • Use the register-on-premises-instance command and periodically refreshed temporary credentials generated with the AWS Security Token Service (AWS STS) to manually configure most registration options. Best for registering a large number of on-premises instances. For information, see Use the register-on-premises-instance Command (IAM Session ARN) to Register an On-Premises Instance .

Topics

• Use the register Command (IAM User ARN) to Register an On-Premises Instance
• Use the register-on-premises-instance Command (IAM User ARN) to Register an On-Premises Instance
• Use the register-on-premises-instance Command (IAM Session ARN) to Register an On-Premises Instance