Commit inicial - estructura base del proyecto

2026-05-31 08:24:12 -06:00
commit cd998ce6b0
143 changed files with 18354 additions and 0 deletions
@@ -0,0 +1,48 @@
+# Tooling
+
+All commands assume PowerShell from the project root.
+
+## Environment
+
+```powershell
+. .\.env.local.ps1
+```
+
+If no private env file is loaded, SSH still uses the local defaults from
+`scripts/ProxmoxAgent.ps1`. API calls require token env vars.
+
+## Smoke test
+
+```powershell
+.\scripts\Test-ProxmoxConnection.ps1
+```
+
+## Inventory
+
+```powershell
+.\scripts\Get-ProxmoxInventory.ps1
+```
+
+## SSH wrapper
+
+```powershell
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct list"
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "qm list"
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker ps -a"
+```
+
+## API from a PowerShell session
+
+```powershell
+. .\scripts\ProxmoxAgent.ps1
+Invoke-ProxmoxApi -Path "/version"
+Invoke-ProxmoxApi -Path "/nodes"
+Invoke-ProxmoxApi -Path "/cluster/resources"
+```
+
+## Commands that require confirmation
+
+- `pct start`, `pct shutdown`, `pct reboot`, `pct stop`, `pct destroy`
+- `qm start`, `qm shutdown`, `qm reboot`, `qm stop`, `qm destroy`
+- `docker restart`, `docker stop`, `docker rm`, `docker compose up/down`
+- package updates, firewall edits, network edits, storage edits