25 lines
1.6 KiB
Markdown
25 lines
1.6 KiB
Markdown
# 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)
|