Initial commit

README.md

@@ -0,0 +1,24 @@
+# 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)