Configuration Externalization

Kind: principle

Layer: Resource Core

Aliases: Externalized Configuration

Record: architecture:configuration-externalization

Severity: mandatory

Scope: application, deployment, runtime

Canonical: Ontology

A design rule that environment-specific values are read from validated external configuration at startup.

Listed in Architecture principles, after Protocol Independence and before Immutable Infrastructure.

Requires

• Config Schema
• Secure Config Handling

Reinforces

• Portability
• Environment Parity

Enables

• Environment-Specific Deployment

Conflicts with

• Hardcoded Configuration

In tension with

• Config Sprawl

Tensions

• Configuration Externalization / Config Sprawl

Violated by

• Hardcoded Configuration

Refactored by

• Externalize Configuration
• Validate at the Boundary

Severity

• mandatory

Category

• Portability / Infrastructure / Deployment

Enforced by

• rules/eslint/no-port-literal.eslint.rule.ts

Linked from

• Semantic operations
• The behavior document
• The drop-in
• One home
• Computation and resource
• Anti-patterns
• Portability / Infrastructure / Deployment
• Control / Coordination / Centralization
• Correctness / Determinism / Verification
• Portability / Infrastructure / Deployment
• Severity levels
• The resolutions

in this codebase

• rules/eslint/no-port-literal.eslint.rule.ts