start portlet menu bar end portlet menu bar
  • Overview
  • Documentation
  • Version history

What’s New?

Note: HCL DevOps Velocity (Velocity) is the new name of HCL Accelerate from version 5.0.0 onwards.
We have introduced a new plug-in for Jenkins which works as any other plug-in of Accelerate product. Earlier we had Jenkins features embedded into Accelerate core product itself (now we are calling it Jenkins Legacy).

 

Description

Jenkins plug-in in HCL Accelerate will pull jobs from Jenkins and provide as an Input to the release pipelines or as an automation task in deployment plan. This helps deployment teams to orchestrate the deployment of the input builds into controlled environments with defined checks and balances. This is a scheduled plug-in that runs every 5 minutes to check any new builds in Jenkins and pull them into HCL Accelerate.

Quick Info

Product icon

Product

DevOps Velocity (HCL Accelerate)
Plugin type icon

Type

plugin
Compatibility icon

Compatibility

HCL Accelerate (DevOps Velocity) version 4.0.9
created by icon

Created by

HCL Software
Website icon

Website

Jenkins

Published Date

Last Updated

Summary

 

Note: HCL DevOps Velocity (Velocity) is the new name of HCL Accelerate from version 5.0.0 onwards.

Jenkins plug-in is a powerful tool for managing software delivery pipelines in HCL Accelerate (Velocity). Deployment teams can orchestrate the deployment of input builds into controlled environments with defined checks and balances using Jenkins plug-in.

Jenkins plug-in is a scheduled plug-in that runs every 5 minutes to import any new builds in Jenkins and pull them into HCL Accelerate (Velocity). This ensures that you have access to the latest builds and work more efficiently.

The Jenkins plug-in has the following features:

Importing Jobs and Builds: You can use Jenkins plug-in to import jobs and builds from a Jenkins server, which can be provided as an input for the release pipelines in HCL Accelerate. Therefore, you can manage the software delivery process more efficiently.

Running automation tasks: You can use Jenkins plug-in to run Jenkins jobs as an automation task in HCL Accelerate (Velocity). Running the Jenkins job as an automation task, you can further streamline the software delivery process by automating routine tasks, reducing errors, and minimizing the time required to release the software.

Integration with deployment pipelines: Deployment pipelines in HCL Accelerate (Velocity) is a powerful way to create automated pipelines for deploying software applications. You can use Jenkins plug-in to add Jenkins jobs as a task within the deployment pipelines and automate the deployment process.

History

The following table describes the changes made in each plug-in version.

Version Description
1.0.4 · Fixed integration name not showing in pipeline stage task selection.

 

· Fixed external build link not appearing in deployment plan task.
1.0.1 Initial release.

Integration steps

 

The tables in the Configuration properties describe the properties to define the integration.

To install the plug-in, perform the following steps:

  1. From the home page, click Settings > Integrations > Available.
  2. In the Action column for the Jenkins plug-in, click Install.

To integrate the plug-in, perform the following steps:

  1. From the home page, click Settings > Integrations > Installed.
  2. In the Action column for the Jenkins plug-in, click Add Integration.
  3. On the Add Integration page, enter values for the fields used to configure the integration and define communication.
  4. Click Save.
Jenkins plug-in configuration screenhttps://plugins.hcltechsw.com/wp-content/uploads/2023/04/jenkins_Int-209x300.jpg 209w" sizes="(max-width: 502px) 100vw, 502px" />
Jenkins plug-in configuration screen

Usage

 

The Jenkins plug-in provides features that can be used for the following purposes:

  • Using Jenkins jobs as input for the release pipelines.
  • Using Jenkins jobs as automation tasks in deployment plans.

To use Jenkins jobs as input for the release pipelines, perform the following steps:

  1. Log in to HCL Accelerate (Velocity).
  2. Click Value streams on the Navigation bar.
  3. Click All Value Streams tab and select the required value stream.
  4. On the Value Streams page, click Pipeline tab and then click Add app to add an application.
    The Add app – Choose the app dialog box opens.
  5. In the Managed by drop-down list, select Jenkins.
  6. In the Application name field, enter the application name.
  7. In the Description field, enter the description for the application.
  8. Click Save to add the application.
  9. On the Jenkins application, in the Input column, click the + button to create a version.
    The Create version dialog opens.
  10. Select the Jenkins job and then click Save to create a version.

Select Job that creates input versionhttps://plugins.hcltechsw.com/wp-content/uploads/2023/04/jenkin3-300x222.jpg 300w, https://plugins.hcltechsw.com/wp-content/uploads/2023/04/jenkin3-768x568.jpg 768w" sizes="(max-width: 627px) 100vw, 627px" />

 

To use Jenkins jobs as automation tasks in deployment plans, perform the following steps:

  1. Log in to HCL Accelerate (Velocity).
  2. Click Releases on the Navigation bar.
  3. Click the required release.
  4. On the Releases page, click the required deployment plan to open the deployment plan page.
  5. On the deployment plan page, click Create Task.
    The Create task dialog box opens.
  6. In the Type drop-down list, select Jenkins.
  7. In the Name field, enter a task name.
  8. In the Description field, enter the description of the task.
  9. In the Integration drop-down list, select required integration for the task.
  10. In the Process drop-down list, select required process for the task.
  11. Select the Wait checkbox to wait for job to finish in Jenkins.
  12. Perform any of the following step:
    • Click Save to save the task and close the dialog.
    • Click Save and create another to save the task and create another task.

https://plugins.hcltechsw.com/wp-content/uploads/2023/04/jenkin7-300x275.jpg 300w, https://plugins.hcltechsw.com/wp-content/uploads/2023/04/jenkin7-768x705.jpg 768w" sizes="(max-width: 639px) 100vw, 639px" />

 

 

Configuration properties

 

The following tables describe the properties used to configure the integration.

  • The General Configuration Properties table describes configuration properties used by all plugin integrations.
  • The Jenkins Configuration Properties table describes the configuration properties that define the connection and communications with the Jenkins server.

Some properties might not be displayed in the user interface, to see all properties enable the Show Hidden Properties field.

General Configuration properties
Name Description Required Property Name
NA The version of the plugin that you want to use. To view available versions, click the Version History tab. If a value is not specified, the latest version is used. No image
Integration Name An assigned name to the value stream. Yes name
Logging Level The level of Log4j messages to display in the log file. Valid values are: all, debug, info, warn, error, fatal, off, and trace. No loggingLevel
NA List of configuration properties used to connect and communicate with the Jenkins server. Enclose the properties within braces. Yes properties
  The name of the tenant. Yes tenant_id
NA Unique identifier assigned to the plugin. The value for the GitLab plugin is ucv-ext-jenkins. Yes type
HCL Accelerate User Access Key An auto-generated user access key provides credentials for communicating with the HCL Accelerate server. Yes NA

 

 

 

 

 

 

 

 

 

 

 

 

Jenkins Properties
Name Type Description Required
Jenkins Server URL String Base URL of the Jenkins server. Yes
Username String Username to authenticate with the Jenkins server Yes
API Token Secure API Token to authenticate with the Jenkins server.</br>To create one navigate to Jenkins -> User (top right) -> Configure -> Api Token) Yes
Job Filter (xPath) String Restrict which jobs get synced with an xPath filter string. For example: ‘starts-with(fullName,”folder/path/”)’ to only get jobs in a specific folder or: ‘contains(name,”Team Name”)’ to only get jobs that contain a specific substring or: ‘(starts-with(fullName,”folder/path/”) or contains(name,”Team Name”)) and ends-with(name,”my-suffix”)’ etc… No
Request Timeout String Timeout (in seconds) to apply to each request to the Jenkins server. No
Request Retries String Number of times to attempt each request to the Jenkins server (to help eliminate on-off request errors failing entire sync). No
Parallel Requests’ Boolean Whether or not to make requests to the Jenkins server in parallel (parallelized requests make syncing faster but put more pressure on Jenkins server). No
Request Depth String The depth of folder levels that Jenkins API requests should make. Increased depth puts more load on each request but requires less requests for deeply nested folder structures. No
Queue Polling Timeout String Length of time (in minutes) to poll for build to be kicked off from queue. No
Queue Polling Interval String Time (in seconds) to wait between requests to get build after it is kicked off from queue. No

 

https://plugins.hcltechsw.com/wp-content/uploads/2023/04/jenkins_Int-209x300.jpg 209w" sizes="(max-width: 502px) 100vw, 502px" />

ucv-ext-jenkins:1.1.7.tar

Uploaded: 10-Jun-2024 10:37

Pull Command

docker pull hclcr.io/accelerate/ucv-ext-jenkins:1.1.7
 

Release Notes

  • Bug Fix: The Jenkins task in deployment remains incomplete when the Velocity instance goes down during deployment. When the instance comes back online with the new version, the task still does not get marked as complete.
Download Icon DOWNLOAD

ucv-ext-jenkins:1.1.6.tar

Uploaded: 10-Jun-2024 09:50

Download Icon DOWNLOAD

ucv-ext-jenkins:1.1.5.tar

Uploaded: 19-Feb-2024 19:25

Download Icon DOWNLOAD

ucv-ext-jenkins:1.1.3.tar

Uploaded: 15-Nov-2023 05:24

Pull Command

docker pull hclcr.io/accelerate/ucv-ext-jenkins:1.1.3
 

Release Notes

  • Fix for Build-Revision mismatch in Jenkins Integration
Download Icon DOWNLOAD

ucv-ext-jenkins:1.1.2.tar

Uploaded: 12-Oct-2023 04:37

Pull Command

docker pull hclcr.io/accelerate/ucv-ext-jenkins:1.1.2
 

Release Notes

  • Added support for process parameters coming from Git Parameter and Active Choices plugins
  • Warning logs added for skipping unsupported process parameters
Download Icon DOWNLOAD

ucv-ext-jenkins:1.1.1.tar

Uploaded: 18-Aug-2023 14:55

Pull Command

docker pull hclcr.io/accelerate/ucv-ext-jenkins:1.1.1
 

Release Notes

  • Default initial sync to 30 days
Download Icon DOWNLOAD

ucv-ext-jenkins:1.0.9.tar

Uploaded: 09-Jun-2023 15:51

Download Icon DOWNLOAD

ucv-ext-jenkins:1.0.4.tar

ucv-ext-jenkins:1.0.4.tar

Uploaded: 05-Apr-2023 18:19

Pull Command

docker pull hclcr.io/accelerate/ucv-ext-jenkins:1.0.4
 

Release Notes

  • Fixed integration name not showing in pipeline stage task selection
  • Fixed external build link not appearing in deployment plan task
Download Icon DOWNLOAD

ucv-ext-jenkins:1.0.1.tar

Uploaded: 31-Mar-2023 17:20

Pull Command

docker pull hclcr.io/accelerate/ucv-ext-jenkins:1.0.1
 

Release Notes

  • Initial Release
Download Icon DOWNLOAD

Related Plugins