Railshot

Railshot

AI deployment & operations platform

Desplegar en entornos en la nube y on-premises preparados una aplicación web creada en local, y luego operarla.

Una plataforma de IA de despliegue y operación que lleva una aplicación web creada en local a entornos en la nube u on-premises preparados y la mantiene en funcionamiento.

2026.09.28 — 2026.10.04 · Finalizado

Proyecto en equipo · mi parte: planificación e implementación de la CI, clústeres CSP e interfaz de Ansible, operación, revisión de código del equipo e integración

SoftBank Hackathon 2026 powered by KOREC & ProgateParticipante en la fase preliminar · selección para la final que se anunciará el 2026.10.26 (a fecha de 2026.10.07)

WebImplementado · hackatón
Servidor MCPImplementado · remoto · local

La pantalla web y un agente propio piden el despliegue mediante la misma API del producto.

El producto, desde una solicitud de despliegue aceptada, pasando por las comprobaciones de CI y la publicación de la imagen, hasta la configuración de Git y el despliegue con Argo CD en un destino registrado y la verificación HTTPS pública. El éxito solo se registra con una revisión aplicada y una comprobación pública; un resultado que no se puede conocer queda como unknown.

Un proyecto enviado desde la pantalla web, o desde un agente de IA propio conectado por MCP, pasa por la preparación de los archivos de despliegue, la reparación de fallos, la publicación de la imagen, el despliegue en el entorno y la verificación de la URL pública; tras el despliegue, la misma pantalla muestra el historial y los logs y gestiona actualizaciones, paradas, reanudaciones y eliminaciones. Un proyecto en equipo.

Periodo de desarrollo del concurso: September 28, 2026 to October 4, 2026

La pantalla web y el servidor MCP construidos durante el hackatón. El MCP remoto inicia sesión con OAuth para enviar; las carpetas locales se envían mediante el MCP local.

Arquitectura del producto · trazada a partir de las rutas de código en el commit público 645e28a

Enviar → aceptar

La pantalla web, el MCP remoto y el MCP local llaman a la misma API del producto, que registra una solicitud comprobada como queued y responde 202.

Usuario del navegadordatos: carpeta · ZIP · URL de GitHubpantalla web · historial · Insightsapps/dashboard
La fuente y un entorno registrado se eligen en la pantalla web.
pantalla web · historial · Insightsapps/dashboarddatos: misma API del producto · /api/v1validar · destino · aceptación 202apps/api
La pantalla web llama a la API del producto desde el mismo origen.
Cliente MCPdatos: OAuth · deploy_repositoryOAuth MCP · deploy_repositoryagent/remote-mcp.js
El MCP remoto se conecta por OAuth y recibe como entrada un repositorio público de GitHub.
OAuth MCP · deploy_repositoryagent/remote-mcp.jsdatos: misma API del productovalidar · destino · aceptación 202apps/api
El servidor MCP remoto llama a la misma API de despliegue a través de su cliente de API interno.
railshot-local MCPdatos: subida de ZIP · deploy_local_projectvalidar · destino · aceptación 202apps/api
El MCP stdio en el equipo del usuario comprime una carpeta en ZIP y la sube. Su sesión no se comparte con la sesión OAuth remota.
validar · destino · aceptación 202apps/apidatos: registrado como queued · 202estado de la operación · vinculación del runapi/product-store.js
Se comprueban la entrada, el destino registrado, la capacidad y la clave de idempotencia; la operación se registra como queued y se responde con 202. Un 202 significa aceptado, no desplegado.
estado de la operación · vinculación del runapi/product-store.jsdatos: orden de la colacola de despliegue · 3 a la vezapps/api
Se toman en orden de aceptación, dentro del límite de despliegues simultáneos (3 por defecto).
estado de la operación · vinculación del runapi/product-store.jsobservación: estado del despliegue · historialpantalla web · historial · Insightsapps/dashboard
La pantalla web y las herramientas MCP leen los mismos registros de operación. El último intento y el despliegue verificado actual se muestran por separado, y una tarea de IA terminada no es un despliegue exitoso.

Comprobaciones de CI → publicación de la imagen

El código de plataforma fijado comprueba el commit enviado, solo pasa a la IA los fallos reparables y solo publica las imágenes que vuelven a superar las mismas comprobaciones.

cola de despliegue · 3 a la vezapps/apidatos: source commitcommit de origen · trailersapps/<tenant>/<app>
La fuente enviada se convierte en un commit en el repositorio privado apps (con los trailers Railshot-Request y Railshot-Target), y la rama se actualiza sin force.
cola de despliegue · 3 a la vezapps/apiejecutar · aplicar: workflow_dispatchbucle · comprobaciones base L0–L3railshot-deploy.yml
Solicita una ejecución con tenant, app, source_commit y target_id. Si se pierde la respuesta, no se reenvía; en su lugar se buscan las ejecuciones del mismo commit.
commit de origen · trailersapps/<tenant>/<app>datos: commit enviadobucle · comprobaciones base L0–L3railshot-deploy.yml
Solo se hace checkout del commit enviado y del código de plataforma fijado (PLATFORM_REF).
reparación con SDK · solo fallos reparablesrailshot-deploy.ymldatos: solicitud de reparación · condicionalAI SDK provider
Solo se llama para clases de fallo reparables, y se detiene cuando el mismo fallo se repite o se alcanza el límite de intentos. El aprobado o el fallo lo deciden las comprobaciones, no el LLM.
versión · publicación en GHCR · vinculaciónrailshot-deploy.ymldatos: publicar las imágenes comprobadasGHCR
Tras verificar el bundle que superó las comprobaciones, las mismas imágenes se publican en GHCR. No se reconstruye nada.
vinculación de la ejecución de CI · observaciónapps/apiobservación: lectura de ejecución · publicaciónrailshot-deploy.yml
Una publicación solo cuenta si su run id, commit de origen, destino y app coinciden con el registro aceptado.
vinculación de la ejecución de CI · observaciónapps/apifallo · resultado desconocido: failed · publication_unverifiedestado de la operación · vinculación del runapi/product-store.js
Un fallo de CI o una publicación no verificada se registra con diagnósticos y no se pasa a la CD.

Aplicar → comprobación pública

Solo aplica mediante el Git de config y Argo CD cuando la publicación coincide con el destino registrado, y solo registra el éxito después de que la dirección HTTPS pública registrada pase la comprobación.

versión · publicación en GHCR · vinculaciónrailshot-deploy.ymldatos: images.json · spec · verdict · manifestcd.js · deployPublishedapps/api
La CD lee los archivos del registro de publicación mediante un cargador de confianza. La CI por sí misma no crea recursos de clúster, URL ni éxito de despliegue.
cd.js · deployPublishedapps/apiejecutar · aplicar: aplicar · destino registradoconfig de confianza · destino registradogitops/bridge.py
Ejecuta gitops/bridge.py con la config de confianza solo si la app y el tenant registrados coinciden con el registro de publicación.
commit · push · relectura remotagitops/bridge.pydatos: workload commit · pushRepositorio Git de config
Solo hace commit de workload.json en la ruta registrada de una rama dedicada, registra primero la intención de push, hace push y vuelve a leer la revisión remota. Un push incierto no se repite.
Repositorio Git de configdatos: revisioncomprobación de Application · AppProjectArgo CD
La revisión del repositorio de config a la que apunta la Application de Argo CD.
sync de Argo · observacióngitops/bridge.pyejecutar · aplicar: sync · observarcomprobación de Application · AppProjectArgo CD
Solicita una sync tras comprobar el AppProject; al observar solo lee, sin sync.
comprobación de Application · AppProjectArgo CDejecutar · aplicar: aplicarworkload · ServiceClúster de aplicaciones K3s
Aplica el workload al clúster de destino registrado.
workload · ServiceClúster de aplicaciones K3sdatos: pull de la imagen · digestGHCR
Descarga el digest publicado. Un GHCR privado necesita una credencial de pull dedicada.
sonda HTTPS públicagitops/bridge.pyobservación: HTTPS healthURL HTTPS pública
Solo comprueba la dirección HTTPS de health registrada por el operador, sin redirecciones, esperando un 200 (y el JSON esperado si está definido).
URL HTTPS públicadatos: ruta públicaworkload · ServiceClúster de aplicaciones K3s
La ruta pública (LB, NodePort, certificado) varía según el proveedor y el destino registrado.
cd.js · deployPublishedapps/apidatos: succeeded · revision · URLestado de la operación · vinculación del runapi/product-store.js
Se registra como succeeded solo con cd.deployed, una revisión, una comprobación HTTPS pública exitosa, su hora y una URL válida.
cd.js · deployPublishedapps/apifallo · resultado desconocido: unknown · requiere conciliaciónestado de la operación · vinculación del runapi/product-store.js
Un resultado que no se puede conocer queda como unknown; la misma aplicación no se reenvía ni se revierte.

Observación · no es el veredicto

Las métricas y las sondas no deciden el éxito del despliegue. Los valores ausentes, obsoletos y fallidos se muestran tal cual.

metrics observerapps/apiobservación: consulta PromQLPrometheus
Lee las series up, probe_success y de Pods. Los valores ausentes, obsoletos o fallidos se muestran en ese estado y nunca se convierten en 0.
Prometheusobservación: scrape · probeworkload · ServiceClúster de aplicaciones K3s
Scrape de exporters y sonda HTTP. Estas métricas no se usan para decidir el éxito del despliegue.
estado de la operación · vinculación del runapi/product-store.jsobservación: estado del despliegue · historialpantalla web · historial · Insightsapps/dashboard
La pantalla web y las herramientas MCP leen los mismos registros de operación. El último intento y el despliegue verificado actual se muestran por separado, y una tarea de IA terminada no es un despliegue exitoso.
sonda HTTPS públicagitops/bridge.pyobservación: HTTPS healthURL HTTPS pública
Solo comprueba la dirección HTTPS de health registrada por el operador, sin redirecciones, esperando un 200 (y el JSON esperado si está definido).

Todas las conexiones con el mismo grosor. Elija un flujo para resaltar solo su recorrido, con pasos numerados.

Continua · dirección en que fluyen fuentes, imágenes y solicitudes
Discontinua · solicitud de ejecución, aplicación o sync
Raya larga y punto · lecturas de estado, sondas y métricas, aparte del veredicto
Guion corto · fallo registrado o resultado desconocido
Línea negra gruesa · el flujo seleccionado; los números dan el orden
Recuadro · frontera propietaria, con su ruta de origen en la cabecera
Chip interior · componente de esa frontera
Recuadro discontinuo · fuera de la plataforma
Contorno naranja · donde decide un modelo

API del producto
Registros de despliegue
Frontera de ejecución de CD
Entrada · CI · destino

La imagen del October 2 (bc61a5a) en docs/architecture/README.md es historial de implementación; esta arquitectura sigue el código de 645e28a. Los proveedores y las rutas de red varían según el destino registrado, y esto no significa que todos los proveedores estén siempre activos.

Railshot vocabulary

Enviar → aceptar

Comprobaciones de CI → publicación de la imagen

Aplicar → comprobación pública

Observación · no es el veredicto