Last Updated: October 24, 2016
· vaneyckt

Creating an EC2 Instance in a VPC with the AWS Command Line Interface

Preface: The original article for this post has since been moved to here on my personal blog.

Setting up an EC2 instance on AWS used to be as straightforward as provisioning a machine and SSHing into it. However, this process has become a bit more complicated now that Amazon VPC has become the standard for managing machines in the cloud.

So what exactly is a Virtual Private Cloud? Amazon defines a VPC as a 'a logically isolated section of the AWS Cloud'. Instances launched inside a VPC can by default only talk to other instances in the same VPC and are therefore invisible to the rest of the internet. This means they will not accept SSH connections coming from your computer or respond to any http requests. In this article we'll go over how to change these default settings into something more befitting of a general purpose server.

Setting up your VPC

Start by installing the AWS Command Line Interface on your machine if you haven't done so already. With this done, we can now create our VPC.

vpcId=`aws ec2 create-vpc --cidr-block --query 'Vpc.VpcId' --output text`

There are several interesting things here:

  • the --cidr-block parameter specifies a /28 netmask that allows for 16 IP addresses. This is the smallest supported netmask.
  • the create-vpc command returns a JSON string. We can use the --query and --output parameters to filter out specific fields from this string.

The next step is to overwrite the default VPC DNS settings. As mentioned earlier, instances launched inside a VPC are invisible to the rest of the internet by default. AWS therefore does not bother assigning them a public DNS name. Luckily this can be changed easily.

aws ec2 modify-vpc-attribute --vpc-id $vpcId --enable-dns-support "{\"Value\":true}"
aws ec2 modify-vpc-attribute --vpc-id $vpcId --enable-dns-hostnames "{\"Value\":true}"

Adding an Internet Gateway

Next we need to connect our VPC to the rest of the internet by attaching an internet gateway. Our VPC would be isolated from the internet without this.

internetGatewayId=`aws ec2 create-internet-gateway --query 'InternetGateway.InternetGatewayId' --output text`
aws ec2 attach-internet-gateway --internet-gateway-id $internetGatewayId --vpc-id $vpcId

Creating a Subnet

A VPC can have multiple subnets. Since our use case only requires one, we can reuse the cidr-block specified during VPC creation so as to get a single subnet that spans the entire VPC address space.

subnetId=`aws ec2 create-subnet --vpc-id $vpcId --cidr-block --query 'Subnet.SubnetId' --output text`

While this --cidr-block parameter specifies a subnet that can contain 16 IP addresses ( -, AWS will reserve 5 of those for private use. While this doesn't really have an impact on our use case, it is still good to be aware of such things.

Configuring the Route Table

Each subnet needs to have a route table associated with it to specify the routing of its outbound traffic. By default every subnet inherits the default VPC route table which allows for intra-VPC communication only.

The following adds a route table to our subnet that allows traffic not meant for an instance inside the VPC to be routed to the internet through our earlier created internet gateway.

routeTableId=`aws ec2 create-route-table --vpc-id $vpcId --query 'RouteTable.RouteTableId' --output text`
aws ec2 associate-route-table --route-table-id $routeTableId --subnet-id $subnetId
aws ec2 create-route --route-table-id $routeTableId --destination-cidr-block --gateway-id $internetGatewayId

Adding a Security Group

Before we can launch an instance, we need to create a security group that specifies which ports should allow traffic. For now we'll just allow any IP to try and make an SSH connection by opening port 22 to any ip.

securityGroupId=`aws ec2 create-security-group --group-name my-security-group --description "my-security-group" --vpc-id $vpcId --query 'GroupId' --output text`
aws ec2 authorize-security-group-ingress --group-id $securityGroupId --protocol tcp --port 22 --cidr

Launching your Instance

All that's left to do is to create an SSH key pair and then launch an instance secured by this. Let's generate this key pair and store it locally with the correct permissions.

aws ec2 create-key-pair --key-name my-key --query 'KeyMaterial' --output text > ~/.ssh/my-key.pem
chmod 400 ~/.ssh/my-key.pem

Launching a single t2.micro instance based on the public AWS Ubuntu image can now be done as follows.

instanceId=`aws ec2 run-instances --image-id ami-9eaa1cf6 --count 1 --instance-type t2.micro --key-name my-key --security-group-ids $securityGroupId --subnet-id $subnetId --associate-public-ip-address --query 'Instances[0].InstanceId' --output text`

After a few minutes your instance should be up and running. You can obtain the url of your active instance by running the command below.

instanceUrl=`aws ec2 describe-instances --instance-ids $instanceId --query 'Reservations[0].Instances[0].PublicDnsName' --output text`

You can now establish an SSH connection with your running instance.

ssh -i ~/.ssh/my-key.pem ubuntu@$instanceUrl

And that's it. It's really not all that hard. There's just an awful lot of concepts that you need to get your head around which can make it a bit daunting at first. Check out the free Amazon Virtual Private Cloud User Guide if you want to learn more about VPCs.

5 Responses
Add your response

This was incredibly helpful, thanks! Your commentary was great.

Have you had much luck "tearing this down" with the CLI? I'm finding is difficult to delete the VPCs and routing tables after this setup.

over 1 year ago ·

Great write up, right to the details and very clear. Also am using JQ to query output of describe-instance etc. and quickly pull data from JSON.


over 1 year ago ·

This was awesome help, thanks. I don't know why this 'from scratch' example isn't part of AWS documentation...

over 1 year ago ·

thank you so much. this was so much more revelatory than megabytes of AWS 'help'!

over 1 year ago ·

Greate tutorial. You can also refer this one Create VPC using CLI

over 1 year ago ·