Pipeline's version history
Learn more about the Pipeline version's history and its functionalities.
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.
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.
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.
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.
Depending on the Minor version of the pipeline, certain actions can be performed through the Pipeline version’s history itself.
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.
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.
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.
Once a pipeline version is archived, you can restore it using the Restore pipeline button and thus make it available for viewing.
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.