The Eggplant DAI Plugin for Jenkins launches DAI tests from within a Jenkins pipeline. You can use it to continuously test your application using Eggplant's model-based approach to testing. For more information about Eggplant, visit https://www.eggplantsoftware.com.
Step 1: Login to your Jenkins
Go to http://localhost:{portnumber}/ and login into your Jenkins account
Step 2: Manage Jenkins
-
Go to Available and enter Eggplant Runner in the search feature
-
Check on the Eggplant Runner and click on Install without restart
Step 1 : Create new project -> Freestyle project -> Click OK
Step 2: Add Eggplant Runner as build step
Step 3: Fill in Eggplant Runner parameter's value -> Click Save
Required The URL of the Eggplant DAI server, e.g. http://localhost:8000
.
Required The ID of the Eggplant DAI test configuration that you want to run, e.g. 09c48b7d-fc5b-481d-af80-fcffad5d9587
.
Test configuration ID can be obtain by go to test config > look for a particular test config > test config id can be obtain from url.
Required The client secret to use to authenticate with the Eggplant DAI server, e.g. e9c15662-8c1b-472e-930d-aa0b11726093
.
Alternatively, you could set a repo secret in Repo Settings > Secrets > Actions
and refer to it like below:
clientSecret: "${{ secrets.DAI_CLIENT_SECRET }}"
.
The DAI Client Secret can be obtain by go to http://kc-localhost:8000/auth > client > search for client:dai:agent:integration > credential
Optional The client ID to use to authenticate with the Eggplant DAI server.
Default: client:dai:agent:integration
Optional The timeout in seconds for each HTTP request to the Eggplant DAI server
Default: 30
Optional The number of times to attempt each HTTP request to the Eggplant DAI server
Default: 5
Optional The exponential backoff factor between each HTTP request
Default: 0.5
Optional The number of seconds to wait between each call to the Eggplant DAI server
Default: 5
Optional The logging level
Default: INFO
Optional The path to an alternative Certificate Authority pem file
Optional Path to a file where the test results will be stored in junit xml format
Example C:\results\result.xml
Build the project to run the step
Execution details are shown in Console Output
Pipeline project
Step 1: Create Pipeline project
Step 2: Copy and paste below scrips into Pipiline script section
pipeline {
agent any
environment {
DAI_CLIENT_SECRET = credentials('eggplant-runner-client-secret')
}
stages {
stage('Eggplant Runner') {
steps {
eggplantRunner serverURL: 'Your DAI server URL', testConfigId: 'Your test configuration that want to execute'
}
}
}
}
โ ๏ธ Usage of backslashes in script: Remember to escape backslashes by replace all instances of\
with\\
inside a string.
For example, rather than:CACertPath: "C:\certs\rootCA.cer"
you would use:CACertPath: "C:\\certs\\rootCA.cer"
Step 3: Setup Public Credential for Client Secret -> Click Ok
Step 4: Build the pipeline project Output are shown in Console Output
This plug-in is licensed under the terms of the MIT license
30th May 2022
- Fix Jenkins Plugins "Eggplant Runner" Client Secret textbox behaviour
You need to install the following dependencies if you want to contribute to the Eggplant DAI Runner for Jenkins:
- You can download and install Java 11 from the Eclipse Temurin website.
- Download Maven from the Apache Maven website. Make sure to download one of the binary archives (with bin in their name).
- To verify that Maven is installed, run the following command:
mvn -version
- You can use
launch.json
to run 'Debug (Attach)' to launch an local Jenkins instance for development.