Environments

Environments execute blueprints against collections, tracking the full lifecycle of infrastructure changes from planning through apply and teardown.

Environments

Overview

Environments in Bluebricks provide a consistent, controlled, and repeatable way to execute a blueprint against a specific collection. An environment represents the ongoing workflow responsible for provisioning, updating, and destroying all infrastructure defined by the blueprint—across every package, artifact, and dependency it contains.

Once created, an environment serves as the stable interface for managing the lifecycle of your infrastructure in that collection. It centralizes configuration, tracks every change, and ensures that updates are performed safely and predictably, regardless of how they are triggered.

How Environments Work

When you create an environment run, Bluebricks evaluates the blueprint and all of its child packages to produce a unified execution plan. This plan captures every expected change across all layers of infrastructure, allowing you to:

• Preview changes before applying them

• Understand the full impact of updates

• Maintain an auditable history of every modification

Each execution of an environment creates a run, which encapsulates the plan, logs, state updates, and resulting outputs. Runs are fully versioned and traceable, enabling teams to understand how infrastructure evolves over time and why each change was made.

Why Environments Matter

Environments provide the backbone of infrastructure management on Bluebricks by delivering:

• Consistency — every change is executed using the same workflow and evaluation logic

• Traceability — each run is captured with logs, diffs, inputs, and outputs

• Repeatability — environments can be re-run safely at any time, enabling iterative updates

• Separation of concerns — blueprints define what should exist, environments define where and how it’s applied

• Safety — approval flows, collection policies, cost checks, and unified plans help prevent unintended changes