Create an Amazon EC2 instance for CodeDeploy (Amazon CLI or Amazon EC2 console)

Sign in to the Amazon Web Services Management Console and open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

In the navigation pane, choose Instances, and then choose Launch Instance.

On the Step 1: Choose an Amazon Machine Image (AMI) page, from the Quick Start tab, locate the operating system and version you want to use, and then choose Select. You must choose an Amazon EC2 AMI operating systems supported by CodeDeploy. For more information, see Operating systems supported by the CodeDeploy agent.

On the Step 2: Choose an Instance Type page, choose any available Amazon EC2 instance type, and then choose Next: Configure Instance Details.

On the Step 3: Configure Instance Details page, in the IAM role list, choose the IAM instance role you created in Step 4: Create an IAM instance profile for your Amazon EC2 instances. If you used the suggested role name, then choose CodeDeployDemo-EC2-Instance-Profile. If you created your own role name, choose that.

Choose Next: Add Storage.

Leave the Step 4: Add Storage page unchanged, and choose Next: Add Tags.

On the Step 5: Add Tags page, choose Add Tag.

In the Key box, type Name. In the Value box type CodeDeployDemo.

Choose Next: Configure Security Group.

On the Step 6: Configure Security Group page, leave the Create a new security group option selected.

A default SSH role is configured for Amazon EC2 instances running Amazon Linux, Ubuntu Server, or RHEL. A default RDP role is configured for Amazon EC2 instances running Windows Server.

If you want to open the HTTP port, choose the Add Rule button, and from the Type drop-down list, choose HTTP. Accept the default Source value of Custom 0.0.0.0/0, and then choose Review and Launch.

If a Boot from General Purpose (SSD) dialog box appears, follow the instructions, and then choose Next.

Leave the Step 7: Review Instance Launch page unchanged, and choose Launch.

In the Select an existing key pair or create a new key pair dialog box, choose either Choose an existing key pair or Create a new key pair. If you've already configured an Amazon EC2 instance key pair, you can choose it here.

If you don't already have an Amazon EC2 instance key pair, choose Create a new key pair and give it a recognizable name. Choose Download Key Pair to download the Amazon EC2 instance key pair to your computer.

Choose Launch Instances.

Choose the ID for your Amazon EC2 instance. Do not continue until the instance has been launched and passed all checks.

For Windows Server only If you are creating an Amazon EC2 instance running Windows Server, call the create-security-group and authorize-security-group-ingress commands to create a security group that allows RDP access (which is not allowed by default) and, alternatively, HTTP access. For example, to create a security group named CodeDeployDemo-Windows-Security-Group, run the following commands, one at a time:

aws ec2 create-security-group --group-name CodeDeployDemo-Windows-Security-Group --description "For launching Windows Server images for use with CodeDeploy"

aws ec2 authorize-security-group-ingress --group-name CodeDeployDemo-Windows-Security-Group --to-port 3389 --ip-protocol tcp --cidr-ip 0.0.0.0/0 --from-port 3389

aws ec2 authorize-security-group-ingress --group-name CodeDeployDemo-Windows-Security-Group --to-port 80 --ip-protocol tcp --cidr-ip 0.0.0.0/0 --from-port 80

Call the run-instances command to create and launch the Amazon EC2 instance.

Before you call this command, you need to collect the following:

For Amazon Linux, RHEL, and Ubuntu Server

To call the run-instances command to launch an Amazon EC2 instance running Amazon Linux, Ubuntu Server, or RHEL and attach the IAM instance profile you created in Step 4: Create an IAM instance profile for your Amazon EC2 instances. For example:

aws ec2 run-instances \
  --image-id ami-id \
  --key-name key-name \
  --count 1 \
  --instance-type instance-type \
  --iam-instance-profile Name=iam-instance-profile

For Windows Server

To call the run-instances command to launch an Amazon EC2 instance running Windows Server and attach the IAM instance profile you created in Step 4: Create an IAM instance profile for your Amazon EC2 instances, and specify the name of the security group you created in Step 1. For example:

aws ec2 run-instances --image-id ami-id --key-name key-name --count 1 --instance-type instance-type --iam-instance-profile Name=iam-instance-profile --security-groups CodeDeploy-Windows-Security-Group

These commands launch a single Amazon EC2 instance with the specified AMI, key pair, and instance type, with the specified IAM instance profile, and run the specified script during launch.

Note the value of the InstanceID in the output. If you forget this value, you can get it later by calling the describe-instances command against the Amazon EC2 instance key pair.

aws ec2 describe-instances --filters "Name=key-name,Values=keyName" --query "Reservations[*].Instances[*].[InstanceId]" --output text

Use the instance ID to call the create-tags command, which tags the Amazon EC2 instance so that CodeDeploy can find it later during a deployment. In the following example, the tag is named CodeDeployDemo, but you can specify any Amazon EC2 instance tag you want.

aws ec2 create-tags --resources instance-id --tags Key=Name,Value=CodeDeployDemo

You can apply multiple tags to an instance at the same time. For example:

aws ec2 create-tags --resources instance-id --tags Key=Name,Value=testInstance Key=Region,Value=West Key=Environment,Value=Beta

To verify the Amazon EC2 instance has been launched and passed all checks, use the instance ID to call the describe-instance-status command.

aws ec2 describe-instance-status --instance-ids instance-id --query "InstanceStatuses[*].InstanceStatus.[Status]" --output text