Versions Compared

Key

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

A snapshot is a collection of build versions (project versions) for the release's projects which are sent sent through the pipeline.  As a release progresses, newer versions of projects are assembled to create new snapshots.  A release may consist of dozens, or even hundreds or thousands, of snapshots over its lifetime, depending on its size and duration.  There are several ways in which snapshots can be created.

  •  By a release manager by explicitly identifying the versions of the projects/packages in the release.  See Creating a Snapshot.
  •  By associating a project/package build to the release.  As such, once the build completes, the new project version is overlaid on top of the most recent release snapshot to produce a new snapshot.
  •  Using a Continuous Integration trigger (Poll SCM Trigger or Scheduled Build Trigger) to automatically associate the new build with the release.
  •  Using the REST API to submit a build request, and associate it to the release.

 


Tip

All snapshots which reach Completed status are sent to the pipeline for execution, and marked Initiated.  Only one snapshot per release can be created (Pending) at a time.  However, many snapshots can be executing the pipeline for the same release in parallel.

...

Column

Description

Snapshot Name

The system generated snapshot name.

Description

The description which was given when the snapshot was created.

Status

The current status of the snapshot:

  • Completed - The snapshot was successfully assembled, but has not yet been sent to pipeline for execution.
  • Failed - The snapshot failed to be assembled (which could mean the underlying build failed).
  • Failed to Initiate - The snapshot was assembled, but failed to be sent to the pipeline for execution.
  • Initiated - The snapshot has been sent to the pipeline for execution.
  • Pending - The snapshot is in the process of being assembled and set to the pipeline for execution.
Created OnThe date & time in which the snapshot was created.
Created ByThe user who created the snapshot.  The id will be a system id if the snapshot was created due to a project build associated to the release.
<Stages>

The remaining columns represent the execution detail of the snapshot execution in the pipeline.  For each stage of the pipeline, an icon represents its execution status.  If no icon is displayed, the execution has not yet reached that stage.

Image Modified   Aborted - The snapshot execution in the pipeline stage was aborted by a user.

Image Modified   Failed - The snapshot execution in the pipeline stage failed.

Image Modified Out of Date - The snapshot execution has been superseded by a newer snapshot.

Image Added Rejected -  The snapshot execution has been rejected (via an approval gate) by a user.

Image Modified Running - The snapshot execution is currently running in the pipeline stage.

Image Modified Successful - The snapshot execution in the pipeline stage has successfully completed.