F Forge DocsRepository ↗FeaturesUser manual

Advanced / user manual

Deployments and Preview Deployments

Runs rolling, blue-green, and preview delivery flows. Records digest-pinned revisions with gated steps, one active deployment per server, per-PR preview environments, and separate zero-downtime releases.

Purpose

Coordinate deployments, traffic, scaling, security, and provider integrations.

ARCHITECTURE

Rollout flow

One active deployment per server

01Digest-pinned imagerecord
02Revision recordexecute
03Gated stepspass gate
04Promoteswitch
05Live target
✓ sha256 pinned✓ health gate passes✓ single active

How to use it

Operator workflow

  1. 01

    Trigger a rollout with a digest-pinned image and health gate.

  2. 02

    Follow gated steps; only one deployment runs per server.

  3. 03

    Compare revisions and roll back to a completed target when needed.

  4. 04

    Use preview environments per pull request with TTLs for pre-merge verification.

What Forge owns

Boundary and safety

Rollback mirrors a recreate deployment against a completed target — never the live one.

Use deliberate changes

Review the affected node, workload, route, or secret before saving. Capture state and health evidence before changes that affect data or public traffic.

Before you finish

Verification checklist

  • Deployment reaches completed.
  • Revision recorded with config hash.
  • Rollback row written on revert.
  • Preview closes and cleans up.

Continue the manual

Use this feature in the wider Forge workflow.

Move from platform understanding to the relevant operating guide when you need exact environment, network, deployment, or recovery steps.