A Terraform project to stand up EC2 instance and configure it with Ansible.
Terraform will find the most up to date Ubuntu image and use that. An AWS security group is specified that allows ssh access from a specific address and allow all outgoing traffic.
Configure the project:
- Install Ansible, AWS CLI and Terraform
- Make a copy of example.terraform.tfvars and rename to terraform.tfvars
- Configure terraform.tfvars and variables.tf to your liking
- Make a copy of ansible/example.external_vars.yml and rename to ansible/external_vars.yml
- Add a Tailscale authentication key to ansible/external_vars.yml if you are starting Tailscale from the playbook. If no auth key is specified, Ansible will not start the service. (Take care with auth keys - https://tailscale.com/kb/1085/auth-keys/)
- Initialise the project with
terraform init
terraform init
terraform fmt
terraform validate
terraform apply
terraform show
terraform state list
terraform output
terraform destroy
Some useful links:
Install Terraform - https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started
Get Started - AWS - https://learn.hashicorp.com/collections/terraform/aws-get-started
Learn Terraform Resources - https://github.com/hashicorp/learn-terraform-resources
Define Infrastructure with Terraform Resources - https://learn.hashicorp.com/tutorials/terraform/resource?in=terraform/configuration-language
Configuration with Variables - https://learn.hashicorp.com/tutorials/terraform/variables?in=terraform/configuration-language
Sensitive Input Variables - https://learn.hashicorp.com/tutorials/terraform/sensitive-variables?in=terraform/configuration-language
http Data Source - https://registry.terraform.io/providers/hashicorp/http/latest/docs/data-sources/http
Provision Infrastructure with Cloud-Init - https://learn.hashicorp.com/tutorials/terraform/cloud-init?in=terraform/provision
Introduction to Vault - https://learn.hashicorp.com/tutorials/vault/getting-started-intro?in=vault/getting-started
aws_instance - https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/instance
describe-images - https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html
Ansible and Terraform - Better Together - https://github.com/scarolan/ansible-terraform
Check link for full details - https://docs.ansible.com/ansible/latest/index.html
Notes - https://leonsteenkamp.co.za/posts/halloansible/
Quick notes:
pip3 install --user ansible
Add PATH="$HOME/.local/bin:$PATH" to .bashrc
Check link for full details - https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-linux.html#cliv2-linux-install
Quick notes:
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
aws --version
aws configure
Check link for full details - https://learn.hashicorp.com/tutorials/terraform/install-cli
Quick notes:
sudo apt-get update && sudo apt-get install -y gnupg software-properties-common curl
curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"
sudo apt-get update && sudo apt-get install terraform
terraform -install-autocomplete
terraform -help