Skip to content

hubot-js/gear-jenkins

Repository files navigation

gear-jenkins

Build Status npm Coverage Status Code Climate dependencies Status devDependencies Status

A Hubot Gear for handle Jenkins tasks

This is a gear to add to hubot.js the ability to interact with Jenkins. If you do not know the hubot.js or do not know what they are gears like this click here for more details.

start-job

Starting

To use this gear you must first activate it with the command:

activate jenkins

activate

Configurations

Some settings are required. They can be made by Slack using the following command:

configure jenkins

configure

These settings are stored, so you just need to do them once. But if necessary can make them again.

Below are the details about each setting:

Jenkins url

If you use Jenkins without security (authentication) the authorization link is simply the access url. For example: http://your.jenkins.com:8080

If you use the Jenkins authentication, you need to find your access token. It can be obtained from yourJenkinsUrl/me/configure. See more details here. In this case your authorization link should be in this format: http://your_user:your_token@your_jenkins_url

Usage

When hubot.js starts you can call Jenkins of jobs writing the following sentence. Replace "my-deploy" with the name of your job.

hubot start job my-deploy

start-job

Development setup

  • Fork and clone this project
  • In the main directory run npm installto install dependencies.
  • Write your code. More Jenkins functions can be found here.
  • To run tests use npm test command

Meta

Robson Bittencourt - @rluizv - [email protected]

Distributed under the MIT license. See LICENSE for more information.

https://github.com/hubot-js/gear-jenkins