Railshot

Railshot

AI deployment & operations platform

Helyben készült webalkalmazás telepítése előkészített felhős és helyszíni környezetekbe, majd üzemeltetése.

AI-alapú telepítési és üzemeltetési platform, amely a helyben készült webalkalmazást előkészített felhős vagy helyszíni környezetekbe viszi, és tovább üzemelteti.

2026. szeptember 28. – 2026. október 4. · Lezárult

Csapatprojekt · saját feladatom: CI tervezése és megvalósítása, CSP-klaszterek és Ansible-interfész, üzemeltetés, csapaton belüli kódfelülvizsgálat és integráció

SoftBank Hackathon 2026 powered by KOREC & ProgateA selejtező résztvevője · a döntőbe jutók kihirdetése 2026. október 26-án várható (2026. október 7-i állapot)

Webes felületMegvalósítva · hackathon
MCP-szerverMegvalósítva · távoli · helyi

A webes felület és a felhasználó saját ágense ugyanazon a termék-API-n kér telepítést.

A termék az elfogadott telepítési kéréstől a CI-ellenőrzéseken és a konténerkép közzétételén át a Git-konfigurációig, az Argo CD-kivezetésig egy regisztrált célon és a nyilvános HTTPS-ellenőrzésig. Siker csak alkalmazott revízióval és nyilvános ellenőrzéssel együtt rögzül; a nem megismerhető eredmény unknown marad.

A webes felületről vagy egy MCP-n keresztül csatlakoztatott saját AI-ágensből beküldött projekt végigmegy a telepítési fájlok előkészítésén, a hibajavításon, a konténerkép közzétételén, a környezetbe való kivezetésen és a nyilvános URL ellenőrzésén; telepítés után ugyanaz a felület mutatja az előzményeket és a naplókat, és kezeli a frissítést, a leállítást, a folytatást és a törlést. Csapatprojekt.

A verseny fejlesztési időszaka: 2026. szeptember 28. – 2026. október 4.

A hackathon alatt készült webes felület és MCP-szerver. A távoli MCP OAuth-bejelentkezéssel küld be; a helyi mappákat a helyi MCP küldi be.

Termékarchitektúra · a nyilvános 645e28a commit kódútvonalai alapján

Beküldés → elfogadás

A webes felület, a távoli MCP és a helyi MCP ugyanazt a termék-API-t hívja, amely az ellenőrzött kérést queued állapotban rögzíti, és 202-vel válaszol.

Böngészős felhasználóadat: mappa · ZIP · GitHub-URLwebes felület · előzmények · Insightsapps/dashboard
A forrás és egy regisztrált környezet a webes felületen választható ki.
webes felület · előzmények · Insightsapps/dashboardadat: ugyanaz a termék-API · /api/v1érvényesítés · cél · 202-es elfogadásapps/api
A webes felület azonos eredetről hívja a termék-API-t.
MCP-kliensadat: OAuth · deploy_repositoryOAuth MCP · deploy_repositoryagent/remote-mcp.js
A távoli MCP OAuth-on keresztül csatlakozik, és bemenetként nyilvános GitHub-tárolót fogad.
OAuth MCP · deploy_repositoryagent/remote-mcp.jsadat: ugyanaz a termék-APIérvényesítés · cél · 202-es elfogadásapps/api
A távoli MCP-szerver belső API-kliensével ugyanazt a telepítési API-t hívja.
railshot-local MCPadat: ZIP-feltöltés · deploy_local_projectérvényesítés · cél · 202-es elfogadásapps/api
A felhasználó gépén futó stdio MCP ZIP-be tömörít egy mappát, és feltölti. Munkamenete nincs megosztva a távoli OAuth-munkamenettel.
érvényesítés · cél · 202-es elfogadásapps/apiadat: queued rögzítve · 202műveleti állapot · futtatáskötésapi/product-store.js
Ellenőrzi a bemenetet, a regisztrált célt, a kapacitást és az idempotenciakulcsot; a műveletet queued állapotban rögzíti, és 202-vel válaszol. A 202 elfogadást jelent, nem telepítést.
műveleti állapot · futtatáskötésapi/product-store.jsadat: sorrend a sorbantelepítési sor · egyszerre 3apps/api
Az elfogadás sorrendjében veszi elő, a párhuzamos telepítések korlátján belül (alapértelmezés szerint 3).
műveleti állapot · futtatáskötésapi/product-store.jsmegfigyelés: telepítési állapot · előzményekwebes felület · előzmények · Insightsapps/dashboard
A webes felület és az MCP-eszközök ugyanazokat a műveleti feljegyzéseket olvassák. A legutóbbi kísérlet és a jelenlegi ellenőrzött telepítés külön jelenik meg, és egy befejezett AI-feladat nem telepítési siker.

CI-ellenőrzések → konténerkép közzététele

A rögzített platformkód ellenőrzi a beküldött commitot, csak a javítható hibákat adja át az AI-nak, és csak az ugyanazokon az ellenőrzéseken újra átment konténerképeket teszi közzé.

telepítési sor · egyszerre 3apps/apiadat: source commitforrás-commit · trailerekapps/<tenant>/<app>
A beküldött forrásból commit lesz a nem nyilvános apps-tárolóban (Railshot-Request és Railshot-Target trailerekkel), és az ág force nélkül frissül.
telepítési sor · egyszerre 3apps/apifuttatás · alkalmazás: workflow_dispatchciklus · alapellenőrzések L0–L3railshot-deploy.yml
Futtatást kér a tenant, app, source_commit és target_id értékekkel. Ha a válasz elveszik, nem küldi újra, hanem megkeresi az ugyanahhoz a commithoz tartozó futtatásokat.
forrás-commit · trailerekapps/<tenant>/<app>adat: beküldött commitciklus · alapellenőrzések L0–L3railshot-deploy.yml
Csak a beküldött commit és a rögzített platformkód (PLATFORM_REF) kerül checkoutra.
SDK-javítás · csak javítható hibákrailshot-deploy.ymladat: javítási kérés · feltételesAI SDK provider
Csak javítható hibaosztályoknál hívja meg, és leáll, ha ugyanaz a hiba ismétlődik, vagy eléri a kísérleti korlátot. A sikerről vagy kudarcról az ellenőrzések döntenek, nem az LLM.
kiadás · GHCR-közzététel · kötésrailshot-deploy.ymladat: ellenőrzött konténerképek közzétételeGHCR
Az ellenőrzéseken átment csomag igazolása után ugyanazok a konténerképek kerülnek a GHCR-be. Semmi sem épül újra.
CI-futtatás kötése · megfigyelésapps/apimegfigyelés: futtatás · közzététel olvasásarailshot-deploy.yml
Egy közzététel csak akkor számít, ha a run id, a source commit, a cél és az app egyezik az elfogadott feljegyzéssel.
CI-futtatás kötése · megfigyelésapps/apihiba · ismeretlen kimenetel: failed · publication_unverifiedműveleti állapot · futtatáskötésapi/product-store.js
A CI-hiba vagy az igazolatlan közzététel diagnosztikával együtt rögzül, és nem jut tovább a CD-hez.

Alkalmazás → nyilvános ellenőrzés

Csak akkor alkalmaz a config Giten és az Argo CD-n keresztül, ha a közzététel egyezik a regisztrált céllal, és sikert csak a regisztrált nyilvános HTTPS-cím sikeres ellenőrzése után rögzít.

kiadás · GHCR-közzététel · kötésrailshot-deploy.ymladat: images.json · spec · verdict · manifestcd.js · deployPublishedapps/api
A CD megbízható betöltővel olvassa a közzétételi feljegyzés fájljait. Maga a CI nem hoz létre klasztererőforrást, URL-t vagy telepítési sikert.
cd.js · deployPublishedapps/apifuttatás · alkalmazás: alkalmazás · regisztrált célmegbízható konfiguráció · regisztrált célgitops/bridge.py
A gitops/bridge.py-t a megbízható konfigurációval csak akkor futtatja, ha a regisztrált app és tenant egyezik a közzétételi feljegyzéssel.
commit · push · távoli visszaolvasásgitops/bridge.pyadat: workload commit · pushConfig Git-tároló
Csak a workload.json-t commitolja egy dedikált ág regisztrált útvonalán, előbb rögzíti a push szándékát, majd pushol, és visszaolvassa a távoli revíziót. A bizonytalan push nem ismétlődik.
Config Git-tárolóadat: revisionApplication · AppProject-ellenőrzésArgo CD
A config-tároló revíziója, amelyre az Argo CD Application mutat.
Argo-szinkron · megfigyelésgitops/bridge.pyfuttatás · alkalmazás: szinkronizálás · megfigyelésApplication · AppProject-ellenőrzésArgo CD
Az AppProject ellenőrzése után szinkronizálást kér; megfigyeléskor csak olvas, szinkronizálás nélkül.
Application · AppProject-ellenőrzésArgo CDfuttatás · alkalmazás: alkalmazásworkload · ServiceK3s alkalmazásklaszter
A munkaterhelést a regisztrált célklaszterre alkalmazza.
workload · ServiceK3s alkalmazásklaszteradat: konténerkép letöltése · digestGHCR
A közzétett digestet tölti le. Nem nyilvános GHCR esetén dedikált letöltési hitelesítő adat kell.
nyilvános HTTPS-próbagitops/bridge.pymegfigyelés: HTTPS healthNyilvános HTTPS-URL
Csak az üzemeltető által regisztrált HTTPS health-címet ellenőrzi, átirányítások nélkül, 200-as válaszra (és a beállított elvárt JSON-ra).
Nyilvános HTTPS-URLadat: nyilvános útvonalworkload · ServiceK3s alkalmazásklaszter
A nyilvános útvonal (LB, NodePort, tanúsítvány) szolgáltatónként és regisztrált célonként eltér.
cd.js · deployPublishedapps/apiadat: succeeded · revision · URLműveleti állapot · futtatáskötésapi/product-store.js
Csak cd.deployed, revízió, sikeres nyilvános HTTPS-ellenőrzés, annak időpontja és érvényes URL esetén rögzül succeeded állapotként.
cd.js · deployPublishedapps/apihiba · ismeretlen kimenetel: unknown · egyeztetés szükségesműveleti állapot · futtatáskötésapi/product-store.js
A nem megismerhető eredmény unknown marad; ugyanazt az alkalmazást nem küldi újra, és nem is vonja vissza.

Megfigyelés · nem az ítélet

A metrikák és a próbák nem döntenek a telepítés sikeréről. A hiányzó, elavult és sikertelen értékek úgy jelennek meg, ahogy vannak.

metrics observerapps/apimegfigyelés: PromQL-lekérdezésPrometheus
Az up, a probe_success és a Pod-idősorokat olvassa. A hiányzó, elavult vagy sikertelen értékek ebben az állapotukban jelennek meg, soha nem lesz belőlük 0.
Prometheusmegfigyelés: scrape · probeworkload · ServiceK3s alkalmazásklaszter
Exporter-scrape és HTTP-próba. Ezek a metrikák nem döntenek a telepítés sikeréről.
műveleti állapot · futtatáskötésapi/product-store.jsmegfigyelés: telepítési állapot · előzményekwebes felület · előzmények · Insightsapps/dashboard
A webes felület és az MCP-eszközök ugyanazokat a műveleti feljegyzéseket olvassák. A legutóbbi kísérlet és a jelenlegi ellenőrzött telepítés külön jelenik meg, és egy befejezett AI-feladat nem telepítési siker.
nyilvános HTTPS-próbagitops/bridge.pymegfigyelés: HTTPS healthNyilvános HTTPS-URL
Csak az üzemeltető által regisztrált HTTPS health-címet ellenőrzi, átirányítások nélkül, 200-as válaszra (és a beállított elvárt JSON-ra).

Minden kapcsolat azonos vastagsággal. Válasszon egy folyamatot, hogy csak annak útvonala emelődjön ki, számozott lépésekkel.

Folytonos · a forrás, a konténerképek és a kérések áramlási iránya
Szaggatott · futtatási kérés, alkalmazás vagy szinkronizálás
Hosszú pontvonalas · állapotlekérdezések, próbák és metrikák, az ítélettől elkülönítve
Rövid szaggatott · rögzített hiba vagy ismeretlen kimenetel
Vastag fekete vonal · a kiválasztott folyamat; a számok a sorrendet jelzik
Doboz · birtokló határ, fejlécében a forrásútvonallal
Belső chip · komponens a határon belül
Szaggatott doboz · a platformon kívül
Narancssárga körvonal · ahol egy modell dönt

Termék-API
Telepítési feljegyzések
A CD végrehajtási határa
Belépés · CI · cél

A docs/architecture/README.md október 2-i (bc61a5a) ábrája megvalósítási előzmény; ez az architektúra a 645e28a kódját követi. A szolgáltatók és a hálózati útvonalak regisztrált célonként eltérnek, és ez nem jelenti, hogy minden szolgáltató mindig be van kapcsolva.

Railshot vocabulary

Beküldés → elfogadás

CI-ellenőrzések → konténerkép közzététele

Alkalmazás → nyilvános ellenőrzés

Megfigyelés · nem az ítélet