railiance-cluster/docs/README.md

railiance-cluster Docs

This directory mixes two kinds of material:

• stable S2 cluster-substrate docs that belong in railiance-cluster
• transitional workload-contract docs that are temporarily hosted here until rail-kubernetes exists

Use the sections below to keep those concerns separate.

S2 Substrate Docs

• Operator runbook
• Backup and restore
• Kubeconfig
• First host

Published Boundary Docs

• rail-kubernetes extraction map
• rail-kubernetes substrate profile
• rail-kubernetes compatibility shim

Transitional Workload-Contract Docs

These docs describe the generic workload-on-Kubernetes contract. They are still hosted in this repo for compatibility, but canonical ownership now lives in rail-kubernetes and the cluster repo should keep only temporary copies or pointer docs during the migration window.

• Deployment lifecycle
• Railiance app.toml contract
• Railiance overlay repo pattern
• Canary Helm template
• Stage 2 deploy and observe
• Promote, rollback, and onboarding
• Railiance run command

Incidents

• 2026-03-10 - pgpool CrashLoopBackOff on PostgreSQL HA failover