# 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