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

Project Name

The name of the project within the snapshot.
Project VersionThe version of the project build within the snapshot.
Package NameThe package name for the project build within the snapshot.  Only applies to partial deployment projects.
Request All FilesWhether or not the package contains all the files for the project.  Only applies to partial deployment projects.

Status

The status of the individual project version within the snapshot.  Status are:

  • Pending - the project is has not yet been built for the snapshot. 
  • Submitted - the project is currently being built for the snapshot.
  • Completed - the project has been built successfully for the snapshot.
  • Failed - the project has failed to build.
  • Existing - the snapshot is utilizing a an already built version from of the previous snapshotproject.


Note

Once the all project versions in the snapshot are Completed or Existing, the snapshot will be Completed, and then sent for pipeline execution (Initiated).


Error MessageThe error message of the failed build, if the status is Failed.

Created On

The date and time in which the snapshot was created.
Created By

The user who created the snapshot.

Note

The user will be a system user if the snapshot was created via a project build associated to the release, as multiple user may have contributed to it.


...