Versions Compared

Old Version 58

changes.mady.by.user Erick Jones

Saved on

compared with

New Version Current

changes.mady.by.user Karl Henselin

Saved on

Key

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

A snapshot is a collection of build 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 the release's 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.

...

...

  • snapshot is created with the selected project version overlaid.

...


  • Using a

...

...

  • , 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 Completedstatus 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.

...

To view the list of snapshots for the release, edit the release, and click the Image Modified button.

...

...

Column

...

Description

Description

Column

Snapshot Id

Internal ID of snapshot which is useful with REST API.

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.

Note

Initiated is the final status of an snapshot, and its execution in the pipeline is tracked through execution in the dashboard.

Only one snapshot for a release is allowed to be Pending at a time.  If there is already a pending snapshot, you will see the following warning, and you must wait for it to complete or fail before created another snapshot.

   Image Modified

Created On

The date & time on which the snapshot was created.

Created By

The 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 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 Gates Complete - The snapshot has completed the gates, but is not running steps yet (e.g. another snapshot is running steps in that stage).

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

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

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

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

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

...

To view the details of the projects in the snapshot, click on the link in the Snapshot Name column.Image Removed

...

 

Column

Description

Project Name

The name of the project within the snapshot.

Project Version

The version of the project build within the snapshot.

Package Name

The package name for the project build within the snapshot.  Only applies to partial deployment projects. If All Files is being used, you will see (All Files) for package name.

Branch

The Branch from which the project version was built.

Request All Files

Whether 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

Statuses are:

  • Pending - the project is has not yet been

built

  • processed for the snapshot. There may be number of different outcomes for project, i.e. may be built or just new version may be used.

  • Failed - the project has failed to build.

  • Build Submitted - the project is currently being built for the snapshot.

  • New Build Completed - the project has been built successfully for the snapshot.

  • Failed - the project has failed to build.
    • Existing - the snapshot is utilizing an already built version of the project

    • This will be seen only if build was submitted during create snapshot process.

    • No Previous Version - the project was not present in previous snapshot, so it is newly added to snapshot.

    • No Change - project version is same as previous snapshot.

    • Newer Version - project version is newer than previous snapshot. Project was built manually, triggers, rest call or using incoming webhook.

    • Older Version - project version is older in comparison to previous snapshot. User must have selected older version for backout purposes during create snapshot process.

    Note

    Once the all project versions in the snapshot are

    Completed or Existing

    completed successfully, the snapshot will be Completed, and then sent for pipeline execution (Initiated). If any project versions fails to build, snapshot will be marked as Failed and will not be executed through pipeline.

    Error Message

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

    Created

    Built On

    The date and time

    in which the snapshot was created

    when build was executed.

    Created

    Built By

    The user who

    created the snapshot

    initiated build.

    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.

    build was initiated by automated process. For example,

    • webhook - If build was triggered by incoming webhooks.

    • buildsubmitmonitor - if build was triggered during create snapshot (initiated by user or release schedule)

    To view the commit details of the snapshot version select the Show Commit Details checkbox.

    ...

    Column

    Description

    Project Name

    The name of the project within the snapshot.

    Project Version

    The version of the project build within the snapshot.

    Package Name

    The package name for the project build within the snapshot.  Only applies to partial deployment projects. If All Files is being used, you will see (All Files) for package name.

    Branch

    The Branch from which the project version was built.

    File Type

    The object type of the file if applicable. 

    File Name  (with Path)

    The path and name for the specific file.

    Sequence

    The sequence number of the file within the package if applicable.

    Revision

    The latest SCM revision for the file or project.

    Committed By

    The committer username for the SCM revision.

    Commit Message

    The commit message for the SCM revision.

    Built On

    The date and time when build was executed.

    Built By

    The user who initiated build. 

    Note

    The user will be a system user if build was initiated by automated process. For example,

    • webhook - If build was triggered by incoming webhooks.

    • buildsubmitmonitor - if build was triggered during create snapshot (initiated by user or release schedule)