Conceptos

Conceptos

Equipo, servidor, app, procesos, complementos y entornos, y cómo se conectan entre sí.

Un mapa rápido de los términos que verás en todo el panel y en esta documentación.

Equipo

Todo pertenece a un equipo: sus servidores, apps, bases de datos, credenciales de nube e historial. Los miembros tienen un rol (lector, deployer, admin, propietario). Consulta Equipos, SSO y acceso.

Servidor

Un servidor es una máquina donde corren tus apps. Railyard puede crear uno en tu propia cuenta de DigitalOcean, Vultr, Hetzner, AWS u OVH, o puedes conectar cualquier máquina Ubuntu por SSH. De cualquier forma, Railyard instala Docker, un proxy de enrutamiento y un pequeño agente que recibe instrucciones del control plane y corre tus contenedores. Tú posees el servidor y tu proveedor te cobra directamente. Consulta Agrega un servidor.

Un servidor también puede dedicarse a una sola tarea: un servidor de build para builds pesados, o un servidor de base de datos que solo almacena datos. Consulta Servidores de base de datos.

App

Una app es una unidad desplegable: un repositorio, una imagen de Docker, un sitio estático o una función. Pega la URL de un repositorio o elige una imagen, y Railyard la lee para completar el framework, el puerto, los procesos y las variables. Consulta Desplegar desde un repositorio y Desplegar una imagen de Docker.

Procesos

Una app puede correr varios procesos desde la misma imagen:

  • web — atiende el tráfico HTTP, en el puerto que escucha tu app.
  • workers — ejecutan trabajos en segundo plano (Sidekiq, Solid Queue, Celery…), y se escalan de forma independiente al web.
  • comando de release — corre una vez antes de que la nueva versión reciba tráfico, normalmente migraciones.
  • cron — un comando que corre en un horario, con historial de ejecuciones.

Consulta Workers y trabajos programados.

Complementos y bases de datos

Postgres, MySQL, Redis, MongoDB, ClickHouse, Elasticsearch y más se pueden aprovisionar en un servidor, con credenciales inyectadas automáticamente en la app. Consulta Bases de datos y copias de seguridad.

Entornos

Un proyecto agrupa apps relacionadas. Un entorno (producción, staging…) es una copia completa de un proyecto, creada desde el canvas. Una vista previa de pull request es una copia temporal de una app para un PR abierto, que se elimina cuando el PR se cierra. Consulta Entornos y vistas previas.

Despliegues y releases

Un despliegue construye (o descarga) una imagen, corre el comando de release y luego cambia el tráfico a la nueva versión en cuanto está en buen estado. Cada despliegue exitoso se convierte en un release al que puedes volver con un rollback. Consulta Despliegues y rollbacks.

Dominios

Cada app obtiene una URL funcional desde el inicio; agrega tu propio dominio con verificación de propiedad y un certificado automático. Consulta Dominios y HTTPS.