Railshot

Railshot

AI deployment & operations platform

Yerelde geliştirilen bir web uygulamasını hazır bulut ve şirket içi ortamlara dağıtmak, sonra işletmek.

Yerelde geliştirilen bir web uygulamasını hazır bulut ya da şirket içi ortamlara taşıyan ve işletmeyi sürdüren bir yapay zekâ dağıtım ve operasyon platformu.

2026.09.28 — 2026.10.04 · Tamamlandı

Ekip projesi · benim payım: CI planlama ve uygulaması, CSP kümeleri ve Ansible arayüzü, operasyonlar, ekip kod incelemesi ve entegrasyon

SoftBank Hackathon 2026 powered by KOREC & ProgateÖn eleme katılımcısı · final seçimi 2026.10.26 tarihinde açıklanacak (2026.10.07 itibarıyla)

WebUygulandı · hackathon
MCP sunucusuUygulandı · uzak · yerel

Web ekranı ve kişisel ajan, dağıtımı aynı ürün API'si üzerinden ister.

Kabul edilen bir dağıtım isteğinden CI kontrolleri ve image yayımına, oradan kayıtlı bir hedefte Git yapılandırması ve Argo CD yayılımına ve herkese açık HTTPS doğrulamasına uzanan ürün. Başarı yalnızca hem uygulanmış bir revision hem de herkese açık bir kontrol varsa kaydedilir; bilinemeyen bir sonuç unknown olarak kalır.

Bir proje web ekranından ya da MCP ile bağlanan kişisel bir yapay zekâ ajanından gönderilir; platform dağıtım dosyalarının hazırlanmasından hata onarımına, image yayımlamaya, ortama yayılıma ve herkese açık URL doğrulamasına kadar ilerler. Dağıtımdan sonra aynı ekran geçmişi ve günlükleri gösterir; güncelleme, durdurma, sürdürme ve silmeyi yönetir. Bir ekip projesi.

Etkinlik geliştirme dönemi September 28, 2026 to October 4, 2026

Hackathon sırasında yapılan web ekranı ve MCP sunucusu. Uzak MCP göndermek için OAuth ile oturum açar; yerel klasörler yerel MCP üzerinden gönderilir.

Ürün mimarisi · herkese açık 645e28a commit'indeki kod yollarından çizildi

Gönder → kabul

Web ekranı, uzak MCP ve yerel MCP aynı ürün API'sini çağırır; API kontrol edilmiş bir isteği queued olarak kaydeder ve 202 yanıtı verir.

Tarayıcı kullanıcısıveri: klasör · ZIP · GitHub URLweb ekranı · geçmiş · Insightsapps/dashboard
Kaynak ve kayıtlı bir ortam web ekranında seçilir.
web ekranı · geçmiş · Insightsapps/dashboardveri: aynı ürün API'si · /api/v1doğrulama · hedef · 202 kabulapps/api
Web ekranı ürün API'sini aynı kökenden çağırır.
MCP istemcisiveri: OAuth · deploy_repositoryOAuth MCP · deploy_repositoryagent/remote-mcp.js
Uzak MCP OAuth ile bağlanır ve girdi olarak herkese açık bir GitHub deposu alır.
OAuth MCP · deploy_repositoryagent/remote-mcp.jsveri: aynı ürün API'sidoğrulama · hedef · 202 kabulapps/api
Uzak MCP sunucusu aynı dağıtım API'sini kendi iç API istemcisiyle çağırır.
railshot-local MCPveri: ZIP yükleme · deploy_local_projectdoğrulama · hedef · 202 kabulapps/api
Kullanıcının bilgisayarındaki stdio MCP bir klasörü ZIP'leyip yükler. Oturumu uzak OAuth oturumuyla paylaşılmaz.
doğrulama · hedef · 202 kabulapps/apiveri: queued kaydedildi · 202operation durumu · run bağlamaapi/product-store.js
Girdi, kayıtlı hedef, kapasite ve idempotency anahtarı kontrol edilir; operation queued olarak kaydedilir ve 202 ile yanıtlanır. 202 kabul anlamına gelir, dağıtıldı anlamına gelmez.
operation durumu · run bağlamaapi/product-store.jsveri: kuyruk sırasıdağıtım kuyruğu · aynı anda 3apps/api
Eşzamanlı dağıtım sınırı (varsayılan 3) içinde kabul sırasına göre alınır.
operation durumu · run bağlamaapi/product-store.jsgözlem: dağıtım durumu · geçmişweb ekranı · geçmiş · Insightsapps/dashboard
Web ekranı ve MCP araçları aynı operation kayıtlarını okur. Son deneme ile güncel doğrulanmış dağıtım ayrı gösterilir; tamamlanmış bir yapay zekâ görevi dağıtım başarısı değildir.

CI kontrolleri → image yayını

Sabitlenmiş platform kodu gönderilen commit'i kontrol eder, yalnızca düzeltilebilir hataları yapay zekâya devreder ve yalnızca aynı kontrollerden yeniden geçen image'ları yayımlar.

dağıtım kuyruğu · aynı anda 3apps/apiveri: source commitkaynak commit · trailer'larapps/<tenant>/<app>
Gönderilen kaynak, özel apps deposunda bir commit'e dönüşür (Railshot-Request ve Railshot-Target trailer'larıyla) ve dal force olmadan güncellenir.
dağıtım kuyruğu · aynı anda 3apps/apiçalıştırma · uygulama: workflow_dispatchloop · temel kontroller L0–L3railshot-deploy.yml
tenant, app, source_commit ve target_id ile bir çalıştırma ister. Yanıt kaybolursa yeniden gönderilmez; bunun yerine aynı commit'in çalıştırmaları aranır.
kaynak commit · trailer'larapps/<tenant>/<app>veri: gönderilen commitloop · temel kontroller L0–L3railshot-deploy.yml
Yalnızca gönderilen commit ve sabitlenmiş platform kodu (PLATFORM_REF) checkout edilir.
SDK onarımı · yalnızca düzeltilebilir hatalarrailshot-deploy.ymlveri: onarım isteği · koşulluAI SDK provider
Yalnızca düzeltilebilir hata sınıflarında çağrılır; aynı hata tekrarlandığında ya da deneme sınırına ulaşıldığında durdurulur. Geçti ya da kaldı kararını LLM değil, kontroller verir.
release · GHCR yayını · bağlamarailshot-deploy.ymlveri: kontrol edilmiş image'ları yayımlaGHCR
Kontrollerden geçen bundle doğrulandıktan sonra aynı image'lar GHCR'a yayımlanır. Hiçbir şey yeniden derlenmez.
CI çalıştırması bağlama · gözlemapps/apigözlem: çalıştırma · yayın okumarailshot-deploy.yml
Bir yayın, ancak run id, source commit, target ve app kabul edilen kayıtla eşleştiğinde sayılır.
CI çalıştırması bağlama · gözlemapps/apihata · bilinmeyen sonuç: failed · publication_unverifiedoperation durumu · run bağlamaapi/product-store.js
Bir CI hatası ya da doğrulanmamış bir yayın tanılamalarla kaydedilir ve CD'ye aktarılmaz.

Uygula → herkese açık kontrol

Yalnızca yayın kayıtlı hedefle eşleştiğinde config Git ve Argo CD üzerinden uygular; başarıyı ancak kayıtlı herkese açık HTTPS adresi kontrolden geçtikten sonra kaydeder.

release · GHCR yayını · bağlamarailshot-deploy.ymlveri: images.json · spec · verdict · manifestcd.js · deployPublishedapps/api
CD, yayın kaydının dosyalarını güvenilir bir loader ile okur. CI'ın kendisi hiçbir küme kaynağı, URL ya da dağıtım başarısı oluşturmaz.
cd.js · deployPublishedapps/apiçalıştırma · uygulama: apply · kayıtlı hedefgüvenilir config · kayıtlı hedefgitops/bridge.py
gitops/bridge.py'ı güvenilir config ile yalnızca kayıtlı app ve tenant yayın kaydıyla eşleştiğinde çalıştırır.
commit · push · uzaktan geri okumagitops/bridge.pyveri: workload commit · pushConfig Git deposu
Ayrılmış bir dalın kayıtlı yoluna yalnızca workload.json'u commit'ler, önce push niyetini kaydeder, push eder ve uzak revision'ı geri okur. Belirsiz bir push tekrarlanmaz.
Config Git deposuveri: revisionApplication · AppProject kontrolüArgo CD
Argo CD Application'ın işaret ettiği config deposu revision'ı.
Argo sync · gözlemgitops/bridge.pyçalıştırma · uygulama: sync · gözlemApplication · AppProject kontrolüArgo CD
AppProject'i kontrol ettikten sonra sync ister; gözlem sync olmadan yalnızca okur.
Application · AppProject kontrolüArgo CDçalıştırma · uygulama: uygulaworkload · ServiceK3s uygulama kümesi
Workload'u kayıtlı hedef kümeye uygular.
workload · ServiceK3s uygulama kümesiveri: image pull · digestGHCR
Yayımlanan digest'i çeker. Özel bir GHCR için ayrılmış bir pull kimlik bilgisi gerekir.
herkese açık HTTPS probe'ugitops/bridge.pygözlem: HTTPS healthHerkese açık HTTPS URL'si
Yalnızca operatörün kaydettiği HTTPS health adresini, yönlendirme olmadan, 200 (ve ayarlanmışsa beklenen JSON) için kontrol eder.
Herkese açık HTTPS URL'siveri: herkese açık yolworkload · ServiceK3s uygulama kümesi
Herkese açık yol (LB, NodePort, sertifika) sağlayıcıya ve kayıtlı hedefe göre değişir.
cd.js · deployPublishedapps/apiveri: succeeded · revision · URLoperation durumu · run bağlamaapi/product-store.js
Yalnızca cd.deployed, bir revision, başarılı bir herkese açık HTTPS kontrolü, zamanı ve geçerli bir URL varsa succeeded olarak kaydedilir.
cd.js · deployPublishedapps/apihata · bilinmeyen sonuç: unknown · mutabakat gereklioperation durumu · run bağlamaapi/product-store.js
Bilinemeyen bir sonuç unknown olarak kalır; aynı apply ne yeniden gönderilir ne de geri alınır.

Gözlem · hüküm değil

Metrikler ve probe'lar dağıtım başarısına karar vermez. Eksik, eski ve başarısız değerler olduğu gibi gösterilir.

metrics observerapps/apigözlem: PromQL sorgusuPrometheus
up, probe_success ve Pod serilerini okur. Eksik, eski ya da başarısız değerler o durumlarıyla gösterilir ve asla 0'a çevrilmez.
Prometheusgözlem: scrape · probeworkload · ServiceK3s uygulama kümesi
Exporter scrape'i ve HTTP probe'u. Bu metrikler dağıtım başarısına karar vermek için kullanılmaz.
operation durumu · run bağlamaapi/product-store.jsgözlem: dağıtım durumu · geçmişweb ekranı · geçmiş · Insightsapps/dashboard
Web ekranı ve MCP araçları aynı operation kayıtlarını okur. Son deneme ile güncel doğrulanmış dağıtım ayrı gösterilir; tamamlanmış bir yapay zekâ görevi dağıtım başarısı değildir.
herkese açık HTTPS probe'ugitops/bridge.pygözlem: HTTPS healthHerkese açık HTTPS URL'si
Yalnızca operatörün kaydettiği HTTPS health adresini, yönlendirme olmadan, 200 (ve ayarlanmışsa beklenen JSON) için kontrol eder.

Her bağlantı aynı kalınlıkta. Yalnızca yolunu numaralı adımlarla vurgulamak için bir akış seçin.

Düz çizgi · kaynağın, image'ların ve isteklerin akış yönü
Kesikli · çalıştırma isteği, uygulama ya da sync
Uzun çizgi-nokta · durum okumaları, probe'lar ve metrikler, hükümden ayrı
Kısa kesik · kaydedilmiş bir hata ya da unknown sonuç
Kalın siyah çizgi · seçilen akış; numaralar sırayı verir
Kutu · sahip olan bir sınır, başlığında kaynak yolu
İç çip · o sınırın içindeki bir bileşen
Kesikli kutu · platformun dışı
Turuncu çerçeve · bir modelin karar verdiği yer

Ürün API'si
Dağıtım kayıtları
CD yürütme sınırı
Giriş · CI · hedef

docs/architecture/README.md'deki October 2 (bc61a5a) çizimi uygulama geçmişidir; bu mimari 645e28a kodunu izler. Sağlayıcılar ve ağ yolları kayıtlı hedefe göre değişir; bu, her sağlayıcının her zaman açık olduğu anlamına gelmez.

Railshot vocabulary

Gönder → kabul

CI kontrolleri → image yayını

Uygula → herkese açık kontrol

Gözlem · hüküm değil