# Proxmox & Linstor HCI Automated Provisioning

This repository contains an Infrastructure as Code (IaC) pipeline to automatically bootstrap a Highly Available Proxmox Virtual Environment (PVE) cluster, with an optional High Availability Hyperconverged Linstor/DRBD storage stack.

## 🚀 Quick Start (For Beginners)

You do not need to install Ansible locally. This repository includes a DevContainer pre-configured with all necessary tools, linters, and extensions.

1. Install[Visual Studio Code](https://code.visualstudio.com/) and [Docker](https://docs.docker.com/get-docker/) (or [Podman](https://podman.io/)).
2. Install the VS Code[Dev Containers Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers).
3. Clone this repository and open the folder in VS Code.
4. Click **"Reopen in Container"** when prompted in the bottom right corner (or press `Ctrl+Shift+P` and type `Dev Containers: Reopen in Container`).
5. Proceed to the [Documentation](docs/01-prerequisites.md) to configure your cluster variables and run your first deployment.

## 📚 Documentation

Detailed documentation is available in the `docs/` directory. If you are new to Ansible or this stack, please read them in order:

*[01 - Prerequisites & Node Preparation](docs/01-prerequisites.md)
*[02 - Configuring the Cluster (Inventory & Vars)](docs/02-configuration.md)
* [03 - Running the Playbook](docs/03-execution.md)
* [04 - Architecture & Phase Breakdown](docs/04-architecture.md)
* [05 - Linstor & Storage Deep Dive](docs/05-linstor-storage.md)
* [06 - Troubleshooting & FAQ](docs/06-troubleshooting.md)