Temporal¶

En este artículo

• Temporal. Funcionalidades principales
• Funcionalidades de implementación
• Primeros pasos tras implementar Temporal
• Pantalla de inicio y navegación
• Probar Temporal con Go (Opcional)
• Realizar un pedido de un servidor Temporal vía API

Temporal. Funcionalidades principales¶

• Orquestación de flujos de trabajo (Workflow Orchestration): Proporciona una ejecución robusta de procesos de negocio de larga duración. Gestiona automáticamente los fallos y los reintentos, garantizando la finalización de las tareas.
• Transacciones distribuidas: Garantiza la ejecución consistente de operaciones entre diferentes servicios sin necesidad de utilizar bloqueos distribuidos.
• Tiempos de espera y programación (Timeouts and Scheduling): Permite establecer temporizadores y programar tareas con alta precisión, incluso para procesos largos.
• Escalabilidad: Admite el escalado horizontal para manejar altas cargas. Los componentes pueden escalarse de forma independiente.
• Depuración histórica (Historical Debugging): Preserva el historial de ejecución de los procesos, lo que permite el análisis y la depuración de los flujos de trabajo.
• Versionado: Admite actualizaciones seguras de los flujos de trabajo sin interrumpir las tareas en ejecución.
• Observabilidad: Se integra con sistemas de monitorización y trazado para el control de la aplicación.
• Multi-tenancy: Proporciona aislamiento y gestión de recursos para múltiples equipos o aplicaciones.

Funcionalidades de implementación¶

Primeros pasos tras implementar Temporal¶

Tras el pago, se enviará una notificación sobre la disponibilidad del servidor a su dirección de correo electrónico registrada. Incluirá la dirección IP del VPS y las credenciales de acceso. Los clientes de nuestra empresa gestionan el hardware a través del server management panel and API — Invapi.

Tras seguir el enlace de la etiqueta webpanel, se abrirá una ventana de autorización.

Los datos de autorización pueden encontrarse en la pestaña "Configuration" >> Tags del panel de gestión del servidor o en el correo electrónico enviado:

• Enlace para acceder al panel de gestión de Temporal mediante interfaz web: en la etiqueta webpanel;
• Login y Password para gestionar el servidor: se proporcionan en un correo electrónico tras la entrega del servidor.

Componentes principales con interfaz web:

Pantalla de inicio y navegación¶

Tras seguir el enlace de la etiqueta webpanel, se abrirá la interfaz web de Temporal:

La pantalla principal muestra una lista de flujos de trabajo (Workflows) en el namespace seleccionado. El mensaje "No Workflows running in this Namespace" indica la ausencia de procesos activos en ese momento.

Elementos principales de la interfaz:

• Sidebar a la izquierda proporciona acceso a las diferentes secciones del sistema;
• Top bar muestra el namespace actual (por defecto, "default");
• Botón Start Workflow en la esquina superior derecha para iniciar nuevos procesos;
• Process table con columnas Status, Workflow ID, Run ID, Type, Start, End.

Capacidades funcionales

1. Iniciar un nuevo proceso de flujo de trabajo (Workflow Process):

   • Haga clic en el botón Start Workflow en la esquina superior derecha;
   • Complete los parámetros necesarios en el formulario que aparece;
   • Confirme la creación del proceso.

2. Visualización y filtrado de procesos:

   • Utilice el botón Filter para seleccionar procesos basados en varios criterios;
   • Elija cualquier proceso de la tabla para ver información detallada.

3. Ejemplos de código:

   • Acceda a los ejemplos de integración mediante los enlaces al repositorio de GitHub:
   • samples-go - Ejemplos en Go;
   • samples-java - Ejemplos en Java;
   • samples-typescript - Ejemplos en TypeScript;
   • samples-python - Ejemplos en Python;
   • samples-dotnet - Ejemplos en .NET;
   • samples-php - Ejemplos en PHP.

4. Cambiar la configuración:

   • Selector de UTC en la esquina superior derecha para cambios de zona horaria;
   • El botón (Gear) está destinado a acceder a los ajustes adicionales de la interfaz.

Casos de uso típicos:

• Monitorización de procesos: Comprobación regular del estado de las tareas en ejecución;
• Depuración: Análisis detallado de errores en caso de fallos;
• Gestión de cargas de trabajo: Iniciar, pausar y cancelar procesos;
• Desarrollo de nuevos procesos: Uso de ejemplos de código para crear flujos de trabajo personalizados.

Probar Temporal con Go (Opcional)¶

1. Instalar Go¶

Antes de comenzar las pruebas, instale Go en el servidor:

Actualizar las listas de paquetes

apt update

apt install -y wget git curl

wget https://golang.org/dl/go1.22.1.linux-amd64.tar.gz

tar -C /usr/local -xzf go1.22.1.linux-amd64.tar.gz

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc

echo 'export GOPATH=$HOME/go' >> ~/.bashrc

echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bashrc

source ~/.bashrc

go version

2. Clonar el repositorio de ejemplos de Temporal¶

Ir al directorio personal (home)

cd ~

git clone https://github.com/temporalio/samples-go.git

cd samples-go

3. Probar utilizando el ejemplo Saga¶

El patrón Saga se utiliza para la gestión de transacciones distribuidas, garantizando la capacidad de revertir (compensar) en caso de errores.

Estructura del ejemplo Saga

saga/
├── worker/main.go     # Proceso Worker que gestiona las tareas
├── start/main.go      # Inicializa el proceso worker
├── activity.go        # Definición de acciones (retirar/depositar fondos)
├── workflow.go        # Definición de la secuencia de acciones
└── shared.go          # Definiciones comunes

Ejecutar la prueba:

1. Iniciar el worker (ejecutar en la primera terminal):

   cd ~/samples-go
   go run saga/worker/main.go
   

   El worker se registrará con Temporal y esperará una tarea. Aparecerán mensajes de log sobre los intentos de obtener tareas.

2. Iniciar el starter (ejecutar en la segunda terminal):

   cd ~/samples-go
   go run saga/start/main.go
   

   El starter inicia el proceso de transferencia de dinero de una cuenta a otra.

Resultado esperado:

En los logs del worker, verá:

1. Retiro de dinero de la cuenta 001-001;
2. Depósito de dinero en la cuenta 002-002;
3. Un error creado específicamente en la actividad StepWithError;
4. Tres intentos de ejecutar la actividad con error;
5. Ejecución de las acciones compensatorias:
   • Devolución de fondos a la cuenta original;
   • Cancelación del retiro de dinero.

4. Verificar los resultados mediante la interfaz web de Temporal¶

1. Abra la interfaz web de Temporal en su navegador (a través de la etiqueta webpanel);
2. En la interfaz, busque el workflow con ID transfer-money-workflow;
3. Verá el historial completo de ejecución del workflow, incluyendo todas las actividades y acciones compensatorias:

Realizar un pedido de un servidor Temporal vía API¶

Para instalar este software utilizando la API, siga esta instrucción.