Celery 개발 모범 사례
확장 가능하고 신뢰할 수 있는 분산 작업 시스템을 구축하기 위한 21개 카테고리, 60개 이상의 우선순위 규칙을 포함한 포괄적인 백그라운드 작업 처리 프레임워크.
적용 시기
다음 상황에서 이 지침을 참조하세요:
- 백그라운드 작업 처리 구현
- 분산 작업 큐 설정
- Celery Beat로 주기적 작업 구성
- 작업 성능 및 안정성 최적화
- Celery 애플리케이션 모니터링 및 디버깅
- 작업 라우팅 및 결과 처리 구현
- Celery 워커 및 브로커 관리
- 분산 작업 환경에서 보안 보장
- Canvas 기본 요소를 사용한 복잡한 워크플로우 설계
- 직렬화 및 데이터 전송 처리
- 프로덕션 환경에 Celery 배포
우선순위별 규칙 카테고리
| 우선순위 | 카테고리 | 규칙 수 | 영향 | 접두사 |
|---|---|---|---|---|
| 1 | 설정 및 구성 | 2 | 치명적 | config- |
| 2 | 작업 정의 및 실행 | 3 | 치명적 | task- |
| 3 | 오류 처리 및 안정성 | 1 | 높음 | error- |
| 4 | Canvas: 워크플로우 설계 | 4 | 높음 | canvas- |
| 5 | 모니터링 및 로깅 | 2 | 높음 | monitoring- / perf- |
| 6 | 성능 및 확장 | 2 | 중간-높음 | perf- |
| 7 | 보안 | 1 | 중간-높음 | security- |
| 8 | 결과 백엔드 | 2 | 중간-높음 | result- |
| 9 | 라우팅 및 큐 | 1 | 중간 | routing- |
| 10 | 주기적 작업 | 1 | 중간 | periodic- |
| 11 | 직렬화 | 1 | 중간 | serial- |
| 12 | 워커 관리 | 1 | 중간 | worker- |
| 13 | 시그널 및 이벤트 | 1 | 중간 | signals- |
| 14 | 원격 제어 및 검사 | 1 | 중간 | remote- |
| 15 | Celery 애플리케이션 테스트 | 1 | 중간-높음 | testing- |
| 16 | 데몬화 및 프로세스 관리 | 1 | 중간 | daemonization- |
| 17 | Celery 애플리케이션 디버깅 | 1 | 높음 | debugging- |
| 18 | 확장 및 Bootsteps 사용자 정의 | 1 | 낮음 | extensions- |
| 19 | 고급 패턴 | 1 | 낮음 | advanced- |
빠른 참조
1. 설정 및 구성 (치명적)
config-broker-setup: 메시지 브로커(Redis/RabbitMQ)를 올바르게 구성config-environment-separation: 환경별로 별도의 구성 사용
2. 작업 정의 및 실행 (치명적)
task-calling-methods: 적절한 호출 방법(delay/apply_async/call) 선택task-atomic-operations: 작업이 원자적이고 멱등적이도록 보장
3. 오류 처리 및 안정성 (높음)
error-retry-strategy: 지능적인 재시도 메커니즘 구현
2. 작업 정의 및 실행 (치명적)
task-calling-methods: 적절한 호출 방법(delay/apply_async/call) 선택task-atomic-operations: 작업이 원자적이고 멱등적이도록 보장task-options-configuration: 작업 동작 및 안정성 옵션 구성
3. 오류 처리 및 안정성 (높음)
error-retry-strategy: 지능적인 재시도 메커니즘 구현
4. Canvas: 워크플로우 설계 (높음)
canvas-chain-workflows: 순차적 작업 실행 및 오류 전파canvas-group-parallel: 성능 향상을 위한 병렬 작업 실행canvas-chord-synchronization: 병렬 실행 및 동기화가 포함된 복잡한 워크플로우canvas-map-starmap: 효율적인 배치 처리 및 데이터 변환
5. 모니터링 및 로깅 (높음)
monitoring-task-tracking: 작업 실행 및 성능 추적perf-monitoring-metrics: 성능 최적화 및 문제 감지
6. 성능 및 확장 (중간-높음)
perf-concurrency-tuning: 워커 동시성 설정 최적화
7. 보안 (중간-높음)
security-task-authentication: 승인되지 않은 작업 실행 방지
8. 결과 백엔드 (중간-높음)
result-backend-selection: 적절한 결과 백엔드 선택result-expiry-management: 결과 만료 정책 관리
9. 라우팅 및 큐 (중간)
routing-task-distribution: 지능적인 작업 라우팅 및 큐 관리
10. 주기적 작업 (중간)
periodic-celery-beat: 안정적인 예약 작업 실행
11. 직렬화 (중간)
serial-data-handling: 안정적인 데이터 전송 및 저장
12. 워커 관리 (중간)
worker-lifecycle-management: 안정적인 워커 운영 및 리소스 관리
13. 시그널 및 이벤트 (중간)
signals-events-system: 모니터링 및 확장을 위한 Celery 이벤트 후킹
14. 원격 제어 및 검사 (중간)
remote-control-inspection: 워커의 런타임 관리 및 문제 해결
15. Celery 애플리케이션 테스트 (중간-높음)
testing-celery-applications: 비동기 애플리케이션을 위한 포괄적인 테스트 전략
16. 데몬화 및 프로세스 관리 (중간)
daemonization-process-management: 프로덕션 배포 및 서비스 관리
17. Celery 애플리케이션 디버깅 (높음)
debugging-celery-applications: 효과적인 문제 해결 및 이슈 해결
18. 고급 성능 최적화 (중간-높음)
advanced-performance-optimization: 높은 처리량을 위한 최적화 기법
19. 확장 및 Bootsteps 사용자 정의 (낮음)
extensions-bootsteps-customization: 고급 사용자 정의 및 확장
20. 고급 패턴 (낮음)
advanced-task-chaining: 복잡한 워크플로우 오케스트레이션
사용 방법
개별 규칙 파일에서 자세한 설명과 코드 예제를 확인하세요:
rules/config-broker-setup.md # 브로커 구성
rules/task-calling-methods.md # 작업 실행 방법
rules/task-options-configuration.md # 작업 동작 옵션
rules/canvas-chain-workflows.md # 순차 워크플로우
rules/canvas-group-parallel.md # 병렬 실행
rules/canvas-chord-synchronization.md # 복잡한 동기화
rules/canvas-map-starmap.md # 배치 처리
rules/monitoring-task-tracking.md # 작업 모니터링
rules/result-backend-selection.md # 결과 저장소
rules/routing-task-distribution.md # 작업 라우팅
rules/periodic-celery-beat.md # 예약 작업
rules/serial-data-handling.md # 데이터 직렬화
rules/signals-events-system.md # 이벤트 후킹
rules/remote-control-inspection.md # 워커 관리
rules/testing-celery-applications.md # 테스트 전략
rules/security-task-authentication.md # 작업 보안
rules/daemonization-process-management.md # 프로덕션 배포
rules/debugging-celery-applications.md # 문제 해결
rules/advanced-performance-optimization.md # 고성능 튜닝
rules/extensions-bootsteps-customization.md # 고급 사용자 정의
각 규칙 파일에는 다음이 포함됩니다:
- 영향 수준 및 카테고리
- 결과를 포함한 문제 설명
- 코드 예제가 포함된 해결 방법
- 피해야 할 일반적인 실수
- 규칙 적용 시기
참조 문서
복잡한 주제에 대한 상세 가이드:
references/worker-management.md # 워커 배포 및 확장
추가 참조 가이드 예정: 모니터링 설정, 문제 해결, Canvas 패턴
전체 컴파일된 문서
모든 규칙이 확장된 전체 Celery 모범 사례 가이드는 다음 파일을 참조하세요: AGENTS.md
Celery 버전 지원: Celery 4.x, 5.x, 6.x(최신) 호환