Skip to end of metadata
Go to start of metadata

 

Installation

If you are using Jenkins 1.641 / Jenkins 1.625.3 and later

Jenkins has changed its default security settings. You need to update them to go on using Allure.

See the new "Configure Jenkins Content Security" section in the installation guide

  1. Install Allure Plugin from "Plugin Manager Page".
  2. Open Plugin Advanced Settings (http://<jenkins_host>/pluginManager/advanced). 
  3. Click "Check Updates" button on the bottom right corner of the page.
  4. Configure Allure Commandline from "Jenkins Configure Page".

Configure Jenkins Content Security

By default, Jenkins sets Content Security Policy for plugin pages. Allure requires less strict policy, you can set it via system property.

If you haven't done it before, add the following to Jenkins system properties configuration (you need to set both Hudson and Jenkins properties to make it works):

You can read more about it in the Jenkins docs and find details in issue #715 in the Github repository of allure-core. 

Build agents have connection to maven central

  1. Open "Jenkins Configure Page".
  2. Find "Allure Commandline" configuration block. 
  3. Click "Allure Commandline Installations..." button. 
  4. Fill the name and choose the version of allure report. 

Build agents have NOT connection to maven central 

  1. Download the latest version of allure-commandline.zip from github.
  2. Upload downloaded file to any file server. Build agents must have access to the file by url. For example, http://mycompany.com/allure-commandline.zip
  3. Open "Jenkins Configure Page". and find "Allure Commandline" configuration block. 
  4. Click "Allure Commandline Installations..." button. 
  5. Click "Delete Installer" button.
  6. Click "Add Installer" and choose "Extract *.zip/*.tar.gz".
  7. Fill the name and download url.

Configuration

Job configuration

  1. Open job configuration page.
  2. Ensure that your build generates Allure XML files.
  3. Add Allure Report post build action. 
  4. Configure the Allure Report.

TMS integration

  1. Open Job Configure Page. 
  2. Find Allure Report configuration section.
  3. Setup allure.tests.management.pattern property: 

Issue Tracker integration

  1. Open Job Configure Page. 
  2. Find Allure Report configuration section. 
  3. Setup allure.issues.tracker.pattern property: 

Advanced Options

  1. Open Job Configure Page. 
  2. Find Allure Report configuration section. 
  3. Click "Advanced..." button if you need custom settings of commadline, jdk or build policy

Usage

When build is finished a link to Allure report will appear on the build page:

Extensions

Job DSL Plugin

The job-dsl-plugin allows the programmatic creation of projects using a DSL. 

Job DSL
  • No labels