Entornos local, staging y producción
Local / Staging / Production
¿Qué es local?
- Local (mi PC) → Staging (pruebas) → Producción (uso real)
- Implementación por etapas, con seguridad
- Producción es para los usuarios reales
La verdadera razón para separar los entornos no es hacer una prueba más, sino adelantar el momento en que se detecta el problema. Un error detectado en local lo corrige un desarrollador en diez minutos; si el mismo error estalla en producción, arrastra consultas al centro de atención, reembolsos e informes posteriores. Un equipo con un solo entorno tiene una única oportunidad para corregir; un equipo que lo divide en tres etapas tiene tres oportunidades para filtrar el mismo error. Con esto, el despliegue no se vuelve más lento: lo que se abarata es revertir los cambios.
El número de etapas varía según el tamaño de la organización. Con 3 a 5 desarrolladores bastan 3 etapas: local, staging y producción. Con más de 20 personas, lo habitual son 4 o 5 etapas, separando desarrollo (dev), QA y staging. Pero lo esencial no es la cantidad, sino cuánto se parece el staging a producción. Si difieren las especificaciones del servidor, la versión de la base de datos, las cuentas de prueba de las APIs externas de pagos o envíos, o la cantidad de datos, pasar las pruebas en staging se convierte en un mero trámite. Al usar datos de producción para las pruebas, lo correcto es enmascarar los números de identificación personal, los contactos y los datos de tarjetas antes de trasladarlos. Las claves de API y los datos de acceso a la base de datos no deben estar en el código, sino en las variables de entorno o en un almacén de secretos.
En el terreno, la frase que más se escucha es «en mi local sí funcionaba». Por lo general, significa que dependía de archivos de configuración o datos temporales que solo existían en local, así que el éxito en local no es una verificación. Más peligroso aún es el criterio de «solo esta vez lo corrijo directamente en producción»: esa única línea se sobrescribe en la siguiente implementación, y después no hay forma de rastrear la causa. Tener un staging que nadie mantiene también es una trampa común: si las versiones de las bibliotecas llevan medio año de atraso, el staging puede pasar las pruebas sin garantizar nada. Por último, conectarse desde la PC local directamente a la base de datos de producción es una práctica que, con un solo error de tipeo en una cláusula condicional, termina borrando datos reales.
Jaryong KooDoctor en marketing y referente en análisis de datos con IA y en marca personal
John KimAutor de «Diseño de marketing B2B» y CEO de Nanum ConsultoríaPara reducir los riesgos de la distribución de software, se consolidó la práctica de separar los entornos de desarrollo, prueba y producción; junto con la nube y CI/CD, se convirtió en estándar.
Veamos un caso hipotético: la empresa A, un distribuidor de alimentos en línea con 320 colaboradores. Durante tres años, su equipo de 6 desarrolladores sobrevivió modificando el código directamente en los servidores de producción, sin staging. Solo en el último trimestre hubo 4 fallas en el sistema de pagos, y la del viernes por la noche tardó 2 horas y 20 minutos en recuperarse, lo que provocó la cancelación de 1,100 pedidos.
- El CTO, con el informe del incidente sobre la mesa, dijo que «lo más grave es que nadie puede explicar la causa», y prohibió a partir de ese día modificar directamente los servidores de producción.
- El líder de backend levantó en dos semanas un servidor de staging con las mismas especificaciones que producción; las conexiones con pagos y transportistas se hicieron con cuentas de prueba, y los 120,000 registros de clientes se trasladaron con nombres y teléfonos enmascarados.
- Se retiraron del código 17 contraseñas de base de datos de producción y claves de API que estaban escritas a mano, y se pasaron a variables de entorno. Además, de las cuentas que se conectaban a la base de producción desde PCs locales, solo se mantuvo la de un DBA; todas las demás se revocaron.
- Cambiaron el pipeline de despliegue para que el botón de publicación en producción solo se active cuando el responsable de QA ejecute en staging los 32 escenarios de pagos, reembolsos y liquidaciones y deje registrados los resultados aprobados.
- Seis meses después, las fallas de pagos bajaron de 4 por trimestre a 0, el tiempo medio de recuperación pasó de 2 horas y 20 minutos a 18 minutos, y las implementaciones aumentaron de 1 a 3 por semana.