Documentation and configuration-as-code for the little homelab I've been tinkering with.
Terraform and Ansible are probably overkill for this project, but they're commonly used tools and they more or less match my use case 🤷.
$ virtualenv -p /usr/bin/python3 venv
$ source venv/bin/activate
$ pip install -r requirements.txt
Installing Terraform is generally just downloading a binary
Copy the ./terraform/terraform.tfvars.example file to ./terraform/terraform.tfvars and put in your do_token and ssh_fingerprint
Terraform in particular is way overkill for this project. I'm currently using it to spin up a single droplet 🙃.
It's also surprisingly difficult to interface with ansible, so for the moment, I've got a bit of a hacky solution to that.
After installation:
$ cd terraform
$ terraform init
$ terraform apply
You must have a public key for root access to the DO droplet at ~/.ssh/id_rsa_ec.pub
To install the requisite roles and collections:
$ cd ansible
$ ansible-galaxy install -r roles_requirements.yml
$ ansible-galaxy collection install -r collections_requirements.yml
To run all tasks in the main.yml playbook
$ ansible-playbook -i inventory main.yml
$ ansible-playbook -i inventory --tags users main.yml
Ansible will currently setup a wireguard server on the DO droplet and add a wireguard client configuration to the local machine at ~/wg0.conf.
To bring that wireguard connection up you can then:
$ sudo wg-quick up ~/wg0.conf