Melhores Práticas de Desenvolvimento com Celery
Framework abrangente de processamento de tarefas em segundo plano com mais de 60 regras priorizadas em 21 categorias para construir sistemas de tarefas distribuídos confiáveis e escaláveis com Celery.
Quando Aplicar
Consulte estas diretrizes quando:
- Implementar processamento de tarefas em segundo plano
- Configurar filas de trabalho distribuídas
- Configurar tarefas periódicas com Celery Beat
- Otimizar o desempenho e a confiabilidade das tarefas
- Monitorar e depurar aplicações Celery
- Implementar roteamento de tarefas e manipulação de resultados
- Gerenciar workers e brokers do Celery
- Garantir a segurança em ambientes de tarefas distribuídas
- Projetar fluxos de trabalho complexos com primitivas Canvas
- Lidar com serialização e transmissão de dados
- Implantar o Celery em ambientes de produção
Categorias de Regras por Prioridade
| Prioridade | Categoria | Regras | Impacto | Prefixo |
|---|---|---|---|---|
| 1 | Configuração & Setup | 2 | CRÍTICO | config- |
| 2 | Definição & Execução de Tarefas | 3 | CRÍTICO | task- |
| 3 | Tratamento de Erros & Confiabilidade | 1 | ALTO | error- |
| 4 | Canvas: Projetando Workflows | 4 | ALTO | canvas- |
| 5 | Monitoramento & Logging | 2 | ALTO | monitoring- / perf- |
| 6 | Performance & Escalabilidade | 2 | MÉDIO-ALTO | perf- |
| 7 | Segurança | 1 | MÉDIO-ALTO | security- |
| 8 | Backends de Resultados | 2 | MÉDIO-ALTO | result- |
| 9 | Roteamento & Filas | 1 | MÉDIO | routing- |
| 10 | Tarefas Periódicas | 1 | MÉDIO | periodic- |
| 11 | Serialização | 1 | MÉDIO | serial- |
| 12 | Gerenciamento de Workers | 1 | MÉDIO | worker- |
| 13 | Sinais e Eventos | 1 | MÉDIO | signals- |
| 14 | Controle Remoto e Inspeção | 1 | MÉDIO | remote- |
| 15 | Testando Aplicações Celery | 1 | MÉDIO-ALTO | testing- |
| 16 | Daemonização e Gerenciamento de Processos | 1 | MÉDIO | daemonization- |
| 17 | Depurando Aplicações Celery | 1 | ALTO | debugging- |
| 18 | Extensões e Customização de Bootsteps | 1 | BAIXO | extensions- |
| 19 | Padrões Avançados | 1 | BAIXO | advanced- |
Referência Rápida
1. Configuração & Setup (CRÍTICO)
config-broker-setup: Configure corretamente o message broker (Redis/RabbitMQ)config-environment-separation: Separe configurações para diferentes ambientes
2. Definição & Execução de Tarefas (CRÍTICO)
task-calling-methods: Escolha métodos de chamada apropriados (delay/apply_async/call)task-atomic-operations: Garanta que as tarefas sejam atômicas e idempotentestask-options-configuration: Configure o comportamento e as opções de confiabilidade das tarefas
3. Tratamento de Erros & Confiabilidade (ALTO)
error-retry-strategy: Implemente mecanismos inteligentes de repetição
4. Canvas: Projetando Workflows (ALTO)
canvas-chain-workflows: Execução sequencial de tarefas e propagação de erroscanvas-group-parallel: Execução paralela de tarefas para desempenhocanvas-chord-synchronization: Workflows complexos com execução paralela e sincronizaçãocanvas-map-starmap: Processamento eficiente em lote e transformações de dados
5. Monitoramento & Logging (ALTO)
monitoring-task-tracking: Acompanhe a execução e o desempenho das tarefasperf-monitoring-metrics: Otimização de desempenho e detecção de problemas
6. Performance & Escalabilidade (MÉDIO-ALTO)
perf-concurrency-tuning: Otimize as configurações de concorrência do worker
7. Segurança (MÉDIO-ALTO)
security-task-authentication: Previna a execução não autorizada de tarefas
8. Backends de Resultados (MÉDIO-ALTO)
result-backend-selection: Escolha o backend de resultados apropriadoresult-expiry-management: Gerencie políticas de expiração de resultados
9. Roteamento & Filas (MÉDIO)
routing-task-distribution: Roteamento inteligente de tarefas e gerenciamento de filas
10. Tarefas Periódicas (MÉDIO)
periodic-celery-beat: Execução confiável de tarefas agendadas
11. Serialização (MÉDIO)
serial-data-handling: Transmissão e armazenamento confiáveis de dados
12. Gerenciamento de Workers (MÉDIO)
worker-lifecycle-management: Operação confiável do worker e gerenciamento de recursos
13. Sinais e Eventos (MÉDIO)
signals-events-system: Conecte-se a eventos do Celery para monitoramento e extensão
14. Controle Remoto e Inspeção (MÉDIO)
remote-control-inspection: Gerenciamento em tempo de execução e solução de problemas de workers
15. Testando Aplicações Celery (MÉDIO-ALTO)
testing-celery-applications: Estratégias de teste abrangentes para aplicações assíncronas
16. Daemonização e Gerenciamento de Processos (MÉDIO)
daemonization-process-management: Implantação em produção e gerenciamento de serviços
17. Depurando Aplicações Celery (ALTO)
debugging-celery-applications: Solução de problemas eficaz e resolução de problemas
18. Otimização Avançada de Performance (MÉDIO-ALTO)
advanced-performance-optimization: Técnicas de otimização de alta taxa de transferência
19. Extensões e Customização de Bootsteps (BAIXO)
extensions-bootsteps-customization: Customização e extensão avançadas
20. Padrões Avançados (BAIXO)
advanced-task-chaining: Orquestração complexa de workflows
Como Usar
Leia os arquivos de regras individuais para explicações detalhadas e exemplos de código:
rules/config-broker-setup.md # Configuração do broker
rules/task-calling-methods.md # Métodos de execução de tarefas
rules/task-options-configuration.md # Opções de comportamento da tarefa
rules/canvas-chain-workflows.md # Workflows sequenciais
rules/canvas-group-parallel.md # Execução paralela
rules/canvas-chord-synchronization.md # Sincronização complexa
rules/canvas-map-starmap.md # Processamento em lote
rules/monitoring-task-tracking.md # Monitoramento de tarefas
rules/result-backend-selection.md # Armazenamento de resultados
rules/routing-task-distribution.md # Roteamento de tarefas
rules/periodic-celery-beat.md # Tarefas agendadas
rules/serial-data-handling.md # Serialização de dados
rules/signals-events-system.md # Hook de eventos
rules/remote-control-inspection.md # Gerenciamento de workers
rules/testing-celery-applications.md # Estratégias de teste
rules/security-task-authentication.md # Segurança de tarefas
rules/daemonization-process-management.md # Implantação em produção
rules/debugging-celery-applications.md # Solução de problemas
rules/advanced-performance-optimization.md # Ajuste de alta performance
rules/extensions-bootsteps-customization.md # Customização avançada
Cada arquivo de regra contém:
- Nível de impacto e categoria
- Descrição do problema com consequências
- Solução com exemplos de código
- Erros comuns a evitar
- Quando aplicar a regra
Documentação de Referência
Guias detalhados para tópicos complexos:
references/worker-management.md # Implantação e escalabilidade de workers
Guias de referência adicionais planejados: configuração de monitoramento, solução de problemas, padrões Canvas
Documento Compilado Completo
Para o guia completo de melhores práticas do Celery com todas as regras expandidas: AGENTS.md
Suporte a Versões do Celery: Compatível com Celery 4.x, 5.x e 6.x (mais recente)