37 lines
1.1 KiB
Markdown
37 lines
1.1 KiB
Markdown
|
# Services — Configuration & Runbook Index
|
||
|
|
|
||
|
|
This directory documents all services operated by the Daystrom Institute. Each subdirectory contains deployment configuration notes, dependency maps, and links to operational runbooks.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Service Catalog
|
||
|
|
|
||
|
|
| Service Name | Stack | Host(s) | Runbook | Status |
|
||
|
|
|--------------|-------|---------|---------|--------|
|
||
|
|
| `<!-- service -->` | `<!-- stack -->` | `<!-- host -->` | [Runbook](<!-- link -->) | `<!-- status -->` |
|
||
|
|
|
||
|
|
> **Note:** Replace placeholder rows with actual service entries.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Directory Layout (per service)
|
||
|
|
|
||
|
|
```
|
||
|
|
services/<service-name>/
|
||
|
|
├── README.md ← Overview, ports, dependencies
|
||
|
|
├── config/ ← Non-secret configuration files or excerpts
|
||
|
|
└── runbook.md ← Operational procedures (link or inline)
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Standards
|
||
|
|
|
||
|
|
- Document all exposed ports and upstream dependencies.
|
||
|
|
- Reference the canonical runbook from `runbooks/` rather than duplicating procedures.
|
||
|
|
- Mark services under active change with `⚠ IN FLUX` in the Status column.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
*Directory last reviewed: <!-- date -->*
|