FR-IMG-006 — Image Promotion Workflows

Go to Crucible Image Management Requirements

Statement

Crucible SHALL promote an identified Image from one defined promotion state to another after the Image satisfies the applicable transition criteria.

Source Statement

Crucible SHALL perform Image Promotion for an identified Image after the Image satisfies the applicable transition criteria.

Source

Crucible System Requirements Specification, Version 1.1 Draft, Functional Requirements, FR-IMG-006.

Assessment

The source statement expresses the approved intent but does not provide a fully testable formulation.

The following Specification Discipline and Authoring findings apply:

The system does not use the defined system nameshall does not follow the established uppercase normative conventionSupport is a weak verb that does not identify the required behaviorImage promotion workflows does not identify the Image being promotedThe source statement does not identify the states between which promotion occursThe source statement does not identify the conditions governing a promotion transitionThe source statement does not identify an observable promotion resultThe source statement does not prescribe a particular state model, repository, release process, or implementation technologyThe normalized Statement:

Replaces The system with CrucibleReplaces support with the direct behavior promoteIdentifies an Image as the subject of promotionIdentifies movement between defined promotion statesRequires satisfaction of applicable transition criteria before promotionRetains one primary required behaviorPreserves implementation independenceThe normalized Statement does not prescribe the names or number of promotion states. The applicable promotion workflow defines those states and their transition criteria.

Rationale

Image promotion controls the progression of an identified Image through defined states associated with evaluation, approval, release, distribution, or deployment.

Example promotion states may include:

BuiltEvaluatedSignedVerifiedApprovedStagedReleasedAvailable for deploymentRetiredThe applicable workflow determines which states apply and which transitions are permitted.

Transition criteria may include:

Successful build completionSuccessful digital-signature verificationSuccessful vulnerability assessmentSuccessful compliance assessmentRequired test resultsRequired approvalRequired EvidenceCompatibility with a target environmentSatisfaction of applicable release conditionsFR-IMG-006 does not independently require any particular signing, testing, scanning, compliance, or approval criterion. The applicable lower-level requirement or promotion policy establishes each criterion.

Controlled Image promotion contributes to:

Prevention of unauthorized Image useConsistent release decisionsControlled Image distributionControlled Image deploymentImage-state visibilityProvenanceAuditabilityTraceability

Applies To

This requirement applies to:

Image identifiersImage promotion statesPromotion-state transitionsTransition criteriaImage promotion workflowsImage repositoriesImage release workflowsImage deployment workflowsCI/CD Pipelines

Verification

Verification SHALL confirm that the applicable Image promotion workflow defines at least two promotion statesVerification SHALL confirm that the applicable Image promotion workflow defines the permitted transition between the tested promotion statesVerification SHALL confirm that the tested transition identifies applicable transition criteriaVerification SHALL confirm that Crucible promotes the identified Image when the Image satisfies the applicable transition criteriaVerification SHALL confirm that Crucible does not perform the tested promotion transition when the Image does not satisfy the applicable transition criteriaVerification SHALL confirm that Crucible records the resulting promotion stateVerification may include:

Machine Image promotion testingContainer Image promotion testingSuccessful-transition testingFailed-transition testingTransition-criteria inspectionImage-state inspectionPromotion-record inspectionImage-repository inspectionPromotion-log inspectionAutomated CI/CD Pipeline testingThe verification record SHALL identify:

The promoted ImageThe Image identifierThe initial promotion stateThe requested promotion stateThe applicable transition criteriaThe observed criteria resultsThe promotion decisionThe resulting promotion stateThe promotion resultThe generated Evidence

Outgoing Traceability

This requirement realizes:

This requirement relates to:

Referenced By

The wiki Backlinks function provides the current list of pages that reference FR-IMG-006.

Incoming Traceability should be derived dynamically from backlinks rather than maintained as a duplicate manual list.

Backlinks identify incoming references but do not define the semantics of each relationship. Referencing pages should identify whether the relationship represents realization, refinement, verification, dependency, or another defined traceability relationship.

ConOps Relationship

The Crucible Concept of Operations describes a Phase 1 workflow that builds, evaluates, and deploys controlled Image Artifacts through an automated CI/CD Pipeline.

FR-IMG-006 establishes the required behavior for progressing an identified Image between defined promotion states after satisfaction of the applicable transition criteria.

Requirements governing Image building, signing, verification, compliance assessment, publication, transfer, and deployment define the behavior or conditions associated with particular promotion transitions.

Delivery Phase

Phase 1

Implementation Status

Not Assessed

Implementation status requires verification that Crucible promotes an identified Image from one defined promotion state to another after the Image satisfies the applicable transition criteria.

Requirement Status

Draft

The source System Requirements Specification identifies Version 1.1 as a draft.

Notes for Editors

This requirement page should retain the stable requirement identifier FR-IMG-006.

Changes to the Statement SHALL preserve the approved intent of the source requirement.

The Source Statement should preserve the original wording from the controlling System Requirements Specification.

The Statement should remain limited to promotion of an identified Image between defined promotion states after satisfaction of applicable transition criteria.

The applicable workflow or lower-level requirements should define the promotion states and transition criteria without adding those details to this requirement unless the controlling source changes.

Verification criteria should test only the behavior stated in the normalized Statement and should not introduce additional normative obligations.

Incoming Traceability should use the wiki Backlinks function rather than a manually maintained list.

To reference this requirement Statement from another wiki page, insert:

{{section>dido:02-crusible:99-annexes:annex-c-requirements:03-functional-requirements:03-02-image-management:fr-img-006#Statement&noheader&nofooter&noeditbtn}}

Do not rename this page after an external citation unless a redirect or move plan is in place.

© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.