Configuration Validation

Validation Stages

  1. Validate() (pure, no I/O)

  • schema/value/range/enum checks

  • safe for fast unit tests

  1. StartupValidate() (I/O/platform checks)

  • local root writable check

  • path-under-root escape checks

  • cgroup v2 assurance checks for high mode

Common Error Classes

  • schema mismatch (v1 required)

  • non-absolute storage.local_root

  • invalid disk/eviction limits

  • invalid retry window coherence (window >= backoff * max_retry_count)

  • high assurance requested but cgroup v2 unavailable

Startup Abort Conditions

  • unwritable local root

  • path escape outside configured root

  • assurance mode high with missing/non-functional cgroup v2

Evidence

  • edge/config/validate.go

  • edge/config/startup.go

  • edge/config/config_test.go (validation and startup checks)

  • edge/cmd/edged/main.go (validate subcommand check output)

See Also