This directory contains comprehensive guides for understanding and working with Apache Iggy and event-driven architecture patterns.
| Guide | Description |
|---|---|
| Event-Driven Architecture Guide | Core concepts, streams/topics/partitions, consumer groups, error handling patterns, and production patterns (outbox, saga, idempotency) |
| Partitioning Guide | Deep dive into partition keys, ordering guarantees, and partition selection strategies |
| Durable Storage Guide | Storage architecture, fsync configuration, backup/archiving to S3, recovery procedures, and production recommendations |
| Structured Concurrency | Task lifecycle management, cancellation tokens, and graceful shutdown patterns |
- New to Iggy? Start with the Event-Driven Architecture Guide
- Setting up production? See Durable Storage Guide
Architecture & Design
- Core Concepts - EDA fundamentals, Iggy overview
- Streams, Topics, and Partitions - Data organization
- Message Flow Patterns - Pub/sub, work queues, event sourcing
Data Durability
- Durability Configuration - fsync settings and trade-offs
- Backup and Archiving - S3 and disk archival
- Recovery - Disaster recovery procedures
Message Ordering
- Partition Keys - Ensuring message ordering
- Consumer Groups - Parallel processing with ordering
Production Patterns
- Error Handling - At-least-once, idempotency, DLQ
- Outbox Pattern - Reliable event publishing
- Production Recommendations - Config templates
Application Internals
- Structured Concurrency - Background task management
- Graceful Shutdown - Clean shutdown procedures
- Event-Driven Architecture Patterns - Martin Fowler
- Designing Data-Intensive Applications - Martin Kleppmann
- Enterprise Integration Patterns
Last updated: December 2025