microservices-patterns

name	microservices-patterns
type	reference
description	Provides microservices design patterns for service decomposition, API gateway, circuit breakers, saga orchestration, and inter-service communication. Use when designing or implementing microservices architecture.
paths	["**/docker-compose*","**/k8s/**","**/services/**"]
effort	4
allowed-tools	Read, Glob, Grep, Write, Edit, Bash
user-invocable	true
when_to_use	When designing microservices architecture, implementing service communication, or decomposing monoliths

Microservices Patterns

Service decomposition, communication, resilience, and orchestration patterns.

Service Decomposition

Pattern	Description	Use When
Domain-Driven	Align services with bounded contexts	Complex business domains
Data-Ownership	Service owns its data store	Data isolation required
Team-Aligned	One service per team	Large organizations

Communication Patterns

Sync: HTTP/gRPC

```yaml

API Gateway routing

routes:

• match: { prefix: /orders } route: { cluster: order-service }
• match: { prefix: /users } route: { cluster: user-service } ```

Async: Message Queue

``` Producer → Exchange → Queue → Consumer (Topic) (DLQ on failure) ```

Use async for: event propagation, eventual consistency, load leveling.

Resilience Patterns

Circuit Breaker

```typescript // Example with opossum const breaker = new CircuitBreaker(fetchUserProfile, { timeout: 3000, errorThresholdPercentage: 50, resetTimeout: 30000, }); ```

Retry with Backoff

```typescript async function retryWithBackoff(fn, maxRetries = 3) { for (let i = 0; i < maxRetries; i++) { try { return await fn(); } catch (e) { await sleep(Math.pow(2, i) * 1000); } } throw new Error('Max retries exceeded'); } ```

Data Patterns

Pattern	Consistency	Complexity	Use When
Saga (orchestration)	Eventual	High	Complex multi-service transactions
Saga (choreography)	Eventual	Medium	Simple event chains
Event sourcing	Eventual	High	Audit trail, time travel
Shared database	Strong	Low	Anti-pattern, avoid

API Gateway

Tools: Kong, AWS API Gateway, Envoy, NGINX.

Responsibilities: routing, auth, rate limiting, request transformation, load balancing.

Observability Stack

• Distributed tracing: Jaeger / Tempo
• Metrics: Prometheus + Grafana