Skip to content

Deployment history

Every resource keeps an append-only history of its deployments. Open a resource in the console and pick the Deploys tab to see one row per deployment, newest first. The current primary release is highlighted; replaced rows are dimmed.

Each row carries one of these badges:

  • Current — this row is the primary release receiving traffic.
  • Replaced — completed successfully, then superseded by a newer deployment.
  • Queued / Building — the platform is fetching source or building an image.
  • Built / Activating — image is ready; the operator is rolling it out.
  • Failed / Canceled — terminal failure or operator-cancelled.

While a deployment is Queued or Building, its row exposes a Cancel button. Clicking it aborts the build job, marks the row Canceled, and writes an audit entry. Once a deployment reaches Built, the rollout owns it — the Cancel button is shown disabled with a tooltip explaining that you should use Rollback instead to revert to a previous release.

From the CLI:

Terminal window
appbahn deploy cancel <resource-slug> <deployment-id>

Failed, canceled, or superseded rows expose a Retry button. Clicking it mints a new deployment row that re-uses the original source (the same commit hash for git-backed resources, the same image digest for registry resources). The new row appears at the top of the list and goes through the standard build → rollout pipeline. Retry is the right tool when a build failed on a transient error (registry blip, flaky network, etc.); the source is unchanged.

From the CLI:

Terminal window
appbahn deploy retry <resource-slug> <deployment-id>

If you need to revert to an earlier good release instead of re-running the same one, use rollback (see Rollback).