ansible/project-docs/overview.md

Overview

This repository manages infrastructure automation using Ansible for:

• Development machines (dev)
• Desktop machines (desktop)
• Service hosts (services, qa, ansible, tailscale)
• Proxmox-managed guests for “app projects” (LXC-first, with a KVM path)

Primary entrypoint is the Makefile (Makefile) and playbooks under playbooks/.

Goals

• Predictable, repeatable provisioning of hosts and Proxmox guests
• Safe defaults: avoid destructive automation; prefer guardrails and idempotency
• Clear separation between server vs workstation responsibilities
• Secrets handled via Ansible Vault (never commit plaintext credentials)

Non-goals

• Automated decommission/destroy playbooks for infrastructure or guests
• Managing interactive IDE/editor installs (kept out of Ansible by design)

Target users

• You (and collaborators) operating a small homelab / Proxmox environment
• Contributors extending roles/playbooks in a consistent style