coulomb/rail-kubernetes
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Railiance support for kubernetes workloads
17 commits 1 branch 0 tags 156 KiB
Find a file
codex 3355e9c002 Adopt Target Revenue Source License V1C1 (org-wide preliminary rollout) 
Maintainer decision, 2026-07-29: adopts TRSL V1C1 as this repo's
preliminary governing license, per target-revenue's
workplans/TREV-WP-0008-governance-and-pilot-rollout.md T05. Full
specialist legal review is deferred until out of beta (target-revenue
SCOPE.md §1). No Phase is yet declared for this repo.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-30 00:47:53 +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 Finish rail-kubernetes bootstrap handoff 2026-07-26 02:20:00 +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
tools Version the common and derived rail contract 2026-07-26 13:34:56 +02:00
workplans Version the common and derived rail contract 2026-07-26 13:34:56 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-07-26 13:08:25 +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