01 - Prerequisites & Node Preparation

This documentation outlines the required state for bare-metal servers before executing the Ansible provisioning pipeline.

Node State

OS: Proxmox VE 8.x freshly installed.
Authentication: Root password known. SSH key exchange is handled automatically by Ansible.
Network: Static IPs assigned. If deploying Linstor, the management interface and Corosync/DRBD replication should ideally be physically separated. If utilizing a single NIC, QoS/traffic shaping must be handled at the switch level to prioritize Corosync UDP (5404/5405) over DRBD replication traffic.
Storage: Target block devices intended for Linstor raw LVM provisioning must contain no existing partition tables, LVM metadata, or filesystems.

Local Ansible installation is not required. This repository enforces the use of an isolated VS Code DevContainer.

Open this repository in Visual Studio Code.
Ensure Docker/Podman and the "Dev Containers" extension are installed.
Select Reopen in Container.
Open a terminal within VS Code. All paths referenced in this documentation originate from the ansible/ directory.

cd ansible/