Padrões de Orquestração de Workflow

Domine a arquitetura de orquestração de workflow com Temporal, cobrindo decisões fundamentais de design, padrões de resiliência e melhores práticas para construir sistemas distribuídos confiáveis.

Quando Usar Orquestração de Workflow

Casos de Uso Ideais (Fonte: docs.temporal.io)

• Processos de múltiplas etapas que abrangem máquinas/serviços/bancos de dados
• Transações distribuídas que exigem semântica de tudo ou nada
• Workflows de longa duração (horas a anos) com persistência automática de estado
• Recuperação de falhas que devem continuar a partir do último passo bem-sucedido
• Processos de negócios: reservas, pedidos, campanhas, aprovações
• Gerenciamento de ciclo de vida de entidades: rastreamento de inventário, gerenciamento de contas, fluxos de trabalho de carrinho
• Automação de infraestrutura: pipelines de CI/CD, provisionamento, implantações
• Sistemas human-in-the-loop que exigem timeouts e escalonamentos

Quando NÃO Usar

• Operações CRUD simples (use chamadas diretas de API)
• Pipelines de processamento de dados puros (use Airflow, processamento em lote)
• Requisição/resposta sem estado (use APIs padrão)
• Streaming em tempo real (use Kafka, processadores de eventos)

Padrões Detalhados e Exemplos Trabalhados

A documentação detalhada de padrões está em references/details.md. Leia esse arquivo quando o nível de navegação acima for insuficiente.

Melhores Práticas

Design de Workflow

1. Mantenha workflows focados - Responsabilidade única por workflow
2. Workflows pequenos - Use child workflows para escalabilidade
3. Limites claros - Workflow orquestra, atividades executam
4. Teste localmente - Use ambiente de teste com "time-skipping"

Design de Atividade

1. Operações idempotentes - Seguro para retentar
2. De curta duração - Segundos a minutos, não horas
3. Configuração de timeout - Sempre defina timeouts
4. Heartbeat para tarefas longas - Relate o progresso
5. Tratamento de erros - Distinga entre erros que podem ser retentados e os que não podem

Armadilhas Comuns

Violações de Workflow:

• Usar datetime.now() em vez de workflow.now()
• Threading ou operações assíncronas no código do workflow
• Chamar APIs externas diretamente do workflow
• Lógica não determinística em workflows

Erros de Atividade:

• Operações não idempotentes (não podem lidar com retentativas)
• Timeouts ausentes (atividades rodam para sempre)
• Nenhuma classificação de erro (validar erros de retentativa)
• Ignorar limites de payload (2MB por argumento)

Considerações Operacionais

Monitoramento:

• Duração da execução do workflow
• Taxas de falha de atividade
• Tentativas de retentativa e backoff
• Contagem de workflows pendentes

Escalabilidade:

• Escalonamento horizontal com workers
• Particionamento de fila de tarefas
• Decomposição de child workflow
• Agrupamento de atividades quando apropriado

Recursos Adicionais

Documentação Oficial:

• Conceitos Essenciais do Temporal: docs.temporal.io/workflows
• Padrões de Workflow: docs.temporal.io/evaluate/use-cases-design-patterns
• Melhores Práticas: docs.temporal.io/develop/best-practices
• Padrão Saga: temporal.io/blog/saga-pattern-made-easy

Princípios Chave:

1. Workflows = orquestração, Atividades = chamadas externas
2. Determinismo é inegociável para workflows
3. Idempotência é crítica para atividades
4. Preservação de estado é automática
5. Projetar para falha e recuperação