Nathan
ac6e68e301
Complete role documentation suite per Ansible Galaxy and homelab standards: - Add role README.md with variable tables, usage examples, and deployment notes - Add meta/main.yml for Galaxy metadata and collection dependencies - Add OPENAPPLY-VAULT-REFERENCE.md with vault setup and Proxmox token guide - Add OPENAPPLY-IMPLEMENTATION-REPORT.md with architecture, validation, and handoff details Context: Completes the OpenApply LXC deployment implementation from session plan. This documentation enables users to configure vault secrets, understand role variables, and execute the two-tier Proxmox provisioning workflow. Ref: Session plan at /memories/session/plan.md (Phases 1-6 complete)
Ansible Infrastructure Automation
This directory contains the Ansible automation framework for homelab infrastructure management.
📁 Directory Structure
ansible/
├── .ansible-lint # Linting rules (enforces safety & best practices)
├── .ansible-standards.md # Architectural standards and conventions
├── DEVELOPMENT-SETUP.md # Control node setup requirements
├── README.md # This file
└── archive/ # ⚠️ REFERENCE ONLY - Legacy implementation
⚠️ Important: Archive Directory
The archive/ directory contains the previous iteration of the Ansible infrastructure.
- Purpose: Reference and migration source only
- Status: Not actively maintained
- Action: Do NOT execute playbooks or use configurations directly from
archive/ - Migration Status: In progress - components are being refactored into the new structure
🚀 Getting Started
Prerequisites
Refer to DEVELOPMENT-SETUP.md for:
- Required CLI tools (ansible-core, ansible-lint, proxmoxer)
- VSCode extensions (recommended for development)
- SSH key generation and vault configuration
Control Node Setup
Watchtower (10.0.0.200) is the designated Ansible control node for this lab.
📚 Additional Resources
- Standards: See .ansible-standards.md for architectural requirements
- Legacy Documentation: Available in
archive/documentation/for historical reference