Execute release actions and quality gates

This topic describes how to perform release actions and evaluate quality gates.

Overview

A release process contains actions and quality gates that are assigned to users.

The actions and quality gates assigned to you are added to the My Work area.

Note: The business rules that control which items are added to the My Work area can be customized.

The items are ready to work on when they are in "Pending" phase. Items automatically move to pending when their start time arrives, provided that the preceding items are completed.

If an action or quality gate has not started 24 hours after its start time, the item is flagged "Overdue".

Back to top

Execute actions and quality gates

In the My Work area, mark the outcome of your actions and quality gates.

You can also use the Release Management module to access and fulfill your actions and quality gates.

To execute an action or quality gate:

  1. Open the My Work area. For details, see My Work area.
  2. To start a pending action or quality gate, click Start. The item moves to "In Progress".
  3. Evaluate quality gate criteria:

    • User input criteria. Go through each of the user-input criteria, and mark them as Passed or Failed.
    • Query criteria. ALM Octane automatically evaluates the criteria and marks them as Passed or Failed.

      Note: If a large number of query criteria are scheduled to run in parallel, ALM Octane may not evaluate them. In such a case, a message will display. To prompt ALM Octane to evaluate the criteria, hover over the quality gate status flags one-by-one, or open the quality gate Criteria tabs.

      The number of query criteria that can run in parallel is set by the QUERY_CRITERION_CALC_COUNT_PER_TASK parameter. For details, see Configuration parameters.

      You can simulate the results of planned query criteria, or drill down to the results of evaluated query criteria. For details, see Simulate or drill down to query results.

    Quality gates are flagged according their status. For details, see Quality gate status flags.

  4. After handling the action or quality gate, mark how the item concluded, using one of the following buttons: Complete, Fail, Skip

    Conclusion Details
    Complete

    Indicates that the action or quality gate completed successfully. The item is marked "Completed", and the next item moves to "Pending".

    If you mark a quality gate complete, although not all its criteria passed or were evaluated, you are prompted to provide a reason for completing the gate. Your input is added to the Transition note field. The quality gate's phase is set to "Completed".

    • If none of the criteria were evaluated, the quality gate's success flag is set to "Not evaluated but overriden".
    • If at least one of the criteria failed, the quality gate's success flag is set to "Failed but overriden".
    Fail

    Indicates that the action or quality gate failed. The item is marked "Failed".

    The parent nodes and overall process are labeled as follows:

    • Sequential group or stage: The item's parent groups and stage, and the overall process are marked "Failed". The process stops, and the subsequent actions and stages are suspended.
    • Parallel group or stage: The item's parent groups and stage, and the overall process are marked "Failing". After all the parallel items are processed, if the failed item remains failed, its parent groups and stage, and the overall process are marked "Failed". The process stops, and the subsequent actions and stages are suspended.

    You can retry a failed action or quality gate. In the Release Management module, select the action, and click Retry. The action returns to "Pending". The parent groups, stage and process return to "In Progress".

    Skip Indicates that the action or quality gate was skipped. The item is marked "Skipped". The next action moves to "Pending".
  5. Add a comment regarding the conclusion.

When all actions and quality gates in a stage are completed or skipped, the stage itself is marked "Completed".

Back to top

Complete or skip in advance

You can skip or complete items in a release process that are still in "Planned" phase.

  • Skip items in advance: Select an action, quality gate, group or stage in "Planned" phase and click Skip. All child items in a skipped stage or group are also marked "Skipped".
  • Complete items in advance: Select an action or quality gate in "Planned" phase, and click Complete.

Reopen items

You can reopen items that were skipped or completed in advance: Select an item and click Reopen.

  • If you reopen a stage or group, all its child items are reopened.
  • Reopened items are restored to the phases they had before they were skipped or completed in advance.

Back to top

Quality gate status flags

A flag alongside the quality gate's name signals the quality gate's status:

Flag Details
Not evaluated The default flag as long as the gate's criteria have not been evaluated.
Not evaluated but overriden None of the quality gate's criteria were evaluated. The owner nevertheless marked the quality gate completed or skipped.
Failed

One or more of the quality gate's criteria failed.

Failed but overridden/ skipped One or more of the quality gate's criteria failed. The owner nevertheless either marked the quality gate completed or skipped.
Passed All the quality gate's criteria passed.

Mouse over the status flag to open a hover box displaying the gate's criteria and their evaluations. You can simulate the results of non-evaluated query criteria, or view the results of evaluated query criteria. For details, see Simulate or drill down to query results.

Back to top

Simulate or drill down to query results

You can simulate the results of non-evaluated query criteria, or display the results of evaluated query criteria.

  • For evaluated query criteria, you can click on the result link in the hover box to display a list of the items returned by the query.
  • For non-evaluated query criteria, you can click the Simulate Results link in the hover box to predict what the criteria outcome will be. After the simulation, you can click the result link for each criterion to display a list of the items that the query returns.

    Note:  

    • You can simulate query criteria of quality gates that are in the "Planned" phase only.
    • The simulation reflects the current situation. The results of the actual quality gate evaluation may be different.

Back to top

See also: