PlasticSCM2.13Minimum Jenkins requirement: 1.580.1ID: plasticscm-plugin
In order to configure the plugin, you need a "cm" executable installed in the Jenkins server machine. Then, please follow these steps:
- Open the system configuration page "Manage Jenkins" and navigate to "Configure System".
- Then, search the "Plastic SCM" section and enter the path to the "cm" (the command line client).
With Plastic SCM selected in the Source Code Management section of your job, enter the required selector (see picture below). In this textbox you can configure the repository to use and the branch that should be loaded in the workspaces managed by Jenkins. Optionally, select whether the workspace should be cleared between builds; or change the generated workspace name; or add multiple Plastic SCM workspaces to the Jenkins workspace.
The plugin will automatically create the needed workspaces pointing to the specified branch.
You can setup not only branches (which is the normal case), but labels as well as changesets in the selector.
You can also use build parameters in the selector.
Example: Imagine that you define two build parameters in a project:
branchname- default value (/main)
repositoryname- default value (default)
Then you can use those parameters in the Plastic SCM selector using
%parameter_name%. In this case you could write the following selector:
The plugin requires that Plastic SCM "cm" command line tool is installed on the master and slave machines.
Plugin version information
This plugin has been developed by Codice Software S.L., owner of the Plastic SCM product.
Visit us at:
Feel the power of merging branches easier than ever with SemanticMerge:
- Added support for the lightweight checkout feature in the pipeline jobs. It requires that the latest version of 'cm' is installed.
- The environment variables were not published when there were no new changes in the build. Fixed.
In Blue Ocean, if a build included multiple changesets, only the first one was rendered in the details. Also, the info for the commit and timestamp columns were not filled. Fixed.
Reduced the number of duplicated builds that can happen using the Plastic SCM plugin. Now, the scm polling takes into account the current build, avoiding to start a new build for the same changeset.
We fixed an issue configuring existing pipeline projects: the PlasticSCM entry didn't appear in the SCM dropdown list if the pipeline was set to get the script from SCM.
Also, now the Plastic SCM configuration will automatically propose a default workspace name for the first (mandatory) workspace.
From now on, each build will publish environment variables containing the data of the built changeset for each configured workspace. These are the variables exposed by the main workspace of the project:
- PLASTICSCM_CHANGESET_ID: Number of the currently built changeset
- PLASTICSCM_CHANGESET_GUID: GUID of the currently built changeset
- PLASTICSCM_BRANCH: Name of the branch in Plastic SCM
- PLASTICSCM_AUTHOR: Name of the user who created the currently build changeset
- PLASTICSCM_REPSPEC: The configured repository specification for the current build
Additional workspaces will include their position in the list, like this:
- The required core version is now 1.580.1
- Added support for pipelines
- Fixed builds being triggered if connection with the Plastic SCM server was lost.
- Plastic SCM commands will be retried 3 times from now on, waiting 0.5 seconds between retries.
The pipeline script syntax for Plastic SCM is:
- Fixed a problem causing parameterized builds to have their workspaces deleted before each build run.
- Replaced all relative paths (implicit or explicit) with full, explicit paths. This fixed several issues on Mac OS X since apparently the current working directory for VCS commands is being set to '/' by Jenkins.
- Cross-platform setups (linux server + windows agents) were deleting workspaces before each build, regardless of the actual "Use update" checkbox value. Fixed.
- Workspaces were being deleted before each build on Windows, regardless of the actual value of the "Use update" checkbox. Fixed.
- Added build parameters support in the Plastic SCM selector. Jenkins allows to define build parameters (https://wiki.jenkins-ci.org/display/JENKINS/Parameterized+Build), and Plastic SCM now can use those parameters in its selector.
IMPORTANT NOTE: When using parametrized builds, maybe the Poll SCM feature may not work as expected because Jenkins performs the poll with the LAST USED workspace. So maybe the selector is not placed in the branch you expect the poll is performed.
When using parametrized builds we recommend setting up two Jenkins projects:
- One for the parametrized build
- Other, with an static selector to perform the poll.
- Fixed: When a changeset was a result of a merge, Jenkins was not able to properly present modified elements in 'Changes' chapter.
- The Jenkins workspaces now support multiple Plastic SCM workspaces.
- Fixed an issue related to the non-ASCII characters included on the date on some cultures such as Korean culture.
- Support labels and changesets in the Plastic SCM selector.
- The plugin did not reuse Plastic SCM workspaces correctly when the 'Use update' preference was set. Fixed.
- Plugin adapted to Plastic SCM version 4.
- Initial version.