To create a new snapshot, click on the button in the top right corner of the Release page.
Snapshot is created via few different options either automatically or manually. For example,
Developer performs build using Release from project screen.
Build is created due to Continuous Integration setup on project screen and code is committed to source control system.
User performs promote to release on specific version.
Entire snapshot is built using details defined on this page. This option is useful if you are 1) initiating build on many projects by selecting New for Project Version, 2) recreating snapshot from previous snapshot with few versions reverted to previous version if necessary.
All these options can be initiated from UI or REST API.
Field | Description |
---|---|
Snapshot Description | An optional description for the release. |
Autofill From Snapshot | Autofill new snapshot with the values from a previous snapshot as a starting point. |
Skip Stages | Specify which stages can be skipped during pipeline execution. Will be disabled if there is only one stage on the pipeline. |
<Snapshot Inputs> | Additional inputs that are defined on the pipeline’s properties. |
Release Content
For each of the project/package in the release, request new builds, or specify the version information of existing builds.
Column | Description |
---|---|
Priority | The priority of the project/package as defined on release. |
Project | The name of the project. Includes the folder path of the project. |
Package | The name of the package in the release (read-only). Applies to partial deployment projects only. |
Branch | The Branch from which the project version will be built. |
Project Version | The build version for the project/package to include in the snapshot. Or select New to create a new build or pull in latest version. When using New
|
Build Environment | If selecting New for project version for the project/package, select the build environment. |
Force Build? | If selecting New for project version for the project/package, select whether to force build it in case of no SCM changes. |
Enter the project/package details for the snapshot as described above, and click the button in the lower-right to submit the request. Once the snapshot is created it will be sent to the pipeline for execution, and can be viewed in the Release Dashboard.
Keep in mind that if executing new builds as part of the snapshot, this could take several minutes. To view the status of the snapshot click on the Execution tab on the release. Pending snapshots will always be displayed first.
Snapshots can only be created for Started releases with an assigned pipeline and contains at least one project that can be built. If you had just created your release, be sure to assign a pipeline and add projects that are buildable. If your release is paused, be sure to re-start it.