ET
RAILSHOT.
Tagasi saali

Railshot

AI deployment & operations platform

Lokaalselt ehitatud veebirakendus ettevalmistatud pilve- ja kohapealsetesse keskkondadesse juurutamiseks ja käitamiseks.

AI-põhine juurutus- ja käitusplatvorm, mis viib lokaalselt ehitatud veebirakenduse ettevalmistatud pilve- või kohapealsetesse keskkondadesse ja hoiab seda töös.

28. september 2026 – 4. oktoober 2026 · Lõppenud

Meeskonnaprojekt · minu osa: CI kavandamine ja teostus, CSP klastrid ja Ansible'i liides, käitamine, meeskonna koodiülevaatus ja integreerimine

SoftBank Hackathon 2026 powered by KOREC & ProgateEelvooru osaleja · finaali valik kuulutatakse välja 26. oktoobril 2026 (seisuga 7. oktoober 2026)

  • VeebTeostatud · häkaton
  • MCP-serverTeostatud · kaug · kohalik

Veebivaade ja kasutaja oma agent taotlevad juurutamist sama toote API kaudu.

Toode vastu võetud juurutustaotlusest CI kontrollide ja tõmmise avaldamise kaudu Giti konfiguratsiooni ja Argo CD rakendamiseni registreeritud sihtmärgil ning avaliku HTTPS-i verifitseerimiseni. Edu salvestatakse ainult siis, kui olemas on nii rakendatud redaktsioon kui ka avalik kontroll; tulemus, mida ei saa teada, jääb tundmatuks.

Projekti saab esitada veebivaatest või MCP kaudu ühendatud oma AI-agendist ning platvorm viib läbi juurutusfailide ettevalmistamise, tõrgete parandamise, tõmmise avaldamise, keskkonda viimise ja avaliku URL-i verifitseerimise; pärast juurutamist näitab sama vaade ajalugu ja logisid ning haldab uuendusi, peatamisi, jätkamisi ja kustutamist. Meeskonnaprojekt.

Võistluse arendusperiood 28. september 2026 – 4. oktoober 2026

Häkatoni ajal ehitatud veebivaade ja MCP-server. Kaug-MCP logib esitamiseks sisse OAuthiga; kohalikud kaustad esitatakse kohaliku MCP kaudu.

Toote arhitektuur · joonistatud avaliku commiti 645e28a kooditeede põhjal
Railshoti toote arhitektuurRailshoti toote komponendid ja ühendused. Veebivaade, kaug-OAuth-MCP ja kasutaja arvutis töötav kohalik MCP taotlevad juurutamist sama toote API kaudu, mis registreerib lähte-commiti ja CI käivituse. CI otsustab fikseeritud kontrollide põhjal ja avaldab kontrollitud tõmmised GHCR-is. CD-adapter rakendab config Giti ja Argo CD kaudu ainult siis, kui registreeritud sihtmärk vastab avaldamise kirjele, seejärel kontrollib registreeritud avalikku HTTPS-aadressi ja salvestab tulemuse. Mõõdikud on vaatlus, verdiktist eraldi.Brauseri kasutajakaust · ZIP · GitHubi URLMCP-klientChatGPT · Codex · Clauderailshot-local MCPkasutaja arvuti · stdioGHCRtõmmised räsi järgiAI SDK providerCodex · Claude SDKConfig Giti repositooriumregistreeritud workload.jsonAvalik HTTPS URLregistreeritud health-teePrometheuskäituse juhtimis-VM · lugemineapps/dashboardveebivaade · ajalugu · Insightsagent/remote-mcp.jsOAuth MCP · deploy_repositoryapps/apivalideerimine · sihtmärk · 202 vastu võetudjuurutusjärjekord · 3 korragaCI käivituse sidumine · vaatluscd.js · deployPublishedmetrics observerapi/product-store.jsoperatsiooni olek · käivituse siduminegitops/bridge.pyusaldatud konfiguratsioon · registreeritud sihtmärkcommit · push · kaugtagasilugemineArgo sünkroonimine · vaatlusavalik HTTPS-sondArgo CDApplication · AppProject kontrollapps/<tenant>/<app>lähte-commit · traileridrailshot-deploy.ymltsükkel · baaskontrollid L0–L3SDK parandus · ainult parandatavad tõrkedsamad kontrollid → testitud kimprelease · avaldamine GHCR-is · sidumineK3s rakendusklasterworkload · ServiceRailshoti platvormkäitusklaster · AWSGitHubprivaatne apps-repositoorium · ActionsRegistreeritud sihtmärkavalik tee pakkuja kohta1 kaust · ZIP · GitHubi URL · Brauseri kasutaja → veebivaade · ajalugu · Insights12sama toote API · /api/v13 OAuth · deploy_repository · MCP-klient → OAuth MCP · deploy_repository34sama toote API5 ZIP-üleslaadimine · deploy_local_project · railshot-local MCP → valideerimine · sihtmärk · 202 vastu võetud56 salvestatud olekuga queued · 202 · valideerimine · sihtmärk · 202 vastu võetud → operatsiooni olek · käivituse sidumine67 järjekorra järjestus · operatsiooni olek · käivituse sidumine → juurutusjärjekord · 3 korraga78juurutuse olek · ajalugu1source commit2workflow_dispatch3esitatud commit4paranduse taotlus · tingimuslik5kontrollitud tõmmiste avaldamine6käivitus · avaldamise lugemine7 failed · publication_unverified · CI käivituse sidumine · vaatlus → operatsiooni olek · käivituse sidumine71images.json · spec · verdict · manifest2rakendamine · registreeritud sihtmärk3workload commit · push4revision5sünkroonimine · vaatlus6rakendamine7tõmmise allalaadimine · räsi8HTTPS health9 avalik tee · Avalik HTTPS URL → workload · Service910 succeeded · revision · URL · cd.js · deployPublished → operatsiooni olek · käivituse sidumine1011 unknown · vajab ühildamist · cd.js · deployPublished → operatsiooni olek · käivituse sidumine111PromQL päring2scrape · probe3juurutuse olek · ajalugu4HTTPS health

Esitamine → vastuvõtt

Veebivaade, kaug-MCP ja kohalik MCP kutsuvad sama toote API-t, mis salvestab kontrollitud päringu olekuga queued ja vastab koodiga 202.

  1. Brauseri kasutajakaust · ZIP · GitHubi URLveebivaade · ajalugu · Insightsapps/dashboard

    Lähe ja registreeritud keskkond valitakse veebivaates.

  2. veebivaade · ajalugu · Insightsapps/dashboardsama toote API · /api/v1valideerimine · sihtmärk · 202 vastu võetudapps/api

    Veebivaade kutsub toote API-t samast päritolust.

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

    Kaug-MCP ühendub OAuthiga ja võtab sisendiks avaliku GitHubi repositooriumi.

  4. OAuth MCP · deploy_repositoryagent/remote-mcp.jssama toote APIvalideerimine · sihtmärk · 202 vastu võetudapps/api

    Kaug-MCP-server kutsub sama juurutus-API-t oma sisemise API-kliendi kaudu.

  5. railshot-local MCPZIP-üleslaadimine · deploy_local_projectvalideerimine · sihtmärk · 202 vastu võetudapps/api

    Kasutaja arvuti stdio-MCP pakib kausta ZIP-iks ja laadib selle üles. Selle seanssi ei jagata kaug-OAuthi seansiga.

  6. valideerimine · sihtmärk · 202 vastu võetudapps/apisalvestatud olekuga queued · 202operatsiooni olek · käivituse sidumineapi/product-store.js

    Kontrollitakse sisendit, registreeritud sihtmärki, mahtu ja idempotentsusvõtit; operatsioon salvestatakse olekuga queued ja sellele vastatakse koodiga 202. 202 tähendab vastu võetud, mitte juurutatud.

  7. operatsiooni olek · käivituse sidumineapi/product-store.jsjärjekorra järjestusjuurutusjärjekord · 3 korragaapps/api

    Võetakse vastuvõtu järjekorras samaaegsete juurutuste piirangu piires (vaikimisi 3).

  8. operatsiooni olek · käivituse sidumineapi/product-store.jsjuurutuse olek · ajaluguveebivaade · ajalugu · Insightsapps/dashboard

    Veebivaade ja MCP-tööriistad loevad samu operatsioonikirjeid. Viimane katse ja praegune verifitseeritud juurutus näidatakse eraldi ning lõpetatud AI-ülesanne ei ole juurutuse edu.

CI kontrollid → tõmmise avaldamine

Fikseeritud platvormikood kontrollib esitatud commitit, annab AI-le ainult parandatavad tõrked ja avaldab ainult tõmmised, mis läbisid samad kontrollid uuesti.

  1. juurutusjärjekord · 3 korragaapps/apisource commitlähte-commit · traileridapps/<tenant>/<app>

    Esitatud lähtest saab commit privaatses apps-repositooriumis (traileritega Railshot-Request ja Railshot-Target) ning haru uuendatakse ilma force'ita.

  2. juurutusjärjekord · 3 korragaapps/apiworkflow_dispatchtsükkel · baaskontrollid L0–L3railshot-deploy.yml

    Taotleb käivitust väärtustega tenant, app, source_commit ja target_id. Kui vastus kaob, seda uuesti ei saadeta; selle asemel otsitakse sama commiti käivitusi.

  3. lähte-commit · traileridapps/<tenant>/<app>esitatud committsükkel · baaskontrollid L0–L3railshot-deploy.yml

    Töökoopiasse võetakse ainult esitatud commit ja fikseeritud platvormikood (PLATFORM_REF).

  4. SDK parandus · ainult parandatavad tõrkedrailshot-deploy.ymlparanduse taotlus · tingimuslikAI SDK provider

    Kutsutakse ainult parandatavate tõrkeklasside korral ja peatatakse, kui sama tõrge kordub või katsete piirang saab täis. Läbimise või läbikukkumise otsustavad kontrollid, mitte LLM.

  5. release · avaldamine GHCR-is · siduminerailshot-deploy.ymlkontrollitud tõmmiste avaldamineGHCR

    Pärast kontrollid läbinud kimbu verifitseerimist avaldatakse samad tõmmised GHCR-is. Midagi uuesti ei ehitata.

  6. CI käivituse sidumine · vaatlusapps/apikäivitus · avaldamise lugeminerailshot-deploy.yml

    Avaldamine loetakse kehtivaks ainult siis, kui selle run id, lähte-commit, sihtmärk ja rakendus vastavad vastu võetud kirjele.

  7. CI käivituse sidumine · vaatlusapps/apifailed · publication_unverifiedoperatsiooni olek · käivituse sidumineapi/product-store.js

    CI tõrge või verifitseerimata avaldamine salvestatakse koos diagnostikaga ja seda CD-le edasi ei anta.

Rakendamine → avalik kontroll

Rakendab config Giti ja Argo CD kaudu ainult siis, kui avaldamine vastab registreeritud sihtmärgile, ning salvestab edu alles pärast registreeritud avaliku HTTPS-aadressi kontrolli.

  1. release · avaldamine GHCR-is · siduminerailshot-deploy.ymlimages.json · spec · verdict · manifestcd.js · deployPublishedapps/api

    CD loeb avaldamiskirje faile usaldatud laaduri kaudu. CI ise ei loo klastriressurssi, URL-i ega juurutuse edu.

  2. cd.js · deployPublishedapps/apirakendamine · registreeritud sihtmärkusaldatud konfiguratsioon · registreeritud sihtmärkgitops/bridge.py

    Käivitab gitops/bridge.py usaldatud konfiguratsiooniga ainult siis, kui registreeritud rakendus ja tenant vastavad avaldamiskirjele.

  3. commit · push · kaugtagasilugeminegitops/bridge.pyworkload commit · pushConfig Giti repositoorium

    Commitib ainult faili workload.json eraldi haru registreeritud teele, salvestab kõigepealt push'i kavatsuse, teeb push'i ja loeb kaugredaktsiooni tagasi. Ebakindlat push'i ei korrata.

  4. Config Giti repositooriumrevisionApplication · AppProject kontrollArgo CD

    Config-repositooriumi redaktsioon, millele Argo CD Application osutab.

  5. Argo sünkroonimine · vaatlusgitops/bridge.pysünkroonimine · vaatlusApplication · AppProject kontrollArgo CD

    Taotleb sünkroonimist pärast AppProjecti kontrollimist; vaatlus ainult loeb, ilma sünkroonimiseta.

  6. Application · AppProject kontrollArgo CDrakendamineworkload · ServiceK3s rakendusklaster

    Rakendab töökoormuse registreeritud sihtklastris.

  7. workload · ServiceK3s rakendusklastertõmmise allalaadimine · räsiGHCR

    Laadib alla avaldatud räsi. Privaatne GHCR vajab eraldi pull-mandaati.

  8. avalik HTTPS-sondgitops/bridge.pyHTTPS healthAvalik HTTPS URL

    Kontrollib ainult operaatori registreeritud HTTPS health-aadressi, ilma ümbersuunamisteta, kas vastus on 200 (ja seadistamisel oodatud JSON).

  9. Avalik HTTPS URLavalik teeworkload · ServiceK3s rakendusklaster

    Avalik tee (LB, NodePort, sertifikaat) erineb pakkuja ja registreeritud sihtmärgi kaupa.

  10. cd.js · deployPublishedapps/apisucceeded · revision · URLoperatsiooni olek · käivituse sidumineapi/product-store.js

    Salvestatakse olekuga succeeded ainult siis, kui olemas on cd.deployed, redaktsioon, edukas avalik HTTPS-kontroll, selle aeg ja kehtiv URL.

  11. cd.js · deployPublishedapps/apiunknown · vajab ühildamistoperatsiooni olek · käivituse sidumineapi/product-store.js

    Tulemus, mida ei saa teada, jääb olekuks unknown; sama rakendamist ei saadeta uuesti ega võeta tagasi.

Vaatlus · mitte verdikt

Mõõdikud ja sondid ei otsusta juurutuse edu. Puuduvad, aegunud ja ebaõnnestunud väärtused näidatakse nii, nagu need on.

  1. metrics observerapps/apiPromQL päringPrometheus

    Loeb up-, probe_success- ja Podi aegridu. Puuduvad, aegunud või ebaõnnestunud väärtused näidatakse selles olekus ja neid ei muudeta kunagi 0-ks.

  2. Prometheusscrape · probeworkload · ServiceK3s rakendusklaster

    Exporterite scrape ja HTTP-sond. Neid mõõdikuid ei kasutata juurutuse edu otsustamiseks.

  3. operatsiooni olek · käivituse sidumineapi/product-store.jsjuurutuse olek · ajaluguveebivaade · ajalugu · Insightsapps/dashboard

    Veebivaade ja MCP-tööriistad loevad samu operatsioonikirjeid. Viimane katse ja praegune verifitseeritud juurutus näidatakse eraldi ning lõpetatud AI-ülesanne ei ole juurutuse edu.

  4. avalik HTTPS-sondgitops/bridge.pyHTTPS healthAvalik HTTPS URL

    Kontrollib ainult operaatori registreeritud HTTPS health-aadressi, ilma ümbersuunamisteta, kas vastus on 200 (ja seadistamisel oodatud JSON).

Kõik ühendused sama kaaluga. Vali voog, et tõsta esile ainult selle tee koos nummerdatud sammudega.

  • Pidevjoon · lähte, tõmmiste ja päringute liikumissuund
  • Kriipsjoon · käivitustaotlus, rakendamine või sünkroonimine
  • Pikk kriips-punktjoon · olekupäringud, sondid ja mõõdikud, verdiktist eraldi
  • Lühike kriips · salvestatud tõrge või teadmata tulemus
  • Paks must joon · valitud voog; numbrid näitavad järjekorda
  • Kast · omav piir, lähtetee päises
  • Sisemine silt · komponent selle piiri sees
  • Kriipsjoonega kast · platvormist väljas
  • Oranž kontuur · koht, kus mudel otsustab
  • Toote API
  • Juurutuskirjed
  • CD täitmise piir
  • Sisenemine · CI · sihtmärk

Faili docs/architecture/README.md 2. oktoobri (bc61a5a) joonis on teostuse ajalugu; see arhitektuur järgib koodi 645e28a. Pakkujad ja võrguteed erinevad registreeritud sihtmärgi kaupa ning see ei tähenda, et iga pakkuja on alati sees.