k3d-dev-up

Deploy k3d dev environment to AWS, including:

• creating an ec2 security group
• creating a private key
• creating a local .pem file
• creating an ec2 keypair
• creating an ec2 instance
• creating a k3d cluster on the instance
• installing Big Bang's flux on the k3d cluster
• copying the cluster's kubeconfig to your local machine

Prerequisites

• aws cli
• terraform
• kubectl

Shell commands used:

• scp - to copy the remote kubeconfig to local machine
• sed - to update the kubeconfig's server IP

Instructions

1. Check for an existing AWS profile

aws configure list-profiles

2. If desired profile is not present, configure a profile

aws configure --profile <PROFILE_NAME>
# aws_access_key_id - The AWS access key part of your credentials
# aws_secret_access_key - The AWS secret access key part of your credentials
# region - us-gov-west-1
# output - json

3. Set variables in variables.yaml

# example
awsProfile: default
awsUsername: first.last
instanceType: t2.2xlarge
volumeSize: 50
k3dVersion: v4.4.7
registryUsername: first.last
registryPassword: abcd1234

4. Initialize terraform (first time only)

terraform init

5. Create infrastructure (kubeconfig is dumped into working directory as k3d.yaml)

terraform apply

6. Test cluster access (you should see some pods in the kube-system and flux-system namespaces)

kubectl --kubeconfig=./k3d.yaml get pods --all-namespaces

Cleanup

terraform destroy

Contributing

Please open an issue or PR if you'd like to see something changed.