Jenkins is an open source automation server. It helps automate the parts of software development related to building, testing, and deploying, facilitating continuous integration and continuous delivery. It is a server-based system that runs in servlet containers.
Qase integration for Jenkins allows you to start your automated runs directly from Qase, without the need to go to Jenkins to set them up separately.
Installation
Log into your Jenkins instance.
Create a Jenkins API token and copy it.
Go to the Apps page in Qase.
Choose Jenkins app:
Click the “Install now” button:
Input your data in the form and press the “Install” button:
Usage
Go to the Test Runs page.
Click the “Start new test run” button
Select "Automated" test run to be created:
Select Jenkins CI/CD system:
Then choose a Job, which you want to start and fill in other parameters:
Start the test run
You can observe the pipeline status:
...and the pipeline result:
How to use Jenkins with Qase reporters
Prepare a job that runs your tests.
Configure a Qase reporter for your testing framework.
Make your job parameterized:
Add string parameters for the Qase reporter. They will be used to link test results with automated test runs and they will be filled in by Qase automatically:
QASE_PROJECT_CODE
QASE_RUN_ID
QASE_REPORT
QASE_RUN_COMPLETE
QASE_API_BASE_URL
Go to the Apps page on Qase, then activate and generate a new token for Reporter App. You can also use regular (user-issued) API tokens.
Save created token as credentials in Jenkins: https://www.jenkins.io/doc/book/using/using-credentials/#adding-new-global-credentials
Configure your job to pass saved token in QASE_API_TOKEN environment variable:
You can also use the Pipeline plugin. Example Jenkinsfile is below:
pipeline {
agent {
kubernetes {
yaml '''
spec:
containers:
- name: node
image: node:16.14.2-alpine3.15
command:
- sleep
args:
- 99d
'''
}
}
parameters {
string(name: 'QASE_PROJECT_CODE')
string(name: 'QASE_RUN_ID')
string(name: 'QASE_REPORT')
string(name: 'QASE_RUN_COMPLETE')
string(name: 'QASE_API_BASE_URL')
credentials(name: 'QASE_API_TOKEN', credentialType: "Secret text")
}
environment {
QASE_TESTOPS_API_TOKEN = credentials("${params.QASE_API_TOKEN}")
}
stages {
stage('Setup Environment Variables') {
steps {
script {
// Map existing variables to new ones
env.QASE_TESTOPS_PROJECT = params.QASE_PROJECT_CODE
env.QASE_TESTOPS_RUN_ID = params.QASE_RUN_ID
env.QASE_TESTOPS_RUN_COMPLETE = params.QASE_RUN_COMPLETE
}
}
}
stage('Run tests') {
steps {
git url: 'https://github.com/foo/bar.git', branch: 'main'
container('node') {
sh 'npm i'
sh 'npx jest'
}
}
}
}
}