92

I recently updated the configuration of one of my hudson builds. The build history is out of sync. Is there a way to clear my build history?

Please and thank you

5

18 Answers 18

119

Use the script console (Manage Jenkins > Script Console) and something like this script to bulk delete a job's build history https://github.com/jenkinsci/jenkins-scripts/blob/master/scriptler/bulkDeleteBuilds.groovy

That script assumes you want to only delete a range of builds. To delete all builds for a given job, use this (tested):

// change this variable to match the name of the job whose builds you want to delete
def jobName = "Your Job Name"
def job = Jenkins.instance.getItem(jobName)

job.getBuilds().each { it.delete() }
// uncomment these lines to reset the build number to 1:
//job.nextBuildNumber = 1
//job.save()
7
  • great trick, but how about resetting the build counter? any scripting for that? Commented May 14, 2015 at 9:15
  • 1
    @JesChergui I've updated to show resetting the build number. The script console lets you control all sorts of things, see javadoc.jenkins-ci.org (AbstractProject is a good place to start for playing with jobs)
    – rjohnston
    Commented May 14, 2015 at 23:49
  • My Jenkins complained that it wasn't allowed to access instances, or such like. I was running it from a new pipeline I'd setup specifically for this deletion and I pasted in the code above and changed the name.
    – Will
    Commented Jan 18, 2017 at 7:45
  • @Will this is due to the script security plugin which puts pipeline jobs in a super restrictive sandbox. See if you have a signature to approve under "Manage Jenkins" > "In-process script approvals". Another option would be to use the Scriptler plugin's ability to run admin scripts in a job: wiki.jenkins-ci.org/display/JENKINS/Scriptler+Plugin
    – rjohnston
    Commented Jan 18, 2017 at 9:58
  • I am getting this error ; java.lang.NullPointerException: Cannot invoke method getBuilds() on null object Commented Apr 9, 2020 at 13:22
84

This answer is for Jenkins

  1. Go to your Jenkins home page → Manage JenkinsScript Console

    Enter image description here

  2. Run the following script there. Change copy_folder to your project name

Code:

def jobName = "copy_folder"
def job = Jenkins.instance.getItem(jobName)
job.getBuilds().each { it.delete() }
job.nextBuildNumber = 1
job.save()

My post

4
  • 8
    Best answer so far Commented Jul 12, 2016 at 9:25
  • 2
    This is the fastest solution. Commented Nov 17, 2016 at 21:00
  • Yeah, but for this one, DON'T restart Jenkins or it doesn't seem to update the nextbuildnumber to 1 when you do a build after the restart. Mine started at 39 so I had to redo this.
    – Will
    Commented Jan 18, 2017 at 7:42
  • Working as of Jenkins 2.75
    – ѺȐeallү
    Commented Aug 29, 2017 at 20:06
51

If you click Manage Hudson / Reload Configuration From Disk, Hudson will reload all the build history data.

If the data on disk is messed up, you'll need to go to your %HUDSON_HOME%\jobs\<projectname> directory and restore the build directories as they're supposed to be. Then reload config data.

If you're simply asking how to remove all build history, you can just delete the builds one by one via the UI if there are just a few, or go to the %HUDSON_HOME%\jobs\<projectname> directory and delete all the subdirectories there -- they correspond to the builds. Afterwards restart the service for the changes to take effect.

4
  • I have deleted all files and folders inside "/var/lib/jenkins/jobs/Demo" but I when go to Jenkins UI inside this JOB I still see builds history.
    – paul
    Commented Apr 2, 2014 at 7:10
  • 1
    After you "monkey" with the directory structure, just go to "Manage Jenkins" and select "Reload Configuration From Disk"
    – DanBaker
    Commented Oct 3, 2014 at 15:21
  • 1
    @paul, after delete the folders there, a restart of Jenkins is needed to see the build history disappeared from the UI. BTW, if we're using Jenkins, the path is typically located at /var/jenkins_home/jobs/{project name}/builds/
    – Bright
    Commented Jun 9, 2016 at 2:42
  • I think this solution requires to much steps on the system side, a much more clean solution is provided in the answer from @Nayana Adassuriya
    – lfn
    Commented Sep 11, 2018 at 21:41
24

Here is another option: delete the builds with cURL.

$ curl -X POST http://jenkins-host.tld:8080/jenkins/job/myJob/[1-56]/doDeleteAll

The above deletes build #1 to #56 for job myJob.

If authentication is enabled on the Jenkins instance, a user name and API token must be provided like this:

$ curl -u userName:apiToken -X POST http://jenkins-host.tld:8080/jenkins/job/myJob/[1-56]/doDeleteAll

The API token must be fetched from the /me/configure page in Jenkins. Just click on the "Show API Token..." button to display both the user name and the API token.

Edit: one might have to replace doDeleteAll by doDelete in the URLs above to make this work, depending on the configuration or the version of Jenkins used.

1
  • Super useful, thank you! This is the only answer (on this question anyway) which allows for selective deletion, for instance when you discover a job that wasn't previously configured to discard old builds and want to get rid of a lot (but not all) of history. Commented Mar 17, 2022 at 2:50
12

Here is how to delete ALL BUILDS FOR ALL JOBS...... using the Jenkins Scripting.

def jobs = Jenkins.instance.projects.collect { it } 
jobs.each { job -> job.getBuilds().each { it.delete() }} 
1
  • jenkins 2.293 returned : Result: [] and build were not removed
    – JRichardsz
    Commented Jul 14, 2022 at 22:43
9

You could modify the project configuration temporarily to save only the last 1 build, reload the configuration (which should trash the old builds), then change the configuration setting again to your desired value.

2
  • Sorry, haven't used Hudson now for a couple of years, but see this about reloading the configuration: stackoverflow.com/questions/5216552/… Commented Feb 26, 2014 at 22:41
  • As someone who does not have admin permissions to Jenkins, this was the only option that worked for me. Commented Jan 30, 2019 at 21:36
8

This one is the best option available.

Jenkins.instance.getAllItems(AbstractProject.class).each {it -> Jenkins.instance.getItemByFullName(it.fullName).builds.findAll { it.number > 0 }.each { it.delete() } }

This code will delete all Jenkins Job build history.

2
  • 3
    For anyone wondering how to run the above code, go to Jenkins Home > Manage Jenkins > Script Console. There will be a text field there that you can enter this script into. Commented Mar 28, 2019 at 16:38
  • jenkins 2.293 returned the job names but builds were not removed
    – JRichardsz
    Commented Jul 14, 2022 at 22:44
7

If you want to clear the build history of MultiBranchProject (e.g. pipeline), go to your Jenkins home page → Manage Jenkins → Script Console and run the following script:

def projectName = "ProjectName"
def project = Jenkins.instance.getItem(projectName)
def jobs = project.getItems().each {
  def job = it
  job.getBuilds().each { it.delete() }
  job.nextBuildNumber = 1
  job.save()
}
1
  • This is the only that worked. Thanks Marin!
    – Rodyb
    Commented Jul 24, 2021 at 19:29
3

Using Script Console.

In case the jobs are grouped it's possible to either give it a full name with forward slashes:

getItemByFullName("folder_name/job_name") 
job.getBuilds().each { it.delete() }
job.nextBuildNumber = 1
job.save()

or traverse the hierarchy like this:

def folder = Jenkins.instance.getItem("folder_name")
def job = folder.getItem("job_name")
job.getBuilds().each { it.delete() }
job.nextBuildNumber = 1
job.save()
2

Deleting directly from file system is not safe. You can run the below script to delete all builds from all jobs ( recursively ).

def numberOfBuildsToKeep = 10
Jenkins.instance.getAllItems(AbstractItem.class).each {
  if( it.class.toString() != "class com.cloudbees.hudson.plugins.folder.Folder" && it.class.toString() != "class org.jenkinsci.plugins.workflow.multibranch.WorkflowMultiBranchProject") {
    println it.name
    builds = it.getBuilds()
    for(int i = numberOfBuildsToKeep; i < builds.size(); i++) {
        builds.get(i).delete()
      println "Deleted" + builds.get(i)
    }
  }
}
2

Go to "Manage Jenkins" > "Script Console"

Run below:

def jobName = "build_name"  
def job = Jenkins.instance.getItem(jobName)  
job.getBuilds().each { it.delete() }  
job.save()
1

Another easy way to clean builds is by adding the Discard Old Plugin at the end of your jobs. Set a maximum number of builds to save and then run the job again:

https://wiki.jenkins-ci.org/display/JENKINS/Discard+Old+Build+plugin

1

Go to the %HUDSON_HOME%\jobs\<projectname> remove builds dir and remove lastStable, lastSuccessful links, and remove nextBuildNumber file.

After doing above steps go to below link from UI
Jenkins-> Manage Jenkins -> Reload Configuration from Disk

It will do as you need

1

If using the Script Console method then try using the following instead to take into account if jobs are being grouped into folder containers.

def jobName = "Your Job Name"
def job = Jenkins.instance.getItemByFullName(jobName)

or

def jobName = "My Folder/Your Job Name
def job = Jenkins.instance.getItemByFullName(jobName)
0

Navigate to: %JENKINS_HOME%\jobs\jobName

Open the file "nextBuildNumber" and change the number. After that reload Jenkins configuration. Note: "nextBuildNumber" file contains the next build no that will be used by Jenkins.

0

Tested on jenkins 2.293 over linux. It will remove all the build logs but not the corellative build number

cd /var/lib/jenkins/jobs
find . -name "builds" -exec rm -rf {} \;

Be careful with this command because it executes a rm -rf on each find result. You could exec this first to validate if the result are only the builds folder of you jobs

find . -name "builds"
0

If you are looking for a solution where you have job inside a Folder you can use getItemByFullName function. It also supports white space in folder and job name.

def jobName = "folder_name/job_name"
def job = Jenkins.instance.getItemByFullName(jobName)
job.getBuilds().each { it.delete() }
job.nextBuildNumber = 1
job.save()
0

Go to your Jenkins home page → Manage Jenkins → Script Console

def jobName = "copy_folder"  
def job = Jenkins.instance.getItem(jobName)  
def maxBuildNumber = job.getBuilds().collect { it.number }.max() ?: 0
job.getBuilds().each { it.delete() }  
job.nextBuildNumber = maxBuildNumber + 1   
job.save()

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.