Jenkins Client

Simple client for managing jobs and builds on a Jenkins server. Set a default access token via the JENKINS_PAT environment variable.

Usage

jenkins(server = "http://jenkins.ropensci.org", username = "jeroen",
  token = jenkins_pat(), verbose = FALSE)

Arguments

server

base url of the jenkins server

username

name of the jenkins user to login

token

authentication token (or password) for your jenkins server.

verbose

print http output for debugging

Methods

## jk <- jenkins('https://ci.yourserver.com')
<jenkins>
 $build_info(job_name, build_id = "lastBuild")
 $build_log(job_name, build_id = "lastBuild")
 $build_stop(job_name, build_id = "lastBuild")
 $node_info(node_name = "master")
 $node_list()
 $project_build(job_name, params = list(KEEP_CACHE = "true"))
 $project_build_all(delay = 0.5, shuffle = FALSE, keep_cache = TRUE, update_universe = FALSE)
 $project_config(job_name)
 $project_create(job_name, xml_string)
 $project_delete(job_name)
 $project_disable(job_name)
 $project_enable(job_name)
 $project_list()
 $project_update(job_name, xml_string)
 $queue_cancel(queue_id)
 $queue_cancel_all()
 $queue_info(queue_id)
 $queue_list()
 $server_info()
 $user_info(user_name = username)
 $user_list()
 $view_create(view_name, xml_string)
 $view_delete(view_name)
 $view_info(view_name)
 $view_list()
 $view_update(view_name, xml_string)

References

https://wiki.jenkins.io/display/JENKINS/Terminology

Examples

if (FALSE) # This requires a jenkins server
jk <- jenkins(server = 'http://jenkins.ropensci.org', username = 'jeroen')

# Do stuff
jk$server_info()
#> Error in eval(expr, envir, enclos): object 'jk' not found
jk$project_build('magick')
#> Error in eval(expr, envir, enclos): object 'jk' not found

# It's now in the queue
jk$queue_list()
#> Error in eval(expr, envir, enclos): object 'jk' not found

# Check build status
jk$build_info('magick')
#> Error in eval(expr, envir, enclos): object 'jk' not found

# Get latest build log
jk$build_log('magick', build_id = 'lastCompletedBuild')
#> Error in eval(expr, envir, enclos): object 'jk' not found
 # \dontrun{}