← Concepts

阅读中文版本

Monolith to Modular Migration

Monolith to Modular Migration governs incremental decomposition, shaping system behavior under specific failure modes and workloads.

architecture

Definition

Monolith to Modular Migration is a design property concerning incremental decomposition. It defines how the system behaves under specific conditions — what guarantees hold, what trade-offs apply, and how the mechanism interacts with related techniques. The property is only meaningful when its preconditions are met; outside those conditions it provides no benefit and may add cost.

Context and scope

Apply Monolith to Modular Migration when designing systems where incremental decomposition matters. It is most useful under partial failure, high load, or correctness requirements. Pair it with observability to verify the claimed behavior in production. Do not assume the property holds without testing the specific configuration and workload.

Common misconceptions

  • Monolith to Modular Migration eliminates all problems in its domain — it only bounds or shapes specific failure modes, not all pathologies.
  • Monolith to Modular Migration is free once you adopt the right tool — the property depends on configuration, workload, and failure pattern, not the product label alone.

Anti-patterns

  • Enabling Monolith to Modular Migration without measuring its cost in latency, availability, or operational complexity under production-like conditions.
  • Assuming Monolith to Modular Migration composes safely with other guarantees — combining mechanisms can introduce new failure modes or negate benefits.

Related concepts

Authoritative source

https://martinfowler.com/architecture/

What it is

Monolith to Modular Migration is a design property concerning incremental decomposition. It defines how the system behaves under specific conditions — what guarantees hold, what trade-offs apply, and how the mechanism interacts with related techniques. The property is only meaningful when its preconditions are met; outside those conditions it provides no benefit and may add cost.

When to use

Apply Monolith to Modular Migration when designing systems where incremental decomposition matters. It is most useful under partial failure, high load, or correctness requirements. Pair it with observability to verify the claimed behavior in production. Do not assume the property holds without testing the specific configuration and workload.

Common misconceptions

  • Monolith to Modular Migration eliminates all problems in its domain — it only bounds or shapes specific failure modes, not all pathologies.
  • Monolith to Modular Migration is free once you adopt the right tool — the property depends on configuration, workload, and failure pattern, not the product label alone.

Anti-patterns to avoid

  • Enabling Monolith to Modular Migration without measuring its cost in latency, availability, or operational complexity under production-like conditions.
  • Assuming Monolith to Modular Migration composes safely with other guarantees — combining mechanisms can introduce new failure modes or negate benefits.
  • Modular Monolith (modular-monolith)
  • strangler-fig-migration (strangler-fig-migration)