Declarative Configuration [Dido Solutions, Inc Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Declarative Configuration ======

[[dido:99_annexes:annex-b-terms-and-definitions:start|Go to Terms and Definitions]]

===== Discussion =====

Declarative Configuration specifies the required state of a subject without prescribing the sequence of operations used to establish that state.

The configured subject may include:

  * An [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_environment|Infrastructure Environment]]
  * An [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_configuration|Infrastructure Configuration]]
  * A platform
  * A service
  * A software component
  * A network
  * A computing resource
  * A storage resource
  * A security control

Declarative Configuration may specify:

  * Required resources
  * Required configuration values
  * Relationships among resources
  * Required capabilities
  * Applicable constraints
  * Applicable [[dido:99_annexes:annex-b-terms-and-definitions:b:baseline|Baseline]] references
  * Applicable [[dido:99_annexes:annex-b-terms-and-definitions:a:acceptance_criteria|Acceptance Criteria]]
  * Desired operational state

A tool or process evaluates the declared state and determines the operations required to establish or preserve that state.

Declarative Configuration differs from procedural configuration:

  * Declarative Configuration specifies the required result
  * Procedural configuration specifies the operations and sequence used to produce the result

Declarative Configuration does not prohibit an implementation from using an execution sequence. The distinction concerns whether the configuration itself prescribes that sequence.

Declarative Configuration may form part of [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_as_code|Infrastructure as Code]] when represented as a machine-readable [[dido:99_annexes:annex-b-terms-and-definitions:a:artifact|Artifact]].

===== Definition =====

//configuration that specifies the required state of a subject without prescribing the sequence of operations used to establish that state//

===== Source =====

Dido Solutions, Inc. and Jackrabbit Consulting, Inc.

===== Note =====

Declarative Configuration may be:

  * Human-readable
  * Machine-readable
  * [[dido:99_annexes:annex-b-terms-and-definitions:v:version_control|Version-controlled]]
  * Reusable
  * Parameterized
  * Inherited
  * Generated
  * Composed from multiple controlled inputs

A declarative representation does not by itself establish that the configuration is:

  * Valid
  * Approved
  * Authorized for application
  * Compatible with a target platform
  * Successfully deployed
  * Compliant with an applicable Baseline

Separate requirements govern those determinations.

The term does not require a particular configuration language, schema, file format, deployment tool, cloud provider, operating system, or implementation technology.

===== Example =====

A Declarative Configuration specifies that an Infrastructure Environment contains three compute resources, persistent storage, defined network relationships, identity services, logging, and monitoring. The configuration does not prescribe the sequence in which the deployment system creates those resources.

----

<WRAP centeralign>
© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.
</WRAP>