Deployments

The Deployments module lets you manage which policy versions are active in which environments. The central interface is the Deployment Matrix — a grid view showing all policies across all environments at a glance.

---

Deployment Matrix

Navigate to Deployments in the main menu to open the matrix.

The matrix is a grid with:

• Rows = Policies
• Columns = Environments (sorted by promotion order, left to right)

Each cell shows either:

• The deployed version number and its status (ACTIVE or SUSPENDED), or
• A Deploy button if no version is deployed for that policy in that environment

All deployment actions are accessible from the context menu on each cell.

---

Deploying a Version

Deploying a version associates it with a target environment and activates it for policy evaluation.

From the Deployment Matrix

1. Click the Deploy button on an empty cell
2. Select the version to deploy (only VALIDATED, PUBLISHED, or DEPRECATED versions are listed)
3. Optionally enter a reason for the deployment
4. Click Deploy

From a Policy’s Version Card

1. Open a policy and go to the Versions dialog
2. On a version card, click the Deploy action
3. Select the target environment
4. Click Deploy

The deployment is created in ACTIVE status immediately.

Direct production deployment

If you deploy directly to a production environment without first promoting through earlier stages, a warning is displayed. The deployment still proceeds — the warning ensures the action is intentional.

---

Promoting a Deployment

Promotion moves a deployed version to the next environment in the promotion pipeline.

1. From the Deployment Matrix, open the context menu on an active deployment
2. Click Promote
3. Select the target environment (only environments with a higher promotion order are listed)
4. Optionally enter a reason
5. Click Promote

Example

A version deployed in Staging (order 20) can be promoted to Pre-production (order 30) or Production (order 40). It cannot be promoted backward to Development (order 10).

Tip

Promotion is the recommended way to move versions through your pipeline. It provides a clear audit trail and enforces the environment hierarchy.

---

Rolling Back a Deployment

Rollback replaces the currently deployed version with a previous version in the same environment.

1. Open the context menu on a deployment cell
2. Click Rollback
3. Select the target version from the list (the currently deployed version is excluded; DRAFT versions are not listed)
4. Enter a reason (required)
5. Click Rollback

The deployment is updated to point to the selected version. The previous version is not removed — it remains available for future redeployment.

---

Suspending and Resuming a Deployment

Suspend

Suspending temporarily pauses a deployment. The version remains associated with the environment but is no longer active for policy evaluation.

1. Open the context menu → Suspend
2. Enter a reason (required)
3. The deployment status changes to SUSPENDED

Resume

Resuming reactivates a suspended deployment.

1. Open the context menu → Resume
2. The deployment status changes back to ACTIVE

---

Removing a Deployment

Removing a deployment completely dissociates a version from an environment.

1. Open the context menu → Remove
2. Enter a reason (required)
3. Confirm the action

The cell in the Deployment Matrix returns to its empty state with a Deploy button.

---

Deployment Statuses

Status	Description
ACTIVE	The version is deployed and actively used for policy evaluation
SUSPENDED	The version is deployed but temporarily paused — not used for evaluation

---

Deployments from the Policy View

Each version card in a policy’s Versions dialog displays its deployments as chips showing the environment name and status.

Clicking a deployment chip opens a context menu with all available actions: Promote, Rollback, Suspend, Resume, Remove, and View History.

A version that is deployed to all configured environments will not show a “Deploy” action (there is nowhere left to deploy it).

---

Summary of Actions

Action	Description	Reason
Deploy	Deploy a version to an environment	Optional
Promote	Move a deployment to a higher-order environment	Optional
Rollback	Replace the current version with a previous one	Required
Suspend	Temporarily pause a deployment	Required
Resume	Reactivate a suspended deployment	—
Remove	Completely remove a deployment	Required

---

Permissions

Role	Capabilities
Owner / Admin / Standard	All deployment actions
Read-only	View the Deployment Matrix