pilgrim2go/aws-ec2-cloudflare-lambda

An AWS Lambda function created in Python 2.7 that triggers on CloudWatch Event of an EC2 instance starting and takes the Public IPv4 Address and updates an A-record within Cloudflare DNS using Cloudflare's API.

⚙️ AWS EC2 to Cloudflare Lambda Function

📢 Use Case Explanation

I like to use a very specific domain name when I demo CyberArk Conjur because it's easier for me to remember and it also looks better to the customer. Even so, if it doesn't look good to them -- it still looks better to me!

I noticed quickly that when I'd set the public IPv4 address of my AWS EC2 instance that I demo from to an A record for cdemo.cybr.rocks in Cloudflare's DNS, it'd be good for that Instance running. However, after I stopped the EC2 instance and, eventually, restarted it again, it boots with a different public IPv4 address.

Now, I'm sure I could just use an Elastic IP and assign it and call it a day... but that costs money -- even when it's not being used! I can save money, even over the Elastic IP lease, triggering the AWS Lambda function only when my Instance State changes.

Finally, to the use case: upon a defined Instance's Instance State changing to "Running", grab the defined Instance's public IPv4 address and update a defined A record in Cloudflare's DNS.

🤖 My Engineered Solution

• First and foremost, it should be open sourced on GitHub.
  • https://github.com/infamousjoeg/aws-ec2-cloudflare-lambda
  • Language should be Python. (My most comfortable language currently.)
• Any custom functions should be put in a Python module package format for easy distribution later.
• The AWS Lambda function's execution role should have the following permissions:
  • CloudWatch Logs
  • SNS (Publish)
  • EC2 (EC2ReadOnlyAccess IAM Role)
• The Instance State change should be a CloudWatch Event trigger in the function.
• The function should be universally adoptable. It should make the following variables available to the Python script as Environment Variables:
  • EC2_INSTANCE_NAME
  • CLOUDFLARE_EMAIL
  • CLOUDFLARE_API_KEY
  • CLOUDFLARE_A_NAME
  • CLOUDFLARE_DNS_ID
  • CLOUDFLARE_ZONE_ID
• The function should use the AWS SDK to describe the EC2 instance provided and retrieve the public IPv4 address assigned.
• The function should use Cloudflare's RESTful API to update the specified A record in the DNS & Zone given using the E-Mail and API Key provided for authentication to do so. Updating it to the previously retrieved public IPv4 address.

⁉️ How I Did It

🧟‍ Decomposition

Coming into this phase, I already knew I was doing something that took way too long and way too many times repeatedly. Immediately, that triggered my "Automation Senses" -- like Spidey Senses... but less cool... and not surprisingly dorkier.

Easily repeatable processes are the 🏅 GOLDEN RULE 🏅 when it comes to easy automation. All that was left was decomposing that easily repeatable process:

🔁 My Easily Repeatable Process

• When I start an AWS EC2 Instance, I do the following:
  • Copy the EC2 Instance's public IPv4 address to my clipboard.
  • Browse to https://cloudflare.com.
  • Login to my Cloudflare account.
  • Select cybr.rocks from the list of domains managed.
  • Select the IP address value of the A record named cdemo.cybr.rocks and update it with the public IPv4 address on my clipboard.

👟 "Step" Development

I made a name for this development method because I don't really know what it's called. However, it's a process to development I found to be profoundly effective in a majority of my situations. Those being where I'm a solo developer, tester, and releaser all wrapped into one.

The idea behind Step Development is rather easy -- take your decomposed "easily repeatable process" and script it one bullet point at a time. Testing it one bullet point at a time. While also, essentially, releasing it one bullet point at a time.

✅ Step #1: Get the EC2 Instance's Public IPv4 Address

The first bullet point in my decomposition is to grab the running EC2 instance's public IPv4 address once it is assigned fresh off a new run state. I created and tested the function released in pkg/func.py in my Terminal within MacOS.

✅ Step #2: Authenticate to Cloudflare

The second bullet point in my decomposition is to browse to Cloudflare, while my third is to login to Cloudflare. Since this is automation, we'll kill two birds with one stone over the REST API. Better yet, after investigating the Cloudflare REST API Documentation, it looks like we can authenticate while also updating the A record.

SCORE! Nothing to do this step!

✅ Step #3: Update A Record in Cloudflare DNS via REST API

Finally, the meat 🥩 and potatoes 🥔 of the function!

I created cloudflare.py as a means to creating and testing this function released in pkg/func.py. I decided to keep it because it's a great example of how to interact with Cloudflare's REST API using Python in a raw manner.

Back to the function, though. It authenticates with the provided Cloudflare e-mail address and API key. After confirmation of successful authentication, it then updates the A record associated with the A record name provided via DNS ID in the domain managed in Cloudflare associated with the provided Zone ID.

🌎 Where Is It?

I released my AWS Lambda function under main.py. It invokes main.handler on trigger action -- therefore, you'll find in main.py a defined handler function that contains the actions to take.

You can use the exported AWS SAM template to orchestrate setting up your AWS Lambda function using the same Python script. Just don't forget to populate values into your Environment Variables before enabling the CloudWatch Event trigger!

📦 Release

You may download the latest SAM template release from the GitHub project page.

😴 TL;DR

Here's a link straight to the project on GitHub: https://github.com/infamousjoeg/aws-ec2-cloudflare-lambda

🎫 License

MIT