Jenkins is an older piece of technology. And yet, if you use Jenkins, it is vitally important to your every day work.

And so enters jenkins-pc-load-letter:

jenkins-pc-load-letter is a small utility for loading jobs into jenkins, and unloading jobs from Jenkins. Jobs are saved off as their native format: XML.

Installation

npm install -g jenkins-pc-load-letter

Usage

Unloading Jobs

Imagine that..

• A jenkins is running at https://jenkins.company.com:8080.
• You created a job on this jenkins named "great-job" and you want to save it off in a file.

You can save this job off as XML with:

jenkins-pc-load-letter unload --jenkins https://jenkins.company.com:8080 --job great-job

This command will cause a file named "great-job.xml" to come into existence that matches the current state of "great-job" on your jenkins. You could check this into source control for safe keeping, or modify it with your favorite text editor and load it back in.

Loading Jobs

Imagine that..

• A jenkins is running at https://jenkins.company.com:8080.
• You have previously unloaded a job named "great-job" and saved it off as XML in a file named "great-job.xml"
• The jenkins that is running does not have a job named "great-job," or it does have this job, but you want what's in the XML file to replace what's on the server.

You can take the contents of a formerly-saved-off job and load it into jenkins with:

jenkins-pc-load-letter load --jenkins https://jenkins.company.com:8080 --file great-job.xml

This command will look for a file named "great-job.xml" and create a job named "great-job" on the jenkins instance. It will update this job so that it matches the file contents if the job already exists.