start portlet menu bar

HCLSoftware: Fueling the Digital+ Economy

Display portlet menu
end portlet menu bar
Close
Select Page

HCL Accelerate value streams can include build and deployment data from Jenkins. Beyond this, Jenkins integrations can be used with HCL Accelerate pipelines to run builds and deployments directly from HCL Accelerate and further organized as deployment plans and releases. This is a short tutorial on how to create a new Jenkins integration.

The Jenkins Plugin

The HCL Accelerate Jenkins integration is different than most other plugins in that it requires a two-part setup – First create the integration in HCL Accelerate, then install and configure the plugin on the Jenkins Server. Also, rather than being added to a value stream via a vsm.json file as is done for most other plugins, the Jenkins integration gets added to a value stream via the value stream’s pipeline.

  1. Create the HCL Accelerate integration
  2. Install and configure the plugin in Jenkins.
  3. Use the integration in value stream pipelines.

Requirements

  • If you do not have a Jenkins server available, See Jenkins documentation for running a local instance https://jenkins.io/doc/book/installing/.
  • This example uses the pipeline plugin for Jenkins. This plugin is installed by default with newer versions of Jenkins. You can verify that this plugin is installed in Jenkins from the “Installed” tab under “Plugin Manager” (<Jenkins URL>/pluginManager/installed). If you do not have it installed, it’s a good idea to add it now: https://plugins.jenkins.io/workflow-aggregator.

1. Create the HCL Accelerate Integration

1.1 Navigate to the Settings Page of HCL Accelerate and select the Integrations section in the left navigation, then click on “Plugins”. Create a new Jenkins integration by clicking “Add Integration”.

connecting jenkins with hcl accelerate

1.2 Provide a name for your Jenkins integration (should describe the Jenkins instance). You can name this integration whatever you want. Click “Create”. This will generate an Integration ID and Integration Token Click “Copy to Clipboard” to copy these fields and save them. These values will be needed to configure the “HCL Accelerate” plugin installed on Jenkins.

connecting jenkins with hcl accelerate

2. Install and Configure the Plugin on Jenkins

2.1 Create an HCL Accelerate User Access Key

We are going to need a user access key from HCL Accelerate, so we’ll start by creating one now. To create an HCL Accelerate user access key, navigate to “Settings”>”My Profile” and click “Create”. It’s a good idea to name your key according to the integration that will use it.

connecting jenkins with hcl accelerate

2.2 Install the plugin on the Jenkins Server

Install the “HCL Accelerate” plugin on your Jenkins instance. Navigate to the plugins page on your Jenkins instance by clicking Manage Jenkins > Manage Plugins > Available (tab) and search for “HCL Accelerate”. When located install the plugin and restart your instance when possible.

2.3 Configure the Plugin from Jenkins

Navigate to the Jenkins configuration page Manage Jenkins > Configure System > HCL Accelerate(section). Fill in the required fields under the “HCL Accelerate” section…

  1. Integration ID and Integration Token values generated by the integration we created in HCL Accelerate.
  2. Provide the “Accelerate Base URL”. Note that if you are running Jenkins from a container, localhost will be accessible as “host.docker.internal”.
  3. Also provide credentials for a Jenkins user on whose behalf this plugin may access Jenkins.
  4. Depending on your version, you might need to provide an HCL Accelerate user access token. Use the access token we created earlier.
  5. Click Apply and save before clicking the Test Connection button to confirm your connection to HCL Accelerate. Upon successful connection, your data will be posted to HCL Accelerate.

connecting jenkins with hcl accelerate

3. How to Add a Jenkins Integration to a Value Stream

Jenkins integrations are added to value streams in a different way than other integrations. There is no need to edit a vsm.json file. Instead, we will need to create an “Application” on the value stream’s pipeline in order to have a target for build and deployment data.

  1. Navigate to “Pipeline” and click “Add app”.
  2. Select “Jenkins” from the dropdown. connecting jenkins with hcl accelerate
  3. Type an application name. The workbook uses the name “JKE App1”. connecting jenkins with hcl accelerate
  4. The new application should appear as a row within the pipeline. This Jenkins integration is now available to our value stream. connecting jenkins with hcl accelerate
  5. The new application should appear as a row within the pipeline. This Jenkins integration is now available to our value stream. connecting jenkins with hcl accelerate
  6.  
Comment wrap

Start a Conversation with Us

We’re here to help you find the right solutions and support you in achieving your business goals.

Secure DevOps | September 30, 2024
Announcing the End of Support for HCL DevOps Velocity (formerly HCL Accelerate) 5.0.8 and Earlier Versions
Announcing End of Support for HCL DevOps Velocity 5.0.8 and earlier on June 30, 2025. Upgrade now to the latest version for continued support and access to the newest features!
Secure DevOps | August 6, 2024
Announcing Our Latest Product Release: Enhancing Efficiency and Predictive Power with GenAI and More
HCL Velocity 2024.06 (5.0.6) is here with GenAI summaries, Risk Estimator 2.0, improved observability, value stream management enhancements, and simplified architecture. Learn more now!
Secure DevOps | March 13, 2024
2023 Value Stream Management Trends: A Recap
New survey reveals challenges and trends in Value Stream Management. Learn how to improve collaboration, gain insights, and drive efficiency.