Skip to content

Deploy a Blueprint

A Blueprint packages an application or infrastructure component with its databases, storage, internal wiring, and sensible defaults. You choose the software and its arguments without rebuilding that architecture yourself.

Open Blueprints in the console. Public Blueprints are available to every Team; Team Blueprints are visible only to members of that Team. Open a Blueprint to inspect what it stands up, the inputs it accepts, and its runtime commitments.

Choose Deploy, select the Project and Environment, and review the preview. The Blueprint becomes desired state inside that Environment—it does not create a separate application silo.

Supply ordinary arguments during the deployment flow. Secret arguments are entered separately and are never written back to the Project YAML as plaintext.

The equivalent authored resource is:

resource: blueprint
name: chat
from: publisher/librechat@2.1.0
arguments:
APP_NAME: Acme Chat
INFERENCE_ENDPOINT: https://inference.example.com/v1

Review the complete Environment diff and apply it. Once the deployment is ready, use the route shown on its canvas node or deployment handoff.

After deployment, select the Blueprint node to change arguments, rotate secret arguments, bound component resources, configure alerts, or review an available upgrade. Continue with the Blueprint lifecycle.

When a new Blueprint version is available, first fork the complete production Environment into a disposable preview:

Terminal window
deliberate apply --env preview-blueprint-upgrade
deliberate open --env preview-blueprint-upgrade

There is no separate create step. The first apply materialises the matching preview-* Environment from production according to the Project’s Flow. In the console, open that preview, select the Blueprint node, and apply the available upgrade there. Its components, dependencies, configuration, routes, and cloned data resources can be exercised together without replacing production.

Once satisfied, return to production and apply the same Blueprint version from its Blueprint node. Then tear down the preview:

Terminal window
deliberate envs delete preview-blueprint-upgrade