JenkinsFile default workspace name is too long

Question

I am currently setting up jenkins with bitbucket. I have create a new jenkins project as multibranch project.

The JenkinsFile is hosted inside the git repository. How can I force jenkins to generate a shorter branch name than the default one.

E:\jenkins\workspace\reposName-BrancheName-ZKIZ7BNGL6RTDKLQAQ7QR4FKZMOB3DDAVZ564BLWT2BY5ZV652VA

How can I get ride of ZKIZ7BNGL6RTDKLQAQ7QR4FKZMOB3DDAVZ564BLWT2BY5ZV652VA

This is my jenkinsFile

#!/usr/bin/env groovy
env.PATH = env.PATH + ";c:\\Windows\\System32"
def call(String label = null, Closure body) {
    node(label) {
        String path = pwd()
        String branchName = env.BRANCH_NAME
        if (branchName) {
            path = path.split(Pattern.quote(File.separator))
            def workspaceRoot = path[0..<-1].join(File.separator)
            def currentWs = path[-1]
            String newWorkspace = env.JOB_NAME.replace('/', '-')
            newWorkspace = newWorkspace.replace(File.separator, '-')
            newWorkspace = newWorkspace.replace('%2f', '-')
            newWorkspace = newWorkspace.replace('%2F', '-')
            if (currentWs =~ '@') {
                newWorkspace = "${newWorkspace}@${currentWs.split('@')[-1]}"
            }
            path = "${workspaceRoot}${File.separator}${newWorkspace}"
        }
        ws(path) {
            body()
        }
    }
}

pipeline 
{
} // pipeline

Is there a way to force Jenkins to generate a shorter name?

Why exactly is it a problem? Are you getting an error somewhere? — metalisticpain, May 13 '18 at 10:06
@metalisticpain : yes, the file path is too long on a windows server :/ limitation from the 80's :p — pix, May 22 '18 at 10:02
ahhh, I do not have the answer unfortunately. Other than switch to linux ;) — metalisticpain, May 23 '18 at 01:53
ah, use ws() to set your own workspace. See https://stackoverflow.com/a/43577784/7223663 — metalisticpain, May 23 '18 at 04:54
A really long path can also break Python virtualenvs. Just running `pip` gives really strange errors, which hint at the shebang line not working correctly. — akaihola, Jul 09 '19 at 13:15

score 9 · Answer 1 · answered Sep 13 '18 at 08:30

9

You can change value of jenkins.branch.WorkspaceLocatorImpl.PATH_MAX=20 in jenkins's script console.

Changes will be lost if you restart jenkins server. To make the changes permanent, add this java property -Djenkins.branch.WorkspaceLocatorImpl.PATH_MAX=20

answered Sep 13 '18 at 08:30

vishesh

113
1
7

This does not work for me because I am not able to change any parameters as @Vishesh Jindal suggest it. If I can not test it, I will not accept this answer even if it is working for the others. sorry – pix Oct 31 '18 at 14:45
@pix you need to have ssh access to your jenkins instance for this or privileges to administer on Jenkins to use script console. – vishesh Nov 27 '18 at 10:37
@VisheshJindal I do not have any admin acess or ssh access – pix May 07 '19 at 09:21

score 3 · Accepted Answer · answered May 23 '18 at 08:20

This is not the best way to fix it, but it is working :)

First create a method to get the current workspace and rework the final path like this:

def GetWorkspace()
{
    node
    {
        String path = pwd()
        String branchName = env.BRANCH_NAME
        if(branchName)
        {
            path = path.split(Pattern.quote(File.separator))
            def workspaceRoot = path[0..<-1].join(File.separator)
            def currentWs = path[-1]
            // Here is where we make branch names safe for directories -
            // the most common bad character is '/' in 'feature/add_widget'
            // which gets replaced with '%2f', so JOB_NAME will be
            // ${PR}}OJECT_NAME}%2f${BRANCH_NAME}
            String newWorkspace = env.JOB_NAME.replace('/', '-')
            newWorkspace = newWorkspace.replace(File.separator, '-')
            newWorkspace = newWorkspace.replace('%2f', '-')
            newWorkspace = newWorkspace.replace('%2F', '-')
            // Add on the '@n' suffix if it was there
            if (currentWs =~ '@') 
            {
                newWorkspace = "${newWorkspace}@${currentWs.split('@')[-1]}"
            }
            path = "E:\\Jenkins\\workspace\\${File.separator}${newWorkspace}"
        }

        return path
    }
}

Then you have to set it up to our agent like this

pipeline {

environment {
   //Your Env Setup
  }

  agent { //Global Agent.
    node {
      label 'AgentName'
      customWorkspace GetWorkspace()
    }
  }

This seems like a more work than necessary compared to just setting a limit with a JVM argument — starscream_disco_party, Apr 25 '19 at 17:50
I wish I could change the JVM argument.... @starscream_disco_party but thx for this helpfull comment :) — pix, May 07 '19 at 09:19

JenkinsFile default workspace name is too long

2 Answers2