¿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
| Palabra | Qué significa |
|---|---|
| Flujo de trabajo | un trabajo cuyos pasos deben ocurrir todos, en orden |
| Diario | una tabla con cada paso terminado y su resultado |
| Número de secuencia | el lugar de un paso en el flujo, contando desde 0 |
| Repetición | tomar el resultado de un paso del diario en vez de ejecutarlo |
| Reanudar | volver 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
docker exec worker python3 order.py order-7 --fresh --crash-after 2Se 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
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
docker exec worker python3 order.py order-7Se 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
docker exec worker python3 order.py order-7Se 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ón | Filas encontradas | Repetidos | Ejecutados |
|---|---|---|---|
| 1, caída tras 2 | 0 | ninguno | 0 y 1 |
| 2, reanudar | 2 | 0 y 1 | 2 y 3 |
| 3, reanudar otra vez | 4 | 0 a 3 | ninguno |
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
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.