README.md

EC2IndexPage

A simple HTML/CSS/JS page that dynamically displays EC2 instance info. This was a learning exercise with a goal of learning mutiple services, and using them to determine which exact EC2 instance served a webpage when behind an ALB.

Requirements

EC2

This entire example is based on the stock Amazon Linux 2 AMI (64-bit x86).

DynamoDB

This page calls a DynamoDB table called InstanceTable. It should be set up with 2 keys, like below.

You can create the table programatically, or just use the web interface, since it's so simple.

Cognito

My process loosely followed this AWS guide. Your Cognito identity pool should look something like this when you're done. Note: the key is to enable access to unauthenticated identities.

IAM

After a successful Cognito identity pool creation, you should see 2 IAM roles, one with auth in the name, one with unauth in the name. Make sure you're working in the unauth role, otherwise you'll see a bunch of 400 requests.

The IAM policy needed (shown above as DDB-Anon-Policy) is very simplistic. We're only concerned with the GetItem call on our specific DynamoDB table. Replace region and account ID with your own in the policy below. Also, if you chose to name your DynamoDB table something other than InstanceTable, you'll need to change that in the IAM policy and the JavaScript in the index.html file.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "dynamodb:GetItem",
            "Resource": "arn:aws:dynamodb:REGION:ACCOUNTID:table/InstanceTable"
        }
    ]
}

In order to have the EC2 instance post its own info to the DynamoDB table, we'll need to create and attach an EC2 role. The IAM policy is as follows:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "dynamodb:PutItem",
            "Resource": "arn:aws:dynamodb:REGION:ACCOUNTID:table/InstanceTable"
        }
    ]
}

The policy was attached to an IAM role for EC2, shown below.

Operation

If everything goes well, you should see this in the browser:

Watch the requests roll in across your EC2 instances: sudo tail -f /etc/httpd/logs/access_log | grep -v HealthChecker

Notes

When adding a new property to display, the following areas need to be modified:

• index.html
  • javascript variable
  • getelementbyid
  • HTML span
• item.json
• bootstrap.sh
  • new BASH variable
  • new sed entry for item.json

To-Do

• 8/14/19: I haven't yet created a mechanism to automatically post the EC2 instance ID and IPv4 address to the Dynamo table. Maybe a simple AWS CLI function in the bootstrap script. For now, I've manually added them to test with.

  • 8/15/19: This has been resolved. AWS CLI invokes a DynamoDB PUT.

• 8/14/19: The JavaScript needs to dynamically pull the parameter, likely from a local file containing the instance ID. That file can be created by the same future bootstrap script.

  • 8/15/19: This is also resolved. The bootstrap.sh script "dynamically" generates the index.html page on boot, filling in the instance ID.

• 8/15/19: If I choose to clean up the DynamoDB table, I'll probably want an external Lambda function to do that. It could check for currently running instances and delete anything not matching a currently running instance ID.

• 8/15/19: It would be nice to see some other info besides the IP address, like instance type, or something else from the metadata.

  • 8/15/19: Added instance type, and documented what needs to be modified to add more properties in the future.

• 8/15/19: Create CloudFormation template that includes an Auto Scaling Group and Launch Configuration. The CF template should also have an S3 bucket to pull in the modified httpd.conf file (includes X-Forwarded-For logging). The CF template can include all of the prerequisites above, like the DynamoDB table, Cognito config, and IAM roles.