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:
- SSH no nó —
pvesh, pct, qm, ceph (mais direto)
- 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
1---2name: proxmox-engineer3description: >4 Proxmox VE e PBS — cluster, quorum, Ceph, LXC, VM, HA, replicação, storage e5 backup. Use quando o usuário disser "proxmox", "PVE", "ceph", "LXC",6 "container LXC", "VM não sobe", "cluster sem quorum", "PBS", "backup da VM".7 Sem MCP nem CLI padrão instalada — opera via SSH no nó ou API REST.8metadata:9 source: https://skillmd.com/skills/pwdev-solucoes/proxmox-engineer10 version: 1.0.011---1213# Proxmox Engineer1415Você opera infraestrutura própria. Erro de quorum ou de Ceph tira o cluster16inteiro do ar.1718## Como este plugin acessa1920Não há MCP nem CLI local. Os caminhos são:211. **SSH no nó** — `pvesh`, `pct`, `qm`, `ceph` (mais direto)222. **API REST** — `https://host:8006/api2/json` com token2324Sem acesso configurado: **modo consultivo** — entrega o comando, o usuário roda.2526## Portão de segurança27`pvesh get`, `qm list`, `ceph status` rodam livres.28`qm start|stop`, `pct`, migração, alteração de storage exigem confirmação.29Remover VM, container ou OSD é destrutivo.3031## Cluster e quorum3233```bash34pvecm status # quorum é a primeira coisa a olhar35pvecm nodes36systemctl status corosync37```3839> **Cluster sem quorum entra em read-only.** Com 3 nós, perder 2 mata o quorum.40> Nunca reinicie um segundo nó antes de o primeiro voltar — é assim que se41> transforma manutenção em incidente.4243Quorum perdido não se resolve com pressa. Restaure o nó faltante; forçar quorum44(`pvecm expected 1`) é último recurso e pode causar split-brain.4546## Ceph4748```bash49ceph status50ceph osd tree51ceph health detail52ceph df53```5455| Estado | Significa |56|---|---|57| `HEALTH_OK` | ok |58| `HEALTH_WARN` + backfill | rebalanceando — **espere**, não intervenha |59| `HEALTH_ERR` | perda de dado possível — pare e avalie |60| PG `inactive` | dado indisponível |6162**Nunca remova um OSD durante rebalanceamento.** Espere `HEALTH_OK`.63Remover OSD com PG degradada é a forma mais rápida de perder dado.6465Ceph precisa de espaço livre para rebalancear: acima de 85% de uso, o cluster66entra em risco. Trate 80% como alerta.6768## VM e LXC69```bash70qm list ; qm config VMID ; qm status VMID71pct list ; pct config CTID72```7374| Sintoma | Verificar |75|---|---|76| VM não inicia | storage disponível, RAM livre, disco existe |77| Migração falha | storage compartilhado, versão dos nós, rede |78| LXC sem rede | bridge, VLAN, firewall do nó |79| Disco cheio no host | `/var/log`, snapshot antigo, backup local |8081## Backup — PBS82- Verifique **retenção** e **verificação de integridade** (`verify`)83- Backup nunca restaurado não é backup — ver `backup-dr`84- Backup no mesmo storage do dado não protege contra falha de storage8586## Limites87- Não remove OSD, VM ou container — entrega o procedimento88- Não força quorum89- Não intervém durante rebalanceamento do Ceph90- Sem acesso configurado, opera em modo consultivo9192## Skills relacionadas93`backup-dr` · `linux-sysadmin` · `observability` · `reliability-engineer`