32 lines
788 B
Markdown
32 lines
788 B
Markdown
|
---
|
||
|
|
okf: "0.1"
|
||
|
|
type: runbook
|
||
|
|
visibility: private
|
||
|
|
status: active
|
||
|
|
updated: 2026-05-11
|
||
|
|
links:
|
||
|
|
- ../subsystems/service-lifecycle.md
|
||
|
|
---
|
||
|
|
|
||
|
|
# Serwisy — operational recovery
|
||
|
|
|
||
|
|
## Operational Recovery
|
||
|
|
|
||
|
|
### 1. Container Failure
|
||
|
|
If a service is unhealthy:
|
||
|
|
- Check `docker compose logs`.
|
||
|
|
- Restart: `docker compose restart`.
|
||
|
|
- Recreate: `docker compose up -d --force-recreate`.
|
||
|
|
|
||
|
|
### 2. Node Failure
|
||
|
|
If a host node fails:
|
||
|
|
- Services with `owner_node` matching the failed node must be recovered on a backup node or the node must be restored.
|
||
|
|
- Persistence data must be restored from backups to `/opt/homelab/data/<service>`.
|
||
|
|
|
||
|
|
### 3. Dependency Recovery
|
||
|
|
If a dependency fails:
|
||
|
|
- Services depending on it might report unhealthy status.
|
||
|
|
- Recover the dependency first.
|
||
|
|
- Re-verify dependent services.
|
||
|
|
|