¿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

Elegir un motor de ejecución duradera

Después de esta lección: Puedo elegir entre un motor de ejecución duradera y una herramienta más sencilla para un trabajo.

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

¿Qué motor de ejecución duradera conviene usar?

Temporal, Restate, DBOS y las funciones duraderas de AWS Lambda son motores de ejecución duradera. Hacen lo mismo que las cien líneas del laboratorio, para muchos flujos a la vez. Cada uno guarda un diario y lo repite.

Se diferencian en dónde vive el diario y en cómo llega a él tu programa. A veces la respuesta correcta es ninguno.

Al final de esta lección

Nota

Puedo elegir entre un motor de ejecución duradera y una herramienta más sencilla para un trabajo.

Palabras clave

PalabraQué significa
Motorsoftware que ejecuta flujos y guarda sus diarios
Bibliotecacódigo que importas en tu propio programa
Servidorun programa aparte con el que habla tu código
Actividadel nombre que da Temporal a un paso con efectos secundarios
Deterministaque toma las mismas decisiones cada vez que se ejecuta

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

Todo motor guarda un diario y lo repite

El motor del laboratorio son dos archivos: un cliente de PostgreSQL y el propio motor. Tiene la idea completa: un paso se ejecuta una vez, su resultado se anota y una nueva ejecución lo repite.

Un motor real añade lo que el laboratorio deja fuera. Muchos workers se reparten el trabajo, unas colas lo distribuyen y los temporizadores despiertan solos. Hay herramientas para cambiar el código y una página web para vigilarlo todo.

Cuenta las líneas del motor del laboratorio

Comando
docker exec worker wc -l pg.py engine.py

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

Ejemplo resuelto: dónde guarda cada uno el diario

MotorDónde vive el diarioCómo llega a él tu código
Temporalla base de datos propia del servicio Temporaltus workers piden trabajo a una cola de tareas
Restateel registro del servidor Restateel servidor llama a tus manejadores
DBOStu propio PostgreSQLuna biblioteca dentro de tu programa
Funciones duraderas de AWS Lambdalo guarda AWS para la funciónpasos y esperas en el código de la función
Este laboratoriouna tabla de diario en PostgreSQLuna biblioteca, engine.py

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

El código del flujo debe ser determinista

Temporal divide un programa en dos. El código del flujo decide qué pasa después y debe ser determinista. Las actividades hacen el trabajo con efectos secundarios, como cobrar una tarjeta.

El motivo es la repetición. Al reanudar se ejecuta otra vez el código del flujo y se empareja cada paso con el diario. Los siguientes Run hacen caer un pedido y lo reanudan con una versión cambiada del código que envía primero el recibo.

Haz caer un pedido con la versión 1

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

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

Reanúdalo con la versión 2

Comando
docker exec worker python3 order.py order-10 --v2

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 cambia el código de un flujo mientras hay ejecuciones a medias. Esas ejecuciones repiten su diario contra el código nuevo, y un orden de pasos cambiado ya no coincide. Cambia el código solo con una comprobación de versión, o deja antes que terminen las ejecuciones viejas.

Pruébalo: ¿qué cambio es seguro?

Código: python
journal = ["reserve_stock", "charge_card"]   # escrito por la versión 1

version_1 = ["reserve_stock", "charge_card", "send_receipt", "book_courier"]
version_2 = ["reserve_stock", "send_receipt", "charge_card", "book_courier"]

def check(code):
    for seq in range(len(journal)):
        if journal[seq] != code[seq]:
            return "se detiene en el paso " + str(seq)
    return "repite y sigue en el paso " + str(len(journal))

print("versión 1:", check(version_1))
print("versión 2:", check(version_2))
# Haz que version_2 añada en cambio un paso nuevo al final, y vuelve a ejecutarlo.

Cuándo no necesitas un motor

Un motor es una cosa más que ejecutar, aprender y mantener al día con tu código. Un trabajo de un solo paso que se puede repetir sin riesgo necesita un reintento simple.

Un trabajo cuyos efectos son todos idempotentes puede ir en una cola que entrega al menos una vez. Usa un motor cuando un trabajo tiene varios pasos con efectos, espera horas o días, o debe deshacer lo que hizo.

Ejemplo resuelto: tres trabajos, tres herramientas

TrabajoQué necesitaUna buena opción
Redimensionar una foto subidaun paso, repetible sin riesgoun reintento simple
Enviar cada pedido nuevo a un almacén, con el pedido como clavelas repeticiones no hacen dañouna cola con reintentos
Tramitar un pedido, cobrar, esperar stock días, reembolsar si fallapasos, esperas largas, deshacerun motor duradero

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

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.