Consolidate co-op/runbooks into co-op/ops-docs
Absorbs the Cloudron server-migration material from co-op/runbooks (now archived) so there is a single public operator documentation repository. Files move into migration/ (plan, DNS change sheet, pre-migration state) and provider-pricing/ is kept as its own section; the merged README replaces both. History is preserved: this is a merge of the unrelated histories, so co-op/runbooks' 26 commits remain reachable from this repository and git log -- migration/ shows their real authors and messages. File contents are byte-identical to co-op/runbooks (blob hashes unchanged).
This commit is contained in:
commit
11b10e2b03
5 files changed
+984
-7
No files matched your search
@@ -2,9 +2,12 @@
|
||||
|
||||
Operator- and maintainer-facing documentation for the Inference Cooperative.
|
||||
This is the material that describes how the co-op's infrastructure is run —
|
||||
access tokens, scheduled tasks, maintenance procedures, and outage write-ups —
|
||||
as opposed to the member-facing documentation published at
|
||||
<https://docs.inference.coop/>.
|
||||
access tokens, scheduled tasks, maintenance procedures, outage write-ups, and
|
||||
the server-migration record — as opposed to the member-facing documentation
|
||||
published at <https://docs.inference.coop/>.
|
||||
|
||||
Anyone may read it; operators are the audience. Comment, or open an issue,
|
||||
where something looks wrong — that review is the point.
|
||||
|
||||
## This repository is deliberately not a website
|
||||
|
||||
@@ -24,16 +27,47 @@ Read it on the web here: <https://git.inference.coop/co-op/ops-docs>
|
||||
| `maintenance/chat-task-models.md` | The small pinned model used for chat titles/tags/suggestions |
|
||||
| `maintenance/librechat-sandbox.md` | Operating the LibreChat evaluation instance (config, overlay image, key sync, pitfalls) |
|
||||
| `incidents/` | Post-incident write-ups, one file per incident |
|
||||
| `migration/` | The Cloudron server-migration record: the plan, the DNS change sheet, and the captured pre-migration state |
|
||||
| `provider-pricing/` | What our model providers charge, and when it changed |
|
||||
|
||||
## The migration material
|
||||
|
||||
`migration/` holds the record of moving Cloudron to its new server: the plan
|
||||
([`cloudron-server-migration.md`](migration/cloudron-server-migration.md)),
|
||||
the record-by-record cutover sheet
|
||||
([`dns-change-sheet.md`](migration/dns-change-sheet.md)), and the captured
|
||||
pre-migration state the restore checker compares against
|
||||
([`migration-before-state.json`](migration/migration-before-state.json)).
|
||||
|
||||
**The migration is complete (2026-11-02)** — this material is kept as the
|
||||
record of how it was planned and done, not as pending work. Current
|
||||
operational procedure lives in the co-op's `cloudron-ops` skill; the
|
||||
member-facing description lives in `co-op/docs/infrastructure.md`.
|
||||
|
||||
### Read the DNS sheet with this in mind
|
||||
|
||||
Its record counts **cannot be trusted until reconciled against the registrar's
|
||||
panel.** The zone is wildcarded, so *any* hostname resolves — a name that
|
||||
answers proves nothing about whether a record exists. At least two listed
|
||||
records turned out not to exist, and the real record inventory is only visible
|
||||
in the registrar's own list.
|
||||
|
||||
## No secrets here
|
||||
|
||||
Audited 2026-11-01, including the full commit history: no credentials, tokens,
|
||||
keys, member emails or account identifiers. Where a runbook needs a credential
|
||||
to exist (a backup passphrase, an S3 key), it records **where the credential is
|
||||
held**, never the credential.
|
||||
|
||||
## Where operators look
|
||||
|
||||
- **Member-facing docs** live in [`co-op/docs`](https://git.inference.coop/co-op/docs)
|
||||
and are published at <https://docs.inference.coop/>.
|
||||
- **Migration runbooks** live in [`co-op/runbooks`](https://git.inference.coop/co-op/runbooks).
|
||||
- The member-facing docs link here from their "For operators" section.
|
||||
|
||||
## History
|
||||
|
||||
These files were moved here from `co-op/docs`, where they were previously
|
||||
published on the member-facing site. The commit history for each file is
|
||||
preserved in this repository.
|
||||
The operator runbook, maintenance pages and incident write-ups were moved here
|
||||
from `co-op/docs`, where they were previously published on the member-facing
|
||||
site. The migration material came from `co-op/runbooks` (now archived), and was
|
||||
brought across with its commit history intact via an unrelated-histories merge.
|
||||
Reference in new issue
Block a user