¿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

Un diario de pasos y la repetición

Después de esta lección: Puedo usar un diario de pasos para encontrar dónde debe seguir un flujo que se cayó.

Lección de 60 min4 comandosLaboratorio de ejecución duradera: haz caer un flujo a propósito y reanúdalo desde su diario

¿Cómo sobrevive un flujo a una caída?

La ejecución duradera anota cada paso terminado de un flujo de trabajo en un diario, para que una nueva ejecución pueda seguir tras una caída. El diario es una tabla de una base de datos, que sobrevive al proceso.

Al volver a ejecutar, un paso que tiene fila se repite desde ella, no se ejecuta otra vez. El trabajo real empieza en el primer paso sin fila. El motor del laboratorio lo hace en unas cien líneas.

Al final de esta lección

Nota

Puedo usar un diario de pasos para encontrar dónde debe seguir un flujo que se cayó.

Palabras clave

PalabraQué significa
Flujo de trabajoun trabajo cuyos pasos deben ocurrir todos, en orden
Diariouna tabla con cada paso terminado y su resultado
Número de secuenciael lugar de un paso en el flujo, contando desde 0
Repeticióntomar el resultado de un paso del diario en vez de ejecutarlo
Reanudarvolver a ejecutar un flujo caído para que siga

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

El motor anota cada resultado antes de seguir

En el laboratorio, un flujo es Python normal. Cada paso es una llamada a wf.step con un nombre y una función que ejecutar. El motor da a cada paso un número de secuencia: 0 al primero, 1 al siguiente.

Cuando un paso termina, el motor inserta una fila en la tabla journal: el flujo, el número, el nombre y el resultado. Solo entonces sigue el flujo.

Haz caer el pedido tras dos pasos

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.

Lee las filas del diario de order-7

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.

Reanudar repite las filas que encuentra

Ahora ejecuta el mismo flujo sin opciones. El motor lee primero el diario y encuentra dos filas.

Los pasos 0 y 1 imprimen replay: sus resultados salen de las filas, así que no se reserva ni se cobra otra vez. Los pasos 2 y 3 no tienen fila, así que imprimen run. Ejecutarlo una vez más repite los cuatro pasos y no hace nada nuevo.

Reanuda order-7

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.

Reanuda order-7 una vez más

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.

Ejemplo resuelto: tres ejecuciones de order-7

EjecuciónFilas encontradasRepetidosEjecutados
1, caída tras 20ninguno0 y 1
2, reanudar20 y 12 y 3
3, reanudar otra vez40 a 3ninguno

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Un error frecuente

Advertencia

Mucha gente cree que reanudar salta directamente al paso que falló. En realidad ejecuta todo el flujo otra vez desde arriba, y el motor responde cada paso terminado desde el diario. Así que el código fuera de un paso se ejecuta siempre: pon cada efecto secundario dentro de un paso.

Pruébalo: un diario en un diccionario

Código: python
journal = {}   # en el laboratorio es una tabla de PostgreSQL

def step(seq, name, work):
    if seq in journal:
        print("replay", seq, name, journal[seq])
        return journal[seq]
    result = work()
    journal[seq] = result   # se anota antes de seguir
    print("run   ", seq, name, result)
    return result

def order(crash_after):
    step(0, "reserve_stock", lambda: "2 reservadas")
    step(1, "charge_card", lambda: "2500 cobrados")
    if crash_after == 2:
        print("caída")
        return
    step(2, "send_receipt", lambda: "enviado")

order(crash_after=2)   # la primera ejecución muere tras dos pasos
order(crash_after=0)   # la siguiente repite dos y ejecuta uno
# Cambia la primera llamada a crash_after=0 y compara.

El código debe pedir los mismos pasos

La repetición solo funciona si el código pide los mismos pasos, en el mismo orden, en cada ejecución. El motor del laboratorio compara el nombre de cada paso con su fila y se detiene si no coinciden.

Por eso un flujo no debe decidir según cosas que cambian entre ejecuciones, como el reloj o un número aleatorio. Convierte ese valor en un paso, y su resultado se guarda como cualquier otro.

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 este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.