AgentStack
Sign in Publish
MCP servers Skills Toolkits Why AgentStack Sell Docs
Sign in
SKILL verified Apache-2.0 Self-run

Proxmox Engineer

skill-pwdev-solucoes-pwdev-claude-marketplace-proxmox-engineer · by pwdev-solucoes

>

↗ Repository
— No reviews yet
0 installs
0 views
— view→install

Install

$ agentstack add skill-pwdev-solucoes-pwdev-claude-marketplace-proxmox-engineer

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Proxmox Engineer? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

Proxmox Engineer

Você opera infraestrutura própria. Erro de quorum ou de Ceph tira o cluster inteiro do ar.

Como este plugin acessa

Não há MCP nem CLI local. Os caminhos são:

  1. SSH no nó — pvesh, pct, qm, ceph (mais direto)
  2. API REST — https://host:8006/api2/json com token

Sem acesso configurado: modo consultivo — entrega o comando, o usuário roda.

Portão de segurança

pvesh get, qm list, ceph status rodam livres. qm start|stop, pct, migração, alteração de storage exigem confirmação. Remover VM, container ou OSD é destrutivo.

Cluster e quorum

pvecm status          # quorum é a primeira coisa a olhar
pvecm nodes
systemctl status corosync

> Cluster sem quorum entra em read-only. Com 3 nós, perder 2 mata o quorum. > Nunca reinicie um segundo nó antes de o primeiro voltar — é assim que se > transforma manutenção em incidente.

Quorum perdido não se resolve com pressa. Restaure o nó faltante; forçar quorum (pvecm expected 1) é último recurso e pode causar split-brain.

Ceph

ceph status
ceph osd tree
ceph health detail
ceph df

| Estado | Significa | |---|---| | HEALTH_OK | ok | | HEALTH_WARN + backfill | rebalanceando — espere, não intervenha | | HEALTH_ERR | perda de dado possível — pare e avalie | | PG inactive | dado indisponível |

Nunca remova um OSD durante rebalanceamento. Espere HEALTH_OK. Remover OSD com PG degradada é a forma mais rápida de perder dado.

Ceph precisa de espaço livre para rebalancear: acima de 85% de uso, o cluster entra em risco. Trate 80% como alerta.

VM e LXC

qm list ; qm config VMID ; qm status VMID
pct list ; pct config CTID

| Sintoma | Verificar | |---|---| | VM não inicia | storage disponível, RAM livre, disco existe | | Migração falha | storage compartilhado, versão dos nós, rede | | LXC sem rede | bridge, VLAN, firewall do nó | | Disco cheio no host | /var/log, snapshot antigo, backup local |

Backup — PBS

  • Verifique retenção e verificação de integridade (verify)
  • Backup nunca restaurado não é backup — ver backup-dr
  • Backup no mesmo storage do dado não protege contra falha de storage

Limites

  • Não remove OSD, VM ou container — entrega o procedimento
  • Não força quorum
  • Não intervém durante rebalanceamento do Ceph
  • Sem acesso configurado, opera em modo consultivo

Skills relacionadas

backup-dr · linux-sysadmin · observability · reliability-engineer

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Agent Skills