jenkinsctl

Jenkins manager

The project aims to wrap Jenkins json api and some post requests which can be performed on Jenkins parts (such as 'delete node').

It is a very early stage of development (it'd be better to say hobby project to learn Rust). Current functionality includes: - shutdown Set 'prepare to shutdown' bunner with optional reason - on Set shutdown banner - off Cancel shutdown - restart Restart Jenkins instance (soft/hard) - copy Copy job from the existing one - job Copy job - view Copy view - node Node actions - show Show node information - list List all (with optional status information) - job - list Recursively list all the jobs in an instance - build Build a job (use '-' as param list to build with defaults) - remove Remove a job (use with caution, the action is permanent)

Build a job

There are two types of the jobs in Jenkins: parameterized and un-parameterized.

To build a job without parameters use the following command:

bash jenkinsctl job build <JOB>

To build a job with parameters use:

bash jenkinsctl job build <JOB> [PARAMS]

jenkinsctl accepts parameters in the following format: param=value,...,param=value

You can also perform a parameterized build using defaults:

bash jenkinsctl job build <JOB> -

To stream a job's execution process to stdout, add the -f switch:

bash jenkinsctl job build <JOB> [PARAMS] -f

Abort a job

Jenkins rest api provides three levels of interruption: - stop aborts a pipeline; - term forcibly terminates a build; - kill hard kill a pipeline (the most destructive way to stop a pipeline);

jenkinsctl wraps it with the *nix signals equivalent: