Mejorar la explicación de las comprobaciones de salud y su impacto en despliegues sin tiempo de inactividad

[O5-PRIME]

• Descripción

Actualmente, la sección Advanced Concepts menciona las comprobaciones de salud, pero no explica explícitamente su impacto directo en el enrutamiento del tráfico ni en la prevención de tiempo de inactividad durante los despliegues.

Varios usuarios pueden no entender que las health checks son un componente clave para garantizar que Railway no dirija tráfico a un despliegue que aún no está listo para manejar solicitudes.

• Contexto

Durante la revisión de la PR que amplía la guía de Advanced Concepts, se señaló que:

Las comprobaciones de salud evitan que el tráfico llegue a despliegues no listos.

Esto permite reemplazar despliegues de forma segura.

El resultado práctico es cero tiempo de inactividad durante despliegues exitosos.

Este comportamiento es una ventaja importante de la plataforma y debería quedar reflejado explícitamente en la documentación.

-Propuesta

Actualizar la sección de Chequeos de salud para incluir:

Una explicación clara de que Railway solo enruta tráfico a despliegues que han pasado las comprobaciones de salud.

Una mención explícita de que esto permite despliegues sin tiempo de inactividad.

Una breve aclaración de que la versión anterior del servicio solo se elimina cuando el nuevo despliegue está confirmado como saludable.Criterios de aceptación

-Criterios de aceptación

1. El texto explica claramente el rol de las comprobaciones de salud en el enrutamiento de tráfico.

2. Se menciona explícitamente el beneficio de zero-downtime deployments.

3. El lenguaje es consistente con el resto de la guía de Advanced Concepts.

4. Se incluyen enlaces a la documentación de referencia de health checks si aplica.

-Ejemplo de código

Ejemplo de un endpoint de health check en un servicio Node.js con Express: -`import express from "express";

const app = express();

app.get("/health", (req, res) => {
// Aquí puedes verificar dependencias como DB, caché, etc.
res.status(200).json({ status: "ok" });
});

app.listen(process.env.PORT || 3000, () => {
console.log("Service running");
});
`