# 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 |