Appendix - Release Dashboard

Terminology

Below are the common key terms used through the Release Dashboard UI and documentation

Term

Meaning

Term

Meaning

Release Content

Release Content is the logical grouping of Projects, Packages and Work Items that define a Release

Snapshot

A Snapshot is simply a build of all the Release Content. Similar to how Projects being built generate a unique Project Version, the same can be thought of for a Release and Snapshots.

This may be used somewhat interchangeably with Snapshot Content

Snapshot Versions

Since a Release consists of multiple Projects or Packages, when building a Snapshot each Project/Package gets built and versioned individually (Snapshot Version) and aggregated into a Snapshot.

You can think of a Snapshot being nothing more than a list of Snapshot Versions or Project Versions

Pipeline Execution

Once a Snapshot is built it then moves through the Pipeline configured on the Release. This is known as a Pipeline Execution.

Release Dashboard

Release Dashboard is nothing more than a tool for visualizing and managing Pipeline Executions.

Stage Actions

Action

Description

Notes

Action

Description

Notes

Abort Stage

Aborts the Stage and any currently running Gates or Steps in the Stage

Requires Manage Stage Execution permission. The Stage can only be aborted while in a running state (Gates Running, Gates Completed, Steps Running).

Replay Stage

Replay the Stage. Any previously executed Gates or Steps, successful or otherwise, will be replayed as well.

Requires Manage Stage Execution permission. The Stage can only be replayed while in a halted state (Aborted, Failed, Gates Failed, Rejected).

View Execution Variables

The Pipeline used by the Release is able to define runtime Variables to customize execution logic in real time. This button will open a view to visualize the current values of any such Pipeline Variables.

Any user with Read permission on the Release can view this information.

Upload Execution Info

Allows the viewing or modification of the Stage Execution Info.

Any user with Read permission on the Release can view the Stage Execution Info, but modifying requires the Upload Execution Info permission.

Step/Gate Actions

Action

Description

Notes

Action

Description

Notes

Approve Step/Gate

Approve the focused Step or Gate.

A Step or Gate that requires approval will generate a task in FlexDeploy which can be approved or rejected from the Tasks screen. This is simply a shortcut to approve the task directly from the dashboard.

Optional notes can be provided during approval to provide more context for audit purposes.

Approval Role - Only users in the FD Administrators group or the specified Role on the step can approve. The Manage Step Execution and Manage Gate Execution permissions are not involved here.

Fullscreen

Open the Step or Gate details in a full-screen viewer.

Default keyboard shortcut is shift+f

Override Step/Gate

Override (i.e Skip) the current Gate or Step.

Similar to Approve/Reject, Override can only be used by FD Administrators and those configured on the Override Role in the Gate or Step.

Reject Step/Gate

Reject the Step or Gate.

See notes on Approve Step/Gate above

Replay Step/Gate

Replays the Step or Gate. The Step or Gate must be in a failed state (Aborted, Failed, Rejected).

Requires Manage Step/Gate Execution permission.

Skip Step/Gate

Skips the Step or Gate. Similar to replay the Step or Gate must be in a failed state.

Requires Manage Step/Gate Execution permission.

View Pipeline Step/Gate Definition

View the configuration for the Step/Gate defined on the Pipeline.

 

Stage Statuses

Status

Description

Notes

Status

Description

Notes

Aborted

The Stage was aborted.

In most cases this is due to a user manually aborting the Stage. There are a select few background processes that may abort a Stage. For example when Force Completing a Release any running stages will be aborted.

Failed

The Stage has failed.

This is typically the result of a Step within the Stage failing.

Gates Completed

 

Gates have completed and Steps are waiting to process.

When a Stage is in this status it typically means there is another Pipeline Execution running Steps in the same Stage. Once the latter execution completes this Stage will move on to Running Steps.

See Frequently Asked Questions | Why is the Pipeline Execution stuck in Gates Complete status? if you are concerned that a snapshot is staying in this status too long.

Gates Failed

One or more Gates within the Stage have failed.

 

Gates Running

The Stage is currently running Gates.

Note that any Gate waiting on some user interaction or external system still falls under this status. Waiting on user approval in an Approval Gate for example.

Not Started

The Stage has not begun to execute. This will only occur if a Stage prior to this one is still executing.

 

Out of Date

The Stage has been superseded and is now Out of Date.

See Frequently Asked Questions | What does Out of Date mean? for more information.

At any given time there may multiple Pipeline Executions running for a Release. If at any point the latest Pipeline Execution proceeds to a later Stage than previous Pipeline Executions, they will be marked as Out of Date.

Rejected

The Stage has been rejected by a user, most commonly via an Approval Gate.

 

Skipped

The Stage has been skipped.

This can only occur via a Stage precondition in the Pipeline Definition or by providing the Skip Stages input during Snapshot creation.

Steps Running

The Stage is currently running Steps.

 

Success

The Stage has been successfully completed.

 

Step/Gate Statuses

Status

Description

Notes

Status

Description

Notes

Aborted

The Step or Gate was aborted.

Note that users cannot directly abort Steps or Gates but rather abort the Stage, which indirectly results in an Aborted Step or Gate.

Failed

The Step or Gate failed executing.

Perhaps the most broad status, Failed can occur in a number of ways:

  • Misconfiguration in the Pipeline Definition

  • Failed executions as part of a Step

  • A quality gate not meeting its successful criteria.

Pending Approval

The Gate is awaiting an approval

Both Approval Gate and External Approval Gate will be in this status while waiting for the Approval.

Pending Review

The Step is waiting for Review

Most commonly seen in the Predeploy and Predeploy All Steps

Rejected

The Step has been Rejected by the User

 

Running

The Step or Gate is currently running

 

Out of Date

The Gate is Out of Date. See Frequently Asked Questions | What does Out of Date mean? for more information.

Due to the nature of Out of Date, it is only possible for Gates to be Out of Date.

Scheduled

The Step or Gate is currently scheduled

 

Skipped

The Step or Gate has been skipped due to a precondition being false

Note that skipped is only displayed in the case of a precondition. A user manually skipping or overriding a Gate or Step will show a status of Success.

Success

The Step or Gate has completed successfully.

 

Snapshot Statuses

Status

Description

Notes

Status

Description

Notes

Aborted

The Snapshot was aborted.

Only available while the Snapshot is Pending (building). Note that builds may continue to run if they had already been started prior to abort being initiated.

Completed

The Snapshot has finished building but is not yet Initiated

 

Failed

The Snapshot has failed to build.

Most commonly this occurs if one of the Projects or Packages within the Snapshot failed during build.

Initiated

The Snapshot has now completed building and is running through the Pipeline Execution

 

Pending

The Snapshot Versions are currently building

 

Snapshot Version Statuses

Status

Description

Notes

Status

Description

Notes

Aborted

The Snapshot Version was aborted.

Typically this is due to the Snapshot itself being aborted but it is also possible an individual build was aborted from the Project Execution screen.

Completed

A new Snapshot Version has built successfully.

This only displays if the Snapshot Version built a new version, either through Force Build being checked or changes being detected.

Existing

A previous Snapshot Version was found and used.

This can occur if no changes were detected during build and a valid Project Version already exists that can be used.

Failed

The Snapshot Version has failed to build.

An error occurred while building this Snapshot Version

Pending

The Snapshot Version is waiting to be built

Unlike Running, this Snapshot Version is still waiting to be built, typically due to resource limitations.

Running

The Snapshot Version is currently being built.

 

The following macros are not currently supported in the footer:
  • style