jflint

A helper tool to lint a Declarative Jenkinsfile

Description

This tool helps to lint a Declarative Jenkinsfile.

The official document provides a ssh approach and a curl approach to lint a Declarative Jenkinsfile. However, both approaches are a bit complicated for daily use.

So I created this tool to lint easily. This tool itself does not lint a Jenkinsfile, but sends a request to Jenkins in the same way as curl approach and displays the result.

Install

$ npm install jflint -g

Usage

$ jflint [options] /path/to/Jenkinsfile

Options

-j or --jenkins-url

Specify the URL of Jenkins to lint Jenkinsfile. The URL must be passed by this option or a config file.

-u or --username

Specify username for Jenkins. Username is required when security is enabled on Jenkins.

-p or --password

Specify password or API token for Jenkins. Password or API token is required when security is enabled on Jenkins.

--csrf-disabled

Specify this options when CSRF security setting is disabled on Jenkins.

-c or --config

Specify a path to config file.

--ssl-verification-disabled

Disable SSL verification.

Config file

You can load options from json file like the following.

{
  "jenkinsUrl": "http://jenkins.example.com",
  "username": "admin",
  "password": "p@ssword"
}

Config file is searched in the following order.

• the path specified by -c|--config
• .jflintrc from the current directory all the way up to the filesystem root
• ${HOME}/.jflintrc

If the same setting is specified in both option and config file, the option setting overrides the config setting.

Contribution

1. Fork
2. Create a feature branch
3. Commit your changes
4. Rebase your local changes against the master branch
5. Run npm test
6. Create new Pull Request

License

MIT

Author

miyajan: Jumpei Miyata miyajan777@gmail.com

0.3.2 (2018-10-16)

Bug Fixes

• cli: fix function binding (ada25ae)

0.3.1 (2018-10-16)

Bug Fixes

• cli:
  • Allowing CLI to return success when Jenkins node is running on Windows (CRLF endings) (cd96dbf)

0.3.0 (2018-03-18)

Features

• cli:
  • Add option for disabling SSL verification (d974c11)

0.2.0 (2017-03-23)

Features

• cli:
  • find .jflintrc from the current directory all the way up to the filesystem root (319a80cd)

0.1.1 (2017-03-17)

• update readme

0.1.0 (2017-03-12)

• First Release