ansible-playbooks

This project contains a collection of Ansible playbooks I use or have used in my homelab.

Playbooks

homelab

Provisioning and management of homelab resources

Pre-requisites:

• SSH keypair for your local client to server interactions
• ansible-galaxy collection install ansible.posix
• export USER_PASSWORD='your_secure_password' for user creation
• pip install passlib to allow password hashing in users role

ssh-keygen -t ecdsa -b 521 -f ~/.ssh/id_ecdsa -C "[email protected]"

• SSH keypair for your GitHub interactions

ssh-keygen -t ecdsa -b 521 -f ~/.ssh/id_github -C "[email protected]"

Preparation:

• Populate hosts.yml file with hosts by group
• Populate hosts.yml file with desired variable values

Dry run:

ansible-playbook -i hosts.yml main.yml --check

Provision one host:

ansible-playbook -i hosts.yml main.yml --limit photos

Provision all hosts with:

ansible-playbook -i hosts.yml main.yml

Update all hosts:

ansible-playbook -i hosts.yml main.yml --tags update

Operation

• Update system
• Install packages
• Setup users (create + keys)
• Setup shell (spaceship + chezmoi)
• Install docker (when)
• Setup github_clone (when)

k8s-cluster

Creating a Kubernetes cluster using Rocky Linux 8.

k8s-proxmox

Creating a kubernetes cluster where one or more nodes are LXC containers in Proxmox

Troubleshooting

Test a configuration of a single host:

ansible -i hosts.yml frigate -m ping

Show what changes on one or more hosts:

ansible-playbook -i hosts.yml main.yml --check --diff --limit paperless,lancache,micropop

License

Distributed under the MIT License. See LICENSE for more information.