Jenkins: wipe workspace directory by job name

clearout_workspace.groovy

# call parametrized with string (JobName must be the fully-qualified name of your job)
# thanks to https://gist.github.com/dnozay/e7afcf7a7dd8f73a4e05 which was useful in figuring this out!
# works on 2.471.9

import hudson.slaves.WorkspaceList

def job = null
try {
    job = Jenkins.instance.getItemByFullName(env.JobName)
} catch (Exception e) {
    println "Failed to get job ${env.JobName} - aborting"
    throw e
}

def GetNodes() {
    def nodes = []
    jenkins.model.Jenkins.instance.computers.each { c ->
        nodes.add(c.node)
    }
    return nodes
}

def combinator = System.getProperty(WorkspaceList.class.getName(),"@");

def CheckWorkspace(workspacePath) {
    // stop checking (unlikely to have higher suffix)
    if (!workspacePath.exists()) {
      println "  * ${workspacePath}: not found"
      return false;
    } 
  
    println "  * found workspace: " + workspacePath.getRemote()
	def targetDir = workspacePath.child('dist')	
	if (targetDir.exists()) {
        if (!job.isBuilding()) {
          println "  * job is idle: removing directory ${targetDir}"
          targetDir.deleteRecursive()
        } else {
          println "  * job is building: not removing directory ${targetDir}"
        }
      }
	return true;    
}


for (node in GetNodes()) {
	println "Node: '${node.getSelfLabel().toString()}' (" + node.getAssignedLabels().join(", ") + ")"
	def workspacePathBase = node.getWorkspaceFor(job)
	println "Workspace: ${workspacePathBase}"
	// handle concurrent workspaces
	for (int i=1; i < 1000; i++) {
		// they are suffixed...
		workspacePath = i==1 ? workspacePathBase : workspacePathBase.withSuffix(combinator+i);
		println "Checking ${workspacePath}"
		if (!CheckWorkspace(workspacePath)) {
			break;
		}
	}  
}