Integrate Acrolinx into Jenkins
Make sure you're familiar with how to configure and run the CLI.
We assume that your project already contains a CLI configuration file like .cli-config.json
.
We also assume that the Jenkins agent runs on linux. If not, you might have to make some minor changes.
How to Set Up a Job
Set up a new Freestyle Jenkins job:
Or modify an existing:
Specify the repository you want to check:
Configure the Access Token and the Acrolinx URL. Depending on security and your infrastructure, you can:
Use the
Mask Passwords Plugin
:Set the environment variables on the agent, or
store the settings to the CLI config file.
Make sure that the CLI is installed on the Jenkins agent. To be able to run the CLI, you might have to set the executable permission.
chmod +x bin/acrolinx-cli*
Add an
Execute shell
build step, that calls CLI with its config:bin/acrolinx-cli* check --config .cli-config.json
Make sure that you installed the
JUnit Plugin
.Configure a post build action to publish the test results of
results/xunit.xml
.Save the job configuration.
To run the job, click
Build Now
:To show a trend diagram, the publish test results post build action requires two, or more runs. Afterwards a diagram is shown:
Jenkins will also show failing tests by in the build status:
For each checked file, one XUnit test case is created. By default the CLI fails a test case, if the status is red, or yellow. You can restrict the failing of the tests to red only by specifying the option --fail-on-red
.
Jenkins can also be configured to fail the job, if tests fail.