Helix Plugin for Jenkins Guide (1.11.x)

Static workspace

Uses a predefined workspace, the workspace must have a valid view and must already exist. The plugin user must either own the workspace or the spec must be unlocked allowing the plugin user to make edits. The workspace view remains static, but Jenkins will update other fields such as the workspace root and CLOBBER option.

Static Workspace Configuration

  1. Workspace behaviour: select Static view (static view, master only) from the dropdown list.
  2. Character Set: sets the character set used by Jenkins when syncing files from the Perforce Helix Core server. This should be set to none unless the workspace is connected to a Unicode enabled Helix server.
  3. Workspace name: specify the name of the existing Perforce workspace that will be used as the Jenkins build workspace. If you are connected to a Helix server workspaces will be auto suggested as you type.
  4. Important

    Pipeline:

    • Use a unique workspace name for the Jenkinsfile that will not get reused by the sync steps in the script. A postfix of -script will help to identify the workspace's use and make it unique from code sync steps.
    • Variables in the script for the workspace name must be surrounded by single quotes as shown:

    • name: 'jenkins-${NODE_NAME}-${JOB_NAME}-${EXECUTOR_NUMBER}',

      Using full double quotes " expands the variables early and the script will fail.