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