Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To create a new release, navigate to the Search Releases screen using the Releases menu.  

Image Modified

Click on the Image Modified button to create a release.  To edit a release, click on the release name link in the Name column.

Image RemovedImage Added


Field

Description

Name

The name of the release.
Status

The current status of the release (read-only). 

  • Not Started - the release is not yet started, and is not eligible to process snapshot
  • Started - the release is eligible to process snapshots
  • Suspended - the release has been paused, and is not currently eligible to process snapshots
  • Completed - the release has ended, and will never process snapshots again (cannot be resumed).

Description

An optional description for the release.

Start Date

The date and time in which the release was started (read-only).
End DateThe date and time in which the release was ended/completed (read-only).
PipelineThe pipeline which is used to process snapshots for the release.

...

To add multiple projects at a time to the release using filter criteria, click on the  button.

 Image Modified

Optionally enter a criteria in the Project Name or Path field to filter the project list, and click the  button to filter button.  Next, select one or more projects to add to the release, and click  the button, or simply click the  button to add all projects displayed to the release.

...

Once a release is completed, click the  button to end the release.  Like paused/suspended releases, snapshots can be created and sent for execution once ended.  Ended releases cannot be resumed, and at this point you would need to create a new release.

Change Management

The Change Management System tab allows association of the release with any Change Management Instance which was configured in the topology. You must create the instance prior to configuring your release to it. Edit a Release, and select a Change Management System Instance from the drop down to associate it to the release.  Association of a Change Management Instance is optional, and used only to integrate with ServiceNow.


Image Modified

Field

Description

Change Management Instance

The Change Management Instance in Topology to associate with this release.  Optional.

The Default tab provides configuration which applies to every stage of the associated pipeline.  Check the Require Change Ticket for Deployment checkbox if you want to enforce that every stage in the pipeline have an associated change ticket in order to submit a deployment request for that stage/environment.  If any of the execution related steps (e.g. Deploy, Deploy All, etc.) are executed in the pipeline for a stage which requires a ticket, and no ticket is provided, the step will fail indicating a ticket is required.

The Environment Configuration allows configuration by pipeline stage.  To override from the default, click the Image Modified button, and then click the Image Modified button to add a new row.   In the row, select the environment/stage, and indicate whether or not you wish to require a change ticket.  The execution behavior is the same as with default configuration when execution related steps are performed in the the particular environment within the pipeline.  To delete the configuration override for a an environment, click the Image Modified button in the row.  The fallback to the settings on the Defaults tab, click the Image Modified button.

Image Modified

Tip
titleTip

To require a change ticket for Production only, set Require Change Ticket for Deployment to "No" on the Defaults tab, and add an override for Production environment with Require Change Ticket for Deployment" set to "Yes" (on the Environment Configuration tab).

...