# 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:

```bash
jenkinsctl job kill -s <HUP|TERM|KILL|1|15|9> <JOB> <BUILD>
```

## Rebuild a job
It is possible to rebuild particular job in a Jenkins web ui, however
there is no rest api endpoint for the `rebuild` operation.

Therefore the `rebuild` option starts new build with the same parameters
as in a build specified by the <BUILD> arg.

Technically there is no differences, you can only notice that a job is
not being rebuilt but started with the same parameters in a console log
output.

```bash
jenkinsctl job rebuild <JOB> <BUILD>
```