Railshot

Railshot

AI deployment & operations platform

Een lokaal gebouwde webapp uitrollen naar voorbereide cloud- en on-premises-omgevingen en daarna laten draaien.

Een AI-platform voor uitrol en beheer dat een lokaal gebouwde webapp naar voorbereide cloud- of on-premises-omgevingen brengt en blijft laten draaien.

2026.09.28 tot 2026.10.04 · Afgerond

Teamproject · mijn aandeel: CI-planning en -implementatie, CSP-clusters en Ansible-interface, beheer, codereview en integratie in het team

SoftBank Hackathon 2026 powered by KOREC & ProgateDeelnemer voorronde · selectie voor de finale bekend op 2026.10.26 (stand 2026.10.07)

WebGeïmplementeerd · hackathon
MCP-serverGeïmplementeerd · remote · lokaal

Het webscherm en een eigen agent vragen de uitrol aan via dezelfde product-API.

Het product van een geaccepteerd uitrolverzoek, via CI-controles en het publiceren van images, tot Git-configuratie en Argo CD-uitrol op een geregistreerd doel en verificatie van de publieke HTTPS. Succes wordt alleen vastgelegd met zowel een toegepaste revisie als een publieke controle; een uitkomst die niet bekend kan zijn, blijft unknown.

Een project wordt ingediend via het webscherm, of vanuit een eigen AI-agent die via MCP is verbonden, en doorloopt het voorbereiden van uitrolbestanden, het herstellen van fouten, het publiceren van images, de uitrol naar de omgeving en de verificatie van de publieke URL; na de uitrol toont hetzelfde scherm geschiedenis en logs en beheert het updates, stops, hervattingen en verwijdering. Een teamproject.

Ontwikkelperiode van het evenement van September 28, 2026 tot October 4, 2026

Het webscherm en de MCP-server die tijdens de hackathon zijn gebouwd. De remote MCP logt in met OAuth om in te dienen; lokale mappen worden via de lokale MCP ingediend.

Productarchitectuur · getekend op basis van de codepaden in publieke commit 645e28a

Indienen → accepteren

Het webscherm, de remote MCP en de lokale MCP roepen dezelfde product-API aan, die een gecontroleerd verzoek als queued vastlegt en met 202 antwoordt.

Browsergebruikergegevens: map · ZIP · GitHub-URLwebscherm · geschiedenis · Insightsapps/dashboard
De bron en een geregistreerde omgeving worden in het webscherm gekozen.
webscherm · geschiedenis · Insightsapps/dashboardgegevens: dezelfde product-API · /api/v1valideren · doel · 202-acceptatieapps/api
Het webscherm roept de product-API aan vanaf dezelfde origin.
MCP-clientgegevens: OAuth · deploy_repositoryOAuth MCP · deploy_repositoryagent/remote-mcp.js
De remote MCP verbindt via OAuth en neemt een publieke GitHub-repository als input.
OAuth MCP · deploy_repositoryagent/remote-mcp.jsgegevens: dezelfde product-APIvalideren · doel · 202-acceptatieapps/api
De remote MCP-server roept dezelfde uitrol-API aan via zijn interne API-client.
railshot-local MCPgegevens: ZIP-upload · deploy_local_projectvalideren · doel · 202-acceptatieapps/api
De stdio-MCP op de computer van de gebruiker zipt een map en uploadt die. De sessie wordt niet gedeeld met de remote OAuth-sessie.
valideren · doel · 202-acceptatieapps/apigegevens: vastgelegd als queued · 202operationtoestand · runkoppelingapi/product-store.js
Input, geregistreerd doel, capaciteit en idempotentiesleutel worden gecontroleerd; de operation wordt als queued vastgelegd en beantwoord met 202. Een 202 betekent geaccepteerd, niet uitgerold.
operationtoestand · runkoppelingapi/product-store.jsgegevens: volgorde in de queueuitrolqueue · 3 tegelijkapps/api
Opgepakt in volgorde van acceptatie, binnen de limiet voor gelijktijdige uitrol (standaard 3).
operationtoestand · runkoppelingapi/product-store.jsobservatie: uitroltoestand · geschiedeniswebscherm · geschiedenis · Insightsapps/dashboard
Het webscherm en de MCP-tools lezen dezelfde operationvastleggingen. De laatste poging en de huidige geverifieerde uitrol worden apart getoond, en een voltooide AI-taak is geen uitrolsucces.

CI-controles → image publiceren

Vastgezette platformcode controleert de ingediende commit, geeft alleen herstelbare fouten aan AI en publiceert alleen images die dezelfde controles opnieuw doorstonden.

uitrolqueue · 3 tegelijkapps/apigegevens: source commitbroncommit · trailersapps/<tenant>/<app>
De ingediende bron wordt een commit in de private apps-repository (met de trailers Railshot-Request en Railshot-Target), en de branch wordt zonder force bijgewerkt.
uitrolqueue · 3 tegelijkapps/apiuitvoeren · toepassen: workflow_dispatchloop · basiscontroles L0–L3railshot-deploy.yml
Vraagt een run aan met tenant, app, source_commit en target_id. Gaat het antwoord verloren, dan wordt het niet opnieuw verstuurd; in plaats daarvan worden de runs voor dezelfde commit gezocht.
broncommit · trailersapps/<tenant>/<app>gegevens: ingediende commitloop · basiscontroles L0–L3railshot-deploy.yml
Alleen de ingediende commit en vastgezette platformcode (PLATFORM_REF) worden uitgecheckt.
SDK-reparatie · alleen herstelbare foutenrailshot-deploy.ymlgegevens: herstelverzoek · voorwaardelijkAI SDK provider
Wordt alleen aangeroepen voor herstelbare foutklassen en stopt wanneer dezelfde fout zich herhaalt of de pogingslimiet is bereikt. Slagen of falen wordt bepaald door de controles, niet door het LLM.
release · GHCR-publicatie · koppelingrailshot-deploy.ymlgegevens: gecontroleerde images publicerenGHCR
Na verificatie van de bundle die de controles doorstond, worden dezelfde images naar GHCR gepubliceerd. Er wordt niets opnieuw gebouwd.
CI-runkoppeling · observerenapps/apiobservatie: run · publicatie lezenrailshot-deploy.yml
Een publicatie telt alleen als run-id, broncommit, doel en app overeenkomen met de geaccepteerde vastlegging.
CI-runkoppeling · observerenapps/apimislukking · onbekende uitkomst: failed · publication_unverifiedoperationtoestand · runkoppelingapi/product-store.js
Een CI-fout of een niet-geverifieerde publicatie wordt met diagnostiek vastgelegd en niet aan CD doorgegeven.

Toepassen → publieke controle

Past alleen toe via config-Git en Argo CD als de publicatie overeenkomt met het geregistreerde doel, en legt pas succes vast nadat het geregistreerde publieke HTTPS-adres de controle doorstaat.

release · GHCR-publicatie · koppelingrailshot-deploy.ymlgegevens: images.json · spec · verdict · manifestcd.js · deployPublishedapps/api
CD leest de bestanden van de publicatievastlegging via een vertrouwde loader. CI zelf maakt geen clusterresource, URL of uitrolsucces aan.
cd.js · deployPublishedapps/apiuitvoeren · toepassen: apply · geregistreerd doelvertrouwde config · geregistreerd doelgitops/bridge.py
Draait gitops/bridge.py met de vertrouwde config alleen als de geregistreerde app en tenant overeenkomen met de publicatievastlegging.
commit · push · remote teruglezengitops/bridge.pygegevens: workload commit · pushConfig-Git-repo
Commit alleen workload.json op het geregistreerde pad van een eigen branch, legt eerst de push-intentie vast, pusht en leest de remote revisie terug. Een onzekere push wordt niet herhaald.
Config-Git-repogegevens: revisionApplication · AppProject-controleArgo CD
De revisie van de configrepository waarnaar de Argo CD-Application wijst.
Argo-sync · observerengitops/bridge.pyuitvoeren · toepassen: sync · observerenApplication · AppProject-controleArgo CD
Vraagt een sync aan na controle van het AppProject; observeren leest alleen, zonder sync.
Application · AppProject-controleArgo CDuitvoeren · toepassen: toepassenworkload · ServiceK3s-appcluster
Past de workload toe op het geregistreerde doelcluster.
workload · ServiceK3s-appclustergegevens: image pull · digestGHCR
Haalt de gepubliceerde digest op. Een private GHCR heeft een eigen pull-credential nodig.
publieke HTTPS-probegitops/bridge.pyobservatie: HTTPS healthPublieke HTTPS-URL
Controleert alleen het door de operator geregistreerde HTTPS-health-adres, zonder redirects, op 200 (en de verwachte JSON indien ingesteld).
Publieke HTTPS-URLgegevens: publiek padworkload · ServiceK3s-appcluster
Het publieke pad (LB, NodePort, certificaat) verschilt per provider en geregistreerd doel.
cd.js · deployPublishedapps/apigegevens: succeeded · revision · URLoperationtoestand · runkoppelingapi/product-store.js
Alleen vastgelegd als succeeded met cd.deployed, een revisie, een geslaagde publieke HTTPS-controle, het tijdstip daarvan en een geldige URL.
cd.js · deployPublishedapps/apimislukking · onbekende uitkomst: unknown · reconciliatie nodigoperationtoestand · runkoppelingapi/product-store.js
Een uitkomst die niet bekend kan zijn, blijft unknown; dezelfde apply wordt niet opnieuw verstuurd en niet teruggedraaid.

Observatie · niet het oordeel

Metrics en probes bepalen geen uitrolsucces. Ontbrekende, verouderde en mislukte waarden worden getoond zoals ze zijn.

metrics observerapps/apiobservatie: PromQL-queryPrometheus
Leest up, probe_success en Pod-reeksen. Ontbrekende, verouderde of mislukte waarden worden in die toestand getoond en nooit 0 gemaakt.
Prometheusobservatie: scrape · probeworkload · ServiceK3s-appcluster
Exporter-scrape en HTTP-probe. Deze metrics worden niet gebruikt om uitrolsucces te bepalen.
operationtoestand · runkoppelingapi/product-store.jsobservatie: uitroltoestand · geschiedeniswebscherm · geschiedenis · Insightsapps/dashboard
Het webscherm en de MCP-tools lezen dezelfde operationvastleggingen. De laatste poging en de huidige geverifieerde uitrol worden apart getoond, en een voltooide AI-taak is geen uitrolsucces.
publieke HTTPS-probegitops/bridge.pyobservatie: HTTPS healthPublieke HTTPS-URL
Controleert alleen het door de operator geregistreerde HTTPS-health-adres, zonder redirects, op 200 (en de verwachte JSON indien ingesteld).

Alle verbindingen even zwaar. Kies een stroom om alleen het pad daarvan te markeren, met genummerde stappen.

Doorgetrokken · richting waarin bron, images en verzoeken stromen
Gestreept · runverzoek, toepassen of sync
Lange streep-punt · statusopvragingen, probes en metrics, los van het oordeel
Kort gestreept · een vastgelegde mislukking of onbekende uitkomst
Dikke zwarte lijn · de gekozen stroom; nummers geven de volgorde
Vak · een eigendomsgrens, met het bronpad in de kop
Binnenchip · een component binnen die grens
Gestreept vak · buiten het platform
Oranje omlijning · waar een model beslist

Product-API
Uitrolvastleggingen
CD-uitvoeringsgrens
Instap · CI · doel

Het beeld van October 2 (bc61a5a) in docs/architecture/README.md is implementatiegeschiedenis; deze architectuur volgt de code van 645e28a. Providers en netwerkpaden verschillen per geregistreerd doel, en dit betekent niet dat elke provider altijd aan staat.

Railshot vocabulary

Indienen → accepteren

CI-controles → image publiceren

Toepassen → publieke controle

Observatie · niet het oordeel