Microservices Architecture Patterns

When to Use This Skill

• Breaking down monolithic applications into services
• Designing distributed systems from scratch
• Implementing service communication patterns (sync/async)
• Managing data consistency across services
• Building resilient distributed systems
• Defining service boundaries and API contracts

Core Principles

1. Single Responsibility - Each service has one reason to change
2. Independent Deployability - No coordination required for deployments
3. Decentralized Data - Each service owns its data exclusively
4. Design for Failure - Embrace failures, build resilience
5. Automate Everything - Deployment, scaling, and recovery

Quick Reference

skills/microservices-patterns/references/service-decomposition.md

skills/microservices-patterns/references/communication-patterns.md

skills/microservices-patterns/references/data-management.md

skills/microservices-patterns/references/resilience-patterns.md

skills/microservices-patterns/references/observability.md

skills/microservices-patterns/references/deployment-migration.md

Workflow

1. Understand Requirements

• Map business capabilities and domains
• Assess scalability/resilience needs
• Identify team boundaries

2. Define Service Boundaries

references/service-decomposition.md

• Business capability decomposition
• DDD bounded contexts
• Service boundary validation

3. Design Communication

references/communication-patterns.md

• Synchronous: API Gateway, REST, gRPC
• Asynchronous: Message Queue, Pub/Sub, Event Sourcing

4. Manage Data

references/data-management.md

• Database per service pattern
• Saga distributed transactions
• CQRS read/write optimization

5. Build Resilience

references/resilience-patterns.md

• Circuit breakers
• Retry with exponential backoff
• Bulkhead isolation
• Rate limiting and timeouts

6. Add Observability

references/observability.md

• Distributed tracing
• Centralized logging
• Metrics and monitoring

7. Plan Deployment

references/deployment-migration.md

• Blue-Green, Canary, Rolling deployments
• Strangler Fig migration pattern

Common Mistakes

1. Distributed Monolith - Tightly coupled, must deploy together
2. Shared Database - Multiple services accessing same database
3. Chatty APIs - Excessive synchronous service calls
4. Missing Circuit Breakers - No cascading failure protection
5. No Observability - Deploying without tracing/logging/metrics
6. Ignoring Network Failures - Assuming reliable network
7. No API Versioning - Breaking changes without versioning

Resources

• Books: "Building Microservices" (Newman), "Microservices Patterns" (Richardson)
• Sites: microservices.io, martinfowler.com/microservices
• Tools: Kubernetes, Istio, Kafka, Kong, Jaeger, Prometheus