Links

Pipeline's version history

Learn more about the Pipeline version's history and its functionalities.

Initial information

To access the Pipeline version's history and test the functionalities presented in this article, you need the BETA: PIPELINE-HISTORY permission. To learn more about Digibee’s system roles and their respective permissions, read the article System roles and default groups.

Overview

The Pipeline version's history lists all Minor versions of a pipeline that are associated with its Major version. This allows you to see who last edited each version and when it was edited. You can also know whether a particular version is deployed and in what environment (test or prod).
You can also use the Pipeline version's history to perform various actions, such as edit the last Minor version of the pipeline, view and create a new version from an existing version, and archive a specific version.
To learn more about pipeline versioning conditions, read the article Pipeline versioning.
IMPORTANT: Information about who edited a version is only displayed in versions created on or after February 1, 2022. Versions created before that date have no user data in their history and display the default value of "No data". Pipelines created before February 15, 2021, do not include change date information and display 12/31/1969, by default.

How to access a pipeline’s Version history

On the Build tab, identify the pipeline that has at least one Minor version to access the history.
Then click the View history button:
This displays the Pipeline version’s history, which contains information about all Minor versions of the pipeline.
View the information provided by the Pipeline version’s history:
  • Deployed versions: If one of the minor versions of the pipeline is deployed (test or prod), this information is displayed in the Pipeline version’s history.
  • Version: Minor version of the pipeline;
  • Changed by: Name and email address of the user who edited the pipeline version;
  • Changed at: Date and time when the Minor version was edited;
  • Pipeline description.
You can also select how many items (that is, versions) per page you want to display in the Pipeline version’s history. In addition, you can navigate through the history using the pagination in the lower right corner.

Actions

Depending on the Minor version of the pipeline, certain actions can be performed through the Pipeline version’s history itself.

Edit pipeline

You can edit the latest Minor version of the pipeline as long as it is not archived.
To edit it, click the Edit pipeline button, which will redirect you to Canvas.
Nota: If you edit the latest version of the pipeline and click Save, you create a new Minor version, which is the current version of the pipeline. Only the last Minor version can be edited.

View pipeline

All older versions of a pipeline are available for viewing as long as they are not archived.
To view a specific version on Canvas, click View pipeline.
In Canvas, you can navigate between older Minor versions of a pipeline using Canvas' built-in History. It is not possible to edit the trigger and component settings that make up these versions. The only Minor version that can be edited is the most recent, which is the current pipeline version.
However, you can use the old Minor versions to create the current, editable version of the pipeline. To do so, select the desired old version in Canvas' built-in history and click the Create Minor version button located in the upper right corner of the screen.
Note: To perform this action, the Minor version must not be archived. If it is archived, the Restore button replaces the Create Minor version button.
Still in Canvas, you can view the current version of the pipeline using the See latest version button. As the last version, this pipeline is fully editable.
To return to the version history, click Back to history in the upper left corner of Canvas.

Archive pipeline

You can archive any minor version of the pipeline, old or newer, by clicking Archive pipeline.
Note: Only non-archived versions can be deployed. That is, if a version is archived, it will not be displayed as an option for new deployments.

Restore pipeline

Once a pipeline version is archived, you can restore it using the Restore pipeline button and thus make it available for viewing.

Create new Minor version

You can create a new, current Minor version from an old version as long as it is not archived. To do this, identify the version you want and click the Create new Minor version button. This will create a copy of the version and redirect you to Canvas, where you can edit it.

Terms of use

When using the Pipeline version's history, you automatically subscribeto the Beta program and agree with the terms of use. For more information about beta versions, read the Beta program documentation.