Actualiza toolkit operativo y documentación

This commit is contained in:
urieljareth
2026-09-10 20:53:50 -06:00
parent 3b7209dcc1
commit 714057bfc8
69 changed files with 6023 additions and 384 deletions
+17 -8
View File
@@ -4,18 +4,27 @@ Use this project-local skill when helping manage the local Proxmox host.
## Scope
- Host: `192.168.0.200`
- Host: `192.168.0.200`, Proxmox VE `9.1.1`, single node
- Node: `thinkcentre`
- Main Docker LXC: `102` (`coolify`)
- Secondary LXC currently observed: `100` (`hermes`)
- Access methods: SSH first, Proxmox REST API when token env vars are present.
- Main Docker LXC: `102` (`coolify`) — **running**, 68 containers
- Secondary LXC: `100` (`hermes`) — **running** (commit `5d3c15aaa`, MiniMax-M3, IPs: `192.168.3.23` / `192.168.3.15`)
- No QEMU VMs
- Access methods: SSH first, Proxmox REST API when token env vars are present
(they are **not** loaded today — see [`TOOLS.md`](TOOLS.md))
## Startup routine
1. Read `README.md`, `docs/proxmox-inventory.md`, and the relevant runbook.
2. Run `.\scripts\Test-ProxmoxConnection.ps1` before operational work.
3. For fresh state, run `.\scripts\Get-ProxmoxInventory.ps1`.
4. Prefer `.\scripts\Invoke-ProxmoxSsh.ps1 -Command "<command>"` for remote commands.
1. Load secrets: `. .\.env.local.ps1`.
2. Read [`docs/TOOL-INDEX.md`](../docs/TOOL-INDEX.md) — the canonical tool
catalog. **Its §1 lists four gotchas that produce silently wrong results.**
The one that bites hardest here: `Invoke-ProxmoxSsh.ps1` mangles nested
quotes, so anything with two levels of quoting needs base64 (see
[`TOOLS.md`](TOOLS.md)).
3. Read [`docs/proxmox-inventory.md`](../docs/proxmox-inventory.md) for current
state, plus the relevant runbook in `docs/runbooks/`.
4. Run `.\scripts\Test-ProxmoxConnection.ps1` before operational work.
5. For fresh state, run `.\scripts\Get-ProxmoxInventory.ps1`.
6. Prefer `.\scripts\Invoke-ProxmoxSsh.ps1 -Command "<command>"` for remote commands.
## Safety policy