tegwick
b1aac08eb2
Seed a non-secret service inventory (environments, hosts, clusters, services, endpoints, access paths, evidence, gaps) with a JSON schema, a renderer, and a generated service-catalog view. Adds the `make ops-inventory-view` target, probe ActivityDefinition, and docs. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
38 lines
1.2 KiB
Markdown
38 lines
1.2 KiB
Markdown
# Ops Documentation
|
|
|
|
Operational runbooks and incident reports for the Railiance/Custodian infrastructure.
|
|
|
|
## Structure
|
|
|
|
```
|
|
ops/
|
|
service-inventory.yml — non-secret service/location/evidence seed for ops-hub
|
|
runbooks/ — how-to guides for recurring operational tasks and known issues
|
|
incidents/ — post-incident reports (append-only, one file per incident)
|
|
```
|
|
|
|
## Inventory
|
|
|
|
| Artifact | Covers |
|
|
|----------|--------|
|
|
| [service-inventory.yml](service-inventory.yml) | Initial ops-hub service inventory: environments, hosts, clusters, services, endpoints, access paths, evidence, and gaps |
|
|
| [../docs/ops-hub-service-catalog.md](../docs/ops-hub-service-catalog.md) | Rendered service catalog now view generated from the inventory |
|
|
|
|
Render the first catalog view with:
|
|
|
|
```bash
|
|
make ops-inventory-view
|
|
```
|
|
|
|
## Runbooks
|
|
|
|
| Runbook | Covers |
|
|
|---------|--------|
|
|
| [gitea-coulombcore.md](runbooks/gitea-coulombcore.md) | Gitea on COULOMBCORE k3s — access, known issues, recovery checklist |
|
|
|
|
## Incidents
|
|
|
|
| ID | Date | Summary | Status |
|
|
|----|------|---------|--------|
|
|
| [INC-001](incidents/2026-03-25-gitea-pgpool-crashloop.md) | 2026-03-25 | Gitea down 13d — PGPool containerd StartError + CPU exhaustion | Resolved |
|