coulomb/rail-kubernetes
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Railiance support for kubernetes workloads
20 commits 1 branch 0 tags 156 KiB
Find a file
custodian-sync 0184697dc1 chore(consistency): sync task status from DB [auto] 
Updated by fix-consistency on 2026-08-22:
  - update .custodian-brief.md for rail-kubernetes

Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a02669-87ee-7a31-b111-edc95a16e0fa
2026-08-22 12:38:22 +02:00
bin Import rail-kubernetes lifecycle tooling 2026-07-26 02:10:05 +02:00
declarations Version the common and derived rail contract 2026-07-26 13:34:56 +02:00
docs Enforce private-by-default rail exposure 2026-08-22 12:34:25 +02:00
examples Version the common and derived rail contract 2026-07-26 13:34:56 +02:00
schemas Version the common and derived rail contract 2026-07-26 13:34:56 +02:00
tests Enforce private-by-default rail exposure 2026-08-22 12:34:25 +02:00
tools Enforce private-by-default rail exposure 2026-08-22 12:34:25 +02:00
workplans Enforce private-by-default rail exposure 2026-08-22 12:34:25 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-08-22 12:38:22 +02:00
.gitignore Bootstrap the first rail-kubernetes repo 2026-07-25 18:57:55 +02:00
.repo-classification.yaml Bootstrap the first rail-kubernetes repo 2026-07-25 18:57:55 +02:00
AGENTS.md Bootstrap the first rail-kubernetes repo 2026-07-25 18:57:55 +02:00
CLAUDE.md Bootstrap the first rail-kubernetes repo 2026-07-25 18:57:55 +02:00
INTENT.md Bootstrap the first rail-kubernetes repo 2026-07-25 18:57:55 +02:00
LICENSE Adopt Target Revenue Source License V1C1 (org-wide preliminary rollout) 2026-07-30 00:47:53 +02:00
README.md Finish rail-kubernetes bootstrap handoff 2026-07-26 02:20:00 +02:00
SCOPE.md Finish rail-kubernetes bootstrap handoff 2026-07-26 02:20:00 +02:00
WORK-RECORDS.md Version the common and derived rail contract 2026-07-26 13:34:56 +02:00

README.md

rail-kubernetes

Wave-1 execution rail for Railiance-managed workloads on Kubernetes.

Purpose

rail-kubernetes is the default base rail for the current Railiance ecosystem. It owns the generic workload-on-Kubernetes execution contract that should no longer stay mixed into railiance-cluster.

This repo exists to hold:

  • the Kubernetes rail declaration
  • the generic workload lifecycle contract
  • the migration path from the current railiance-cluster compatibility surface
  • future rail-local tooling and docs for Railiance-managed workloads on Kubernetes

Boundary

rail-kubernetes does not own:

  • k3s bootstrap
  • cluster-level operator ownership
  • cluster backup/restore posture
  • workload-specific wrappers that belong in rapp-* repos
  • substrate inventories that belong in reef-* repos

Those concerns stay with railiance-cluster, the relevant rapp-* repo, or the relevant reef-* repo.

Current Status

First-wave bootstrap is complete. The repo now owns the generic Kubernetes rail contract, tooling, and migration-window compatibility handoff from railiance-cluster.

The boundary and source material come from:

  • railiance-master/docs/rail-kubernetes-boundary.md
  • railiance-cluster/docs/rail-kubernetes-extraction-map.md
  • railiance-cluster/docs/rail-kubernetes-substrate-profile.md

Initial Layout

  • declarations/rail.yaml — source-controlled rail contract
  • bin/ — thin generic rail lifecycle entrypoints
  • docs/ — wave-1 contract and import plan
  • tools/ — rail-owned helper implementations and scaffolds
  • schemas/ — machine-readable workload contract schema
  • examples/ — canonical example workload declarations for the rail
  • workplans/ — repo-local execution work