48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
# 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](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](.ansible-standards.md) for architectural requirements
|
|
- **Legacy Documentation:** Available in `archive/documentation/` for historical reference
|