¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Fundamentos de la ejecución duradera

La lección completa es gratis e interactiva. Léela aquí, o pulsa Iniciar laboratorio para practicarla de verdad en un laboratorio en vivo, sin cuenta.

Laboratorio de contenedores12 min de lectura9 comandos

¿Y si el servidor muere a mitad?

Una tienda tramita tu pedido: reserva el stock, cobra tu tarjeta, te envía un recibo y reserva un mensajero. ¿Y si el servidor muere justo después del cobro? Si vuelves a lanzar el trabajo desde arriba, pagas dos veces. La ejecución duradera es la forma en que los trabajos largos sobreviven a una caída: cada paso terminado se anota, así que una nueva ejecución sigue en lugar de empezar de cero.

Al final de esta lección

Nota

Puedo explicar cómo un diario de pasos terminados permite a un flujo caído seguir sin hacer ningún paso dos veces.

Palabras clave

  • Flujo de trabajo: un trabajo hecho de pasos que deben ocurrir todos, en orden.
  • Paso: una parte del trabajo, como cobrar una tarjeta.
  • Diario: una tabla donde se anota cada paso terminado y su resultado.
  • Repetición: leer el resultado de un paso en el diario en vez de ejecutarlo otra vez.
  • Clave de idempotencia: un nombre para una petición, para que hacerla dos veces tenga el efecto de una.
  • Saga: un flujo que deshace sus pasos terminados cuando falla uno posterior.

Para empezar: lo que ya sabes

Nota

Responde mentalmente. 1. ¿Qué guarda una tabla de una base de datos? 2. ¿Qué les pasa a las variables de un programa cuando su proceso se detiene? 3. ¿Por qué una tienda da un número a cada pedido? Respuestas: filas de datos; se pierden; para poder encontrar ese pedido y hablar de él.

Antes de empezar

Nota

Pulsa Iniciar el laboratorio en la barra de arriba de la lección y espera a que diga que está en marcha. Hay dos contenedores. worker ejecuta el Python y db es PostgreSQL. El terminal llega a ellos con docker exec, que ejecuta una orden dentro de un contenedor. Cada botón Ejecutar de abajo escribe su orden en el terminal de tu laboratorio, una detrás de otra en la misma sesión. Para verlas o escribir las tuyas, pulsa Abrir el terminal en la barra.

1. Un trabajo simple vuelve a empezar desde arriba

El primer Run es el trabajo del pedido sin diario, preparado para caer justo después de cobrar la tarjeta. Imprime dos líneas done y luego la línea de la caída. El segundo Run es el reintento: empieza desde arriba y vuelve a cobrar. El tercero pide a PostgreSQL los pagos de order-1, y hay 2 filas de 2500. El cliente pagó dos veces.

Comando
docker exec worker python3 naive.py order-1 --fresh --crash-after charge_card

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Comando
docker exec worker python3 naive.py order-1

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Comando
docker exec db psql -U durable -c "SELECT workflow, amount FROM payments WHERE workflow = 'order-1'"

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

2. Un diario recuerda cada paso terminado

order.py es el mismo pedido, escrito con el motor. Tras cada paso, el motor anota el paso y su resultado en la tabla journal. Este Run cae tras 2 pasos nuevos. El diario tiene entonces 2 filas: el paso 0 es reserve_stock y el paso 1 es charge_card, cada uno con su resultado.

Comando
docker exec worker python3 order.py order-7 --fresh --crash-after 2

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Comando
docker exec db psql -U durable -c "SELECT seq, step, result FROM journal WHERE workflow = 'order-7' ORDER BY seq"

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

3. Reanudar repite el diario y sigue

Ejecuta otra vez el mismo flujo, sin opciones. Encuentra 2 filas en el diario, así que imprime replay para los pasos 0 y 1 y toma sus resultados de las filas. Solo los pasos 2 y 3 se ejecutan de verdad. La tarjeta se cobró una vez.

Comando
docker exec worker python3 order.py order-7

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Comprueba

Consejo

¿Por qué la segunda ejecución de order.py no volvió a cobrar la tarjeta? Respuesta: el paso 1, charge_card, ya tenía una fila en el diario, así que el motor repitió su resultado en vez de ejecutarlo.

4. Una clave de idempotencia hace inofensiva una repetición

Queda un hueco: una caída después del cobro pero antes de su fila en el diario. El primer Run cae justo ahí. La nueva ejecución no tiene fila para el cobro, así que cobra otra vez. Con --keyed el cobro lleva la clave order-9:charge_card, y el proveedor de tarjetas acepta un solo pago por clave: la segunda respuesta dice "repeat": true y no se cobra nada más.

Comando
docker exec worker python3 order.py order-9 --fresh --keyed --crash-inside charge_card

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Comando
docker exec worker python3 order.py order-9 --keyed

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

5. Una saga deshace lo hecho

Un viaje necesita un vuelo, un hotel y un coche. Este Run hace que falle el coche. El motor anota también el fallo y luego ejecuta las compensaciones de la más reciente a la más antigua: cancel_hotel y después cancel_flight. La última línea dice que no queda nada reservado.

Comando
docker exec worker python3 saga.py trip-2 --fresh --fail-at book_car

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Un error frecuente

Advertencia

Mucha gente cree que basta un diario para que cada efecto ocurra exactamente una vez. No es así: una caída entre un efecto y su fila del diario repite ese efecto en la nueva ejecución. Exactamente una vez necesita las dos mitades: el diario, para no rehacer los pasos terminados, y una clave de idempotencia, para que un efecto repetido se ignore.

Comprobación final

Consejo

Responde sin mirar atrás. 1. ¿Dónde anota el motor un paso terminado? 2. ¿Qué hace una nueva ejecución con un paso que tiene fila? 3. ¿Qué caída puede repetir aún un efecto? 4. ¿Qué hace una saga cuando falla un paso? Respuestas: en la tabla del diario; repite su resultado; una después del efecto y antes de su fila; deshace los pasos terminados, del más reciente al más antiguo.

Para docentes

Consejo

Esta lección es un pequeño ejemplo de lección que se hace en un laboratorio: los pasos y los botones Ejecutar son la lección, y el laboratorio es la copia de cada estudiante. El laboratorio son dos servicios, PostgreSQL y un worker de Python con un motor de unas cien líneas, y nada aquí se corrige solo: el estudiante entrega un flujo propio, una ejecución caída, su reanudación y las filas del diario. Puntos clave: 1. Un trabajo sin diario repite sus pasos tras una caída. 2. Un diario permite a una nueva ejecución repetir los pasos terminados y seguir. 3. Una clave de idempotencia cierra el hueco entre un efecto y su fila. Error frecuente: creer que el diario solo da exactamente una vez. Material: el laboratorio y su terminal. Consejo: pide que predigan qué líneas dirán replay antes de cada nueva ejecución. Cópiala en tu propio módulo y modifícala, o crea una desde cero con el menú Laboratorio del constructor de lecciones.

Sobre este laboratorio y su código: Laboratorio de ejecución duradera: haz caer un flujo a propósito y reanúdalo desde su diario

¿Enseñas a una clase? Asigna estas lecciones a tus estudiantes con calificación y un laboratorio para cada uno.