Hubot Yardmaster

Yardmaster is a Hubot plugin that allows you to interact with Jenkins instance remotely. Build jobs, change branches, start builders, lock jobs... The list goes on.

Environment Variables Required:

• HUBOT_JENKINS_URL - Jenkins base URL
• HUBOT_JENKINS_USER - Jenins admin user
• HUBOT_JENKINS_USER_API_KEY - Admin user API key. Not your password. Find at "{HUBOT_JENKINS_URL}/{HUBOT_JENKINS_USER}/configure"
• HUBOT_JENKINS_JOB_NAME - Hubot job name on Jenkins (optional)
• GITHUB_TOKEN - Github API Auth token (optional)
• MONITOR_JENKINS - true | false : If true, hubot will monitor the jenkins queue and start nodes when job queue is greater than 2.

Commands:

• hubot jenkins auth set {username} {api key} - Give Hubot your credentials to use when you issue commands.
• hubot jenkins auth - See what Jenkins username the Hubot has for you.
• hubot jenkins auth clear - Clear your Jenkins credentials.
• hubot switch|change|build {job} to|with {branch} - Change job to branch on Jenkins and build.
• hubot (show|current|show current) branch for {job} - Shows current branch for job on Jenkins.
• hubot (go) build yourself|(go) ship yourself - Rebuilds default branch if set.
• hubot list jobs|jenkins list|all jobs|jobs {job} - Shows all jobs in Jenkins. Filters by job if provided.
• hubot build|rebuild {job} [PARAM1=VALUE1 PARAM2=VALUE2 ...] - Rebuilds job, optionally with parameters.
  • The parameter names must match those defined in Jenkins and currently values cannot have spaces in them.
• hubot build|rebuild {job}
• hubot enable|disable {job} - Enable or disable job on jenkins.
• hubot show|show last|last (build|failure|output) for {job} - show output for last job
• hubot show|show output|output for {job} {number} - show output job output for number given
• hubot set branch message to {message} - set custom message when switching branches on a job
• hubot remove branch message - remove custom message. Uses default message.
• hubot show|show last|last (build|failure|output) for {job} - show output for last job.
• hubot show|show output|output for {job} {number} - show output job output for number given.
• hubot {job} status - show current build status and percent compelete of job and its dependencies.
• hubot set job repos - Pulls list of jobs and repos from jenkins and places in memory to validate branch names if github token provided.
• hubot remove job repos - Will remove job repos from memory.
• hubot watch job {job-url} - Will check job every minute and notify you on completion
• hubot (show|show last|last) (build) (date|time) for {job} - shows the last build date and time for a job
• hubot (start|build) (builder|slave|node) - starts one of the available slave nodes.
• hubot send reinforcements - starts one of the available slave nodes.

Author:

@riveramj