Skip to main content

Approve or reject a release

A pipeline step can need approvals before a release goes through, such as one approval before anything reaches Production. Until it has them, the release waits. You hear about it from the Approve release notice; this guide picks up from there.

Who can do this: the people the step names as approvers. The person who asked for the release can never approve or reject it. Approvals are set in the project's Settings › CI Pipeline: see Set up a project's pipeline.

  1. Select Tasks in the sidebar, then the project in the Projects tree.

  2. Select the Pipeline tab. On the stage strip, hover the Release step before the stage the release goes to. It says how many approvals the release has of how many it needs, such as 0/1 approvals.

    The stage strip: Ideas 1, Building 4, Dev 17 and Production 0, with the Release step between Dev and Production. No release waits for approval here

  3. Select the Release step. The row names the release, such as Dev → Production, with its 0/1 approvals chip, and the list below shows the tasks it ships. Approvals already given are listed under the row, each with its comment.

  4. To let it through, select Approve. To turn it down, select Reject.

  5. The dialog shows what the step asks approvers to check, in full. Read it, then type a Comment (optional), up to 500 characters. On a rejection, say why: the person who asked sees it.

  6. Select Approve or Reject in the dialog.

After an approval, the row counts it. The last approval needed sends the release on at once, or at its scheduled time. After a rejection, the release is canceled and its changes go back to waiting. The row reads Rejected by your name, with your comment, and the person who asked is told: see Release again after a rejection or timeout.

If nobody approves in time, the step may cancel the release by itself; its row then reads Approval timed out.

The capture shows the strip with no release waiting: the organization it was taken in had no release awaiting approval, so Approve, Reject and the dialog could not be photographed.