This repository contains infrastructure automation tools and configurations for managing homelab infrastructure.

• ansible/ - Ansible playbooks, roles, and inventory for infrastructure provisioning
• .taskfiles/ - Task automation using Taskfile

• Ansible >= 2.9
• Python >= 3.8
• Task (for automation tasks)
• 1Password CLI (for secret management)

1. Configure variables in:
   • ansible/files/host_config/<hostname>.yml for host-specific variables
   • ansible/files/group_config/<groupname>.yml for group variables
2. Generate inventory variables: task ansible:generate-config
3. Run playbooks as needed (see ansible/README.md)

• Storage Backup - Automated BTRFS snapshot backup to S3-compatible storage using restic
  • See ansible/playbooks/storage/backup/

View available tasks:

task --list

This repository uses 1Password for secret management. Sensitive values are stored as references in the format:

password: op://vault/item/field

The task ansible:generate-config command resolves these references using the 1Password CLI before generating the actual inventory files.

See Secret Reference Syntax for more details.