feat: Add Proxmox LXC container provisioning playbook, related secrets, and documentation.

README.md

@@ -19,3 +19,31 @@ This Ansible setup is designed to automate the configuration and maintenance of
     ```bash
     ansible-playbook -i inventory/hosts.ini playbooks/apt_upgrade.yml
     ```
+
+## Proxmox Integration Setup
+
+To use the provisioning playbooks (`create_lxc.yml`), you must configure Proxmox API access.
+
+### 1. Requirements on Control Node
+Install `community.general` collection:
+```bash
+ansible-galaxy collection install community.general
+```
+
+### 2. Create Proxmox User & Token
+1.  **Create User**: In Proxmox, go to **Datacenter > Permissions > Users** and add `ansible@pve` (Proxmox VE authentication).
+2.  **Create Token**: Go to **API Tokens**, add a token for `ansible@pve` (e.g., `ansible-token`). **Save the Secret!**
+3.  **Permissions**: Go to **Permissions**, add User Permission for `ansible@pve`:
+    -   Path: `/`
+    -   Role: `Administrator` (or a custom role with VM/CT creation privileges).
+
+### 3. Configure Secrets
+Update your `secrets.yml` (do not commit this file!) with the credentials:
+
+```yaml
+proxmox_api_user: "ansible@pve"
+proxmox_api_token_id: "ansible-token"
+proxmox_api_token_secret: "YOUR_SECRET_HERE"
+proxmox_node: "proxmox"
+proxmox_storage: "local"
+```