README.md

devbox

devbox is the EC2 instance I use for development for all of my work. Right now it probably doesn't hold much value for anyone else.

What this does

This repo will create an EC2 instance and associated VPC in Amazon EC2 that you can use for development work. It will install:

• Go
• Rust
• AWS CLI
• Docker
• Git

What this doesn't do

It doesn't create unicorns or configure your dev environment's dotfiles. Batteries aren't included.

Deployment

There's a number of steps to run through to deploy this in your AWS Account.

Prerequisites

1. VSCode
2. An AWS account
3. An EC2 keypair (see: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-key-pairs.html)

Install

You will need to deploy the two AWS CloudFormation templates in the stacks folder. Start by deploying the documents.yaml file, once that has reached the status of CREATE_COMPLETE in the CloudFormation console, you can deploy devbox.yaml in the same way.

The devbox will take a while to provision with all of the software that it's told to install, you can follow along in the SSM console. After five minutes or so, your instance will be ready, you can go find the IP address for SSH connections in the EC2 console.

Connect VSCode to devbox

Install the VSCode Remote SSH extension in VSCode, and then follow the docs for it.

The AMI in use is Ubuntu, when VSCode asks you for the SSH command, you'll want to use something similar to this:

ssh ubuntu@<ip> -i <full path to keypair pem file>

Window's users will need to use an absolute path to the key, with forward slashes C:/Users/sthulb/Downloads/key.pem.