Page History

Access "Remote Jobs Trigger" option on Project settings:

Select the desired CI/CD platform to use by selecting "Enable..." configuration on the right. This step is needed only once, and you can have only one CI/CD tool selected at a given time.

Click the button "New Jenkins Configuration" to create a new configuration:

The new configuration screen will be displayed, and you can fill in the input field regarding your CI/CD platform.

Generic fields:

• Configuration Name (Mandatory) - Name of the configuration; this is the reference that will be used on Test Plan/Test Execution on the "Trigger Build" option;
• Parameters (optional) - The list of key/value parameters that you might have defined on your build and want to pass from Xray. 
  To add more parameters, click the option "Add" option to have a new Key/Value added to the list.
  Click the "x" option to remove parameters right after the Key/Value row.
  
  You may also use the following options to add to the parameter value regarding Xray entities:
  • ${ISSUE_KEY} - this will be replaced with the issue key that the user is triggering the build from;
  • ${TESTS_KEY} - this value will then be replaced with a comma-separated string of test keys part of the issue the user is triggering the build from;
  • ${PROJECT_KEY} - this value will then be replaced with the project key;
  • ${USER} - this value will then be replaced with logged user triggering the build.
    

CI/CD specific fields:

• Jenkins:
  • Job Name (Mandatory) - Exact job name defined on your Jenkins instance;
  • API Token (Mandatory) - API token defined on Jenkins for this specific job;
  • Username (Mandatory) - Jenkins user ID/name;
  • API URL (Mandatory) - Jenkins endpoint URL: e.g., jenkins.cloud.getxray.app/
  • Password (Mandatory) - Jenkins user password.
    
    
• Bamboo:
  • Plan key (Mandatory) - Exact job name defined on your Jenkins instance;
  • API URL (Mandatory) - Bamboo endpoint URL. e.g., bamboo.cloud.getxray.app
  • Username (Mandatory) - Bamboo username;
  • Password (Mandatory) - Bamboo user password;
  • Project Key (Mandatory) - Exact Bamboo project key.
    
    
    
    
• GitHub:
  • Repository Name (Mandatory) - Exact repository name;
  • Workflow Id (Mandatory) - The desired workflow Id ID you want to use from your repository;
  • Username (Mandatory) - GitHub owner;
  • API URL (Mandatory) - GitHub endpoint URL. e.g., api.github.com
  • Branch Name (Mandatory) - Repository branch name you want to trigger the build;
  • Authentication Token (Mandatory) - GitHub Authentication token.
    
    
    
    
• GitLab:
  
  • Branch Name (Mandatory) - Exact GitLab branch name;
  • API Token (Mandatory) - GitLab API token Pipeline Trigger Token (GitLab);
  • Username (Mandatory) - GitLab username;
  • API URL (Mandatory) - GitLab endpoint URL. e.g., gitlab.com
  • Project Id ID (Mandatory)  - GitLab project Id ID you want to trigger the build;
  • Authentication Token (Mandatory) - GitLab Authentication token Personal Access Token (GitLab).
    
    
• Azure DevOps:
  
  • Repository Name (Mandatory) - Exact repository name;
  • Username (Mandatory) - Organization name;
  • API URL (Mandatory) - Azure DevOps endpoint URL. e.g., dev.azure.com
  • Branch Name (Mandatory) - Exact Azure DevOps branch name;
  • Pipeline Id ID (Mandatory) - Exact Azure DevOps branch name;
  • Authentication Token (Mandatory) - Azure DevOps Authentication token.
    
    

Click "Save" to store your new configuration.