SV
RAILSHOT.
Tillbaka till salen

Railshot

AI deployment & operations platform

Driftsätt en lokalt byggd webbapp i förberedda moln- och on-premises-miljöer och driv den sedan.

En AI-plattform för driftsättning och drift som tar en lokalt byggd webbapp till förberedda moln- eller on-premises-miljöer och håller den igång.

28 september 2026 till 4 oktober 2026 · Avslutat

Teamprojekt · min del: planering och implementation av CI, CSP-kluster och Ansible-gränssnitt, drift, kodgranskning och integration i teamet

SoftBank Hackathon 2026 powered by KOREC & ProgateDeltagare i kvalomgången · uttagning till finalen tillkännages 26 oktober 2026 (per 7 oktober 2026)

  • WebbImplementerad · hackathon
  • MCP-serverImplementerad · fjärr · lokal

Webbskärmen och användarens egen agent begär driftsättning via samma produkt-API.

Produkten från en accepterad driftsättningsbegäran via CI-kontroller och publicering av image till Git-konfiguration och Argo CD-utrullning på ett registrerat mål och verifiering av publik HTTPS. Framgång registreras bara med både en tillämpad revision och en offentlig kontroll; ett utfall som inte kan fastställas förblir unknown.

När ett projekt skickas in från webbskärmen eller från en AI-agent som anslutits via MCP genomförs förberedelse av driftsättningsfiler, reparation av fel, publicering av image, utrullning i miljön och verifiering av den publika URL:en; efter driftsättningen visar samma skärm historik och loggar och hanterar uppdateringar, stopp, återupptaganden och radering. Ett teamprojekt.

Tävlingens utvecklingsperiod 28 september 2026 till 4 oktober 2026

Webbskärmen och MCP-servern som byggdes under hackathonet. Fjärr-MCP loggar in med OAuth för att skicka in; lokala mappar skickas in via den lokala MCP:n.

Produktarkitektur · ritad utifrån kodvägarna vid offentlig commit 645e28a
Railshots produktarkitekturKomponenter och förbindelser i Railshot-produkten. Webbskärmen, fjärr-MCP med OAuth och en lokal MCP på användarens dator begär driftsättning via samma produkt-API, som registrerar en käll-commit och en CI-körning. CI avgör utifrån fasta kontroller och publicerar de kontrollerade images till GHCR. CD-adaptern tillämpar via config-Git och Argo CD bara när det registrerade målet stämmer med publiceringsloggen, kontrollerar sedan den registrerade publika HTTPS-adressen och registrerar utfallet. Mätvärden är observation, skilda från domen.Webbläsaranvändaremapp · ZIP · GitHub-URLMCP-klientChatGPT · Codex · Clauderailshot-local MCPanvändarens dator · stdioGHCRimages via digestAI SDK providerCodex · Claude SDKConfig-Git-reporegistrerad workload.jsonPublik HTTPS-URLregistrerad health-vägPrometheusdriftens kontroll-VM · läsapps/dashboardwebbskärm · historik · Insightsagent/remote-mcp.jsOAuth MCP · deploy_repositoryapps/apivalidera · mål · acceptans med 202driftsättningskö · 3 åt gångenbindning av CI-körning · observeracd.js · deployPublishedmetrics observerapi/product-store.jsoperationstillstånd · körningsbindninggitops/bridge.pybetrodd config · registrerat målcommit · push · fjärråterläsningArgo sync · observerapublik HTTPS-probeArgo CDApplication · AppProject-kontrollapps/<tenant>/<app>käll-commit · trailersrailshot-deploy.ymlloop · baskontroller L0–L3SDK-reparation · bara fel som går att rättasamma kontroller → testad bundlerelease · publicering till GHCR · bindningK3s-appklusterworkload · ServiceRailshot-plattformdriftkluster · AWSGitHubprivat apps-repo · ActionsRegistrerat målpublik väg per provider1 mapp · ZIP · GitHub-URL · Webbläsaranvändare → webbskärm · historik · Insights12samma produkt-API · /api/v13 OAuth · deploy_repository · MCP-klient → OAuth MCP · deploy_repository34samma produkt-API5 ZIP-uppladdning · deploy_local_project · railshot-local MCP → validera · mål · acceptans med 20256 registrerad som queued · 202 · validera · mål · acceptans med 202 → operationstillstånd · körningsbindning67 köordning · operationstillstånd · körningsbindning → driftsättningskö · 3 åt gången78driftsättningstillstånd · historik1source commit2workflow_dispatch3inskickad commit4begäran om reparation · villkorad5publicera kontrollerade images6körning · läsning av publicering7 failed · publication_unverified · bindning av CI-körning · observera → operationstillstånd · körningsbindning71images.json · spec · verdict · manifest2apply · registrerat mål3workload commit · push4revision5sync · observera6tillämpa7image-pull · digest8HTTPS health9 publik väg · Publik HTTPS-URL → workload · Service910 succeeded · revision · URL · cd.js · deployPublished → operationstillstånd · körningsbindning1011 unknown · kräver avstämning · cd.js · deployPublished → operationstillstånd · körningsbindning111PromQL-fråga2scrape · probe3driftsättningstillstånd · historik4HTTPS health

Skicka in → acceptans

Webbskärmen, fjärr-MCP:n och den lokala MCP:n anropar samma produkt-API, som registrerar en kontrollerad förfrågan som queued och svarar 202.

  1. Webbläsaranvändaremapp · ZIP · GitHub-URLwebbskärm · historik · Insightsapps/dashboard

    Källan och en registrerad miljö väljs på webbskärmen.

  2. webbskärm · historik · Insightsapps/dashboardsamma produkt-API · /api/v1validera · mål · acceptans med 202apps/api

    Webbskärmen anropar produkt-API:et från samma ursprung.

  3. MCP-klientOAuth · deploy_repositoryOAuth MCP · deploy_repositoryagent/remote-mcp.js

    Fjärr-MCP:n ansluter via OAuth och tar ett offentligt GitHub-repository som indata.

  4. OAuth MCP · deploy_repositoryagent/remote-mcp.jssamma produkt-APIvalidera · mål · acceptans med 202apps/api

    Fjärr-MCP-servern anropar samma driftsättnings-API via sin interna API-klient.

  5. railshot-local MCPZIP-uppladdning · deploy_local_projectvalidera · mål · acceptans med 202apps/api

    Stdio-MCP:n på användarens dator packar en mapp som ZIP och laddar upp den. Dess session delas inte med fjärrsessionen med OAuth.

  6. validera · mål · acceptans med 202apps/apiregistrerad som queued · 202operationstillstånd · körningsbindningapi/product-store.js

    Indata, registrerat mål, kapacitet och idempotensnyckel kontrolleras; operationen registreras som queued och besvaras med 202. 202 betyder accepterad, inte driftsatt.

  7. operationstillstånd · körningsbindningapi/product-store.jsköordningdriftsättningskö · 3 åt gångenapps/api

    Tas i den ordning de accepterades, inom gränsen för samtidiga driftsättningar (3 som standard).

  8. operationstillstånd · körningsbindningapi/product-store.jsdriftsättningstillstånd · historikwebbskärm · historik · Insightsapps/dashboard

    Webbskärmen och MCP-verktygen läser samma operationsloggar. Det senaste försöket och den aktuella verifierade driftsättningen visas separat, och en avslutad AI-uppgift är inte en lyckad driftsättning.

CI-kontroller → publicering av image

Fastlåst plattformskod kontrollerar den inskickade commiten, lämnar bara fel som går att rätta till AI och publicerar bara images som har klarat samma kontroller igen.

  1. driftsättningskö · 3 åt gångenapps/apisource commitkäll-commit · trailersapps/<tenant>/<app>

    Den inskickade källan blir en commit i det privata apps-repositoryt (med trailers Railshot-Request och Railshot-Target), och grenen uppdateras utan force.

  2. driftsättningskö · 3 åt gångenapps/apiworkflow_dispatchloop · baskontroller L0–L3railshot-deploy.yml

    Begär en körning med tenant, app, source_commit och target_id. Om svaret går förlorat skickas den inte igen; i stället söks körningar för samma commit.

  3. käll-commit · trailersapps/<tenant>/<app>inskickad commitloop · baskontroller L0–L3railshot-deploy.yml

    Bara den inskickade commiten och fastlåst plattformskod (PLATFORM_REF) checkas ut.

  4. SDK-reparation · bara fel som går att rättarailshot-deploy.ymlbegäran om reparation · villkoradAI SDK provider

    Anropas bara för felklasser som går att rätta, och stoppas när samma fel upprepas eller gränsen för försök nås. Godkänt eller underkänt avgörs av kontrollerna, inte av LLM:en.

  5. release · publicering till GHCR · bindningrailshot-deploy.ymlpublicera kontrollerade imagesGHCR

    Efter verifiering av den bundle som klarade kontrollerna publiceras samma images till GHCR. Ingenting byggs om.

  6. bindning av CI-körning · observeraapps/apikörning · läsning av publiceringrailshot-deploy.yml

    En publicering räknas bara när dess run id, source commit, target och app stämmer med den accepterade posten.

  7. bindning av CI-körning · observeraapps/apifailed · publication_unverifiedoperationstillstånd · körningsbindningapi/product-store.js

    Ett CI-fel eller en overifierad publicering registreras med diagnostik och skickas inte vidare till CD.

Tillämpa → publik kontroll

Tillämpar via config-Git och Argo CD bara när publiceringen stämmer med det registrerade målet, och registrerar framgång först när den registrerade publika HTTPS-adressen har kontrollerats.

  1. release · publicering till GHCR · bindningrailshot-deploy.ymlimages.json · spec · verdict · manifestcd.js · deployPublishedapps/api

    CD läser publiceringsloggens filer via en betrodd loader. CI skapar inte själv någon klusterresurs, URL eller lyckad driftsättning.

  2. cd.js · deployPublishedapps/apiapply · registrerat målbetrodd config · registrerat målgitops/bridge.py

    Kör gitops/bridge.py med den betrodda configen bara när den registrerade appen och tenanten stämmer med publiceringsloggen.

  3. commit · push · fjärråterläsninggitops/bridge.pyworkload commit · pushConfig-Git-repo

    Committar bara workload.json på den registrerade sökvägen i en dedikerad gren, registrerar först push-avsikten, pushar och läser tillbaka fjärr-revisionen. En osäker push upprepas inte.

  4. Config-Git-reporevisionApplication · AppProject-kontrollArgo CD

    Revisionen i config-repositoryt som Argo CD-Application pekar på.

  5. Argo sync · observeragitops/bridge.pysync · observeraApplication · AppProject-kontrollArgo CD

    Begär en sync efter kontroll av AppProject; observation läser bara, utan sync.

  6. Application · AppProject-kontrollArgo CDtillämpaworkload · ServiceK3s-appkluster

    Tillämpar arbetslasten på det registrerade målklustret.

  7. workload · ServiceK3s-appklusterimage-pull · digestGHCR

    Hämtar den publicerade digesten. En privat GHCR kräver en dedikerad pull-autentisering.

  8. publik HTTPS-probegitops/bridge.pyHTTPS healthPublik HTTPS-URL

    Kontrollerar bara den HTTPS-health-adress som operatören registrerat, utan omdirigeringar, för 200 (och förväntad JSON om angiven).

  9. Publik HTTPS-URLpublik vägworkload · ServiceK3s-appkluster

    Den publika vägen (LB, NodePort, certifikat) varierar med provider och registrerat mål.

  10. cd.js · deployPublishedapps/apisucceeded · revision · URLoperationstillstånd · körningsbindningapi/product-store.js

    Registreras som succeeded bara med cd.deployed, en revision, en lyckad publik HTTPS-kontroll, tidpunkten för den och en giltig URL.

  11. cd.js · deployPublishedapps/apiunknown · kräver avstämningoperationstillstånd · körningsbindningapi/product-store.js

    Ett utfall som inte kan fastställas förblir unknown; samma apply skickas varken igen eller rullas tillbaka.

Observation · inte domen

Mätvärden och prober avgör inte om driftsättningen lyckades. Saknade, inaktuella och misslyckade värden visas som de är.

  1. metrics observerapps/apiPromQL-frågaPrometheus

    Läser serierna up, probe_success och Pod. Saknade, inaktuella eller misslyckade värden visas i det tillståndet och görs aldrig om till 0.

  2. Prometheusscrape · probeworkload · ServiceK3s-appkluster

    Exporter-scrape och HTTP-probe. Dessa mätvärden används inte för att avgöra om driftsättningen lyckades.

  3. operationstillstånd · körningsbindningapi/product-store.jsdriftsättningstillstånd · historikwebbskärm · historik · Insightsapps/dashboard

    Webbskärmen och MCP-verktygen läser samma operationsloggar. Det senaste försöket och den aktuella verifierade driftsättningen visas separat, och en avslutad AI-uppgift är inte en lyckad driftsättning.

  4. publik HTTPS-probegitops/bridge.pyHTTPS healthPublik HTTPS-URL

    Kontrollerar bara den HTTPS-health-adress som operatören registrerat, utan omdirigeringar, för 200 (och förväntad JSON om angiven).

Alla kopplingar med samma tjocklek. Välj ett flöde för att bara markera dess väg, med numrerade steg.

  • Heldragen · riktningen som källa, images och förfrågningar flödar i
  • Streckad · körbegäran, tillämpa eller sync
  • Lång streck-punkt · statusläsningar, prober och mätvärden, skilda från domen
  • Kort streck · ett registrerat fel eller ett okänt utfall
  • Kraftig svart linje · det valda flödet; siffrorna anger ordningen
  • Ruta · en ägande gräns, källsökvägen i rubriken
  • Inre chip · en komponent inom gränsen
  • Streckad ruta · utanför plattformen
  • Orange kontur · där en modell fattar beslut
  • Produkt-API
  • Driftsättningsloggar
  • CD-exekveringsgräns
  • Ingång · CI · mål

Bilden från 2 oktober (bc61a5a) i docs/architecture/README.md är implementationshistorik; denna arkitektur följer koden vid 645e28a. Providers och nätverksvägar varierar med registrerat mål, och det betyder inte att alla providers alltid är påslagna.