Plazo de entrega de cambios
tiempo desde el commit hasta el despliegue en producción
Qué es
El plazo de entrega de cambios es el tiempo que pasa desde que un cambio queda registrado como commit en el control de versiones hasta que se despliega en producción. DORA utiliza ese intervalo para describir el flujo de entrega de software. Cuenta tanto el trabajo como la espera entre pasos. Si alguien registra un cambio el lunes por la mañana y el despliegue termina el martes por la tarde, se incluyen la noche y el tiempo que el cambio estuvo a la espera de revisión o publicación.
El inicio es el commit registrado. El tiempo desde la petición de un cliente, desde el comienzo de la programación o hasta la activación de una función responde a otras preguntas. El código puede desplegarse en producción con una función desactivada. La fecha del despliegue y la fecha en la que los usuarios acceden se pueden registrar como hechos distintos. Acordad qué significa que el despliegue termina si el servicio llega a varias regiones o si el tráfico se amplía por etapas.
Empieza por un servicio. Define sus destinos de producción y los cambios de código incluidos en la medida. Asocia cada cambio al primer despliegue que lo contenga y cumpla los criterios. Puede que el historial guarde solo el commit que reúne varias modificaciones. Si la medida comienza en ese momento, deja fuera el tiempo anterior de revisión. Documenta la decisión para que sea posible interpretar los números y compararlos con mediciones futuras.
Por qué importa
El trabajo suele dejar señales más visibles que una espera. Si compilar lleva seis minutos y la modificación pasa dos días esperando una ventana de despliegue, acelerar el compilador cambia poco el total. Registra algunas transiciones: revisión completada, paquete construido, comprobación en preproducción, aprobación y despliegue. Con las fechas de varios cambios, el equipo ya puede detectar dónde se acumula el trabajo.
La métrica sirve para investigar cómo entrega el equipo. Una corrección pequeña y una modificación que afecta a varios servicios tienen condiciones distintas. Comparar personas puede premiar las tareas fáciles o animar a retrasar el registro del código. Observa el mismo servicio antes y después de una modificación concreta del proceso. Revisa los casos lentos además de los habituales y mira qué pasó con los fallos y la recuperación.
Un tiempo menor es útil si una corrección importante llega antes a quien la necesita y el circuito sigue detectando defectos. DORA combina las medidas de flujo con otras sobre fallos y recuperación. Léelas juntas para saber si acortar una espera ayudó, si desplazó el problema a otra etapa o si trajo un riesgo nuevo. Exige una explicación que se pueda contrastar con cambios y eventos reales.
Cómo se aplica en la práctica
El caso de automatización del despliegue de software SIG describe un proceso manual de prueba, compilación y despliegue que pasó a ejecutarse con GitHub Actions. La ficha documenta un ciclo de publicación más corto y una configuración repetible. No publica tiempos de commits concretos. Si un equipo quiere medir esos tiempos en un proceso similar, puede relacionar los registros de versiones con los eventos de despliegue.
Supón que un servicio tiene dos commits, uno a las 09:00 y otro a las 10:30. Un paquete con ambos cambios queda funcionando en producción a las 14:00. Los intervalos son de cinco horas y de tres horas y media. Si el paquete estuvo en preproducción a mediodía, esa hora ayuda a explicar el recorrido. La llegada a producción cierra la medida. Un intento de compilación que falló antes también es útil para el diagnóstico.
Empieza por unos pocos registros que otro miembro del equipo pueda verificar. Conserva el listado de revisiones, el identificador del paquete, el entorno y la hora en que se confirmó el despliegue. Contrasta esas fechas con el historial. Si el repositorio contiene varios servicios, identifica el servicio afectado por cada evento. Revisa una muestra cada vez que cambien el flujo de trabajo o la herramienta de publicación.
Git guarda campos distintos para la fecha del autor y la de quien registra el commit. Una reescritura del historial puede mover una sin cambiar la otra. Declara el campo empleado, unifica zonas horarias e investiga intervalos negativos. Volver a desplegar un paquete durante una recuperación tampoco cambia la primera llegada a producción.
Dónde surgen los problemas
Que acabe un trabajo automatizado puede significar que envió una orden a otro sistema. Los procesos nuevos aún pueden estar arrancando. Define si el final exige comprobar que el software funciona en producción o que una proporción fijada del tráfico llega a la versión nueva. Usa esa convención para el mismo servicio y registra cualquier cambio en la definición.
El informe puede perder de vista lo que nunca llegó a producción. Un cambio abandonado carece de fin y otro puede seguir esperando. Registra por separado el número y la antigüedad de los cambios pendientes. Si un paquete no puede vincularse a un commit, informa de cuántas observaciones quedan sin medir. Un valor de cero daría a entender que no hubo espera.
Una media puede disimular una cola larga. Muestra un valor típico, un indicador de los casos lentos y el número de observaciones. Si hay pocos datos, revisa los recorridos individuales para entenderlos. Cuando un paso acumula la mayor parte de la espera, prueba una mejora en ese paso y mide después el mismo servicio con la misma definición.
Lecturas adicionales
- Guía de DORA sobre métricas de entrega de software define el plazo de entrega de cambios.
- Guía de DORA para representar el flujo de valor explica cómo observar trabajo, esperas y traspasos.
- Documentación de Git sobre formatos de commits distingue los campos temporales disponibles.
- DORA sobre automatización del despliegue explica cómo repetir los eventos de despliegue.