Cloud customer?
Start for Free >
Upgrade in MyJFrog >
What's New in Cloud >

Search





Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: First version Jenkins Server Integration

The Jenkins Integration is used to connect the JFrog Pipelines platform to Jenkins. This will enable a Jenkins build job to trigger execution of a pipeline in Pipelines through the Jenkins Artifactory Plugin.

Creating an Integration

You can add this integration by following steps on the Managing Pipelines Integrations page.

Here is the information you need to create this integration:

  • Name -- choose a friendly name for the integration
  • url -- enter the HTTP endpoint (URL) of your Jenkins  username Jenkins server
  • Jenkins user – The Jenkins account user name
  • api Jenkins API token – The Jenkins user's API token for authentication
  • callback user -- JFrog Platform username to use for basic authentication in the callback URL to Pipelines
  • callback password -- JFrog Platform user password

In addition, you must generate the required Token to configure Jenkins Plugin to complete the integration.

Panel
titlePage Contents

Table of Contents
maxLevel3
minLevel2

Usage

The Jenkins Server integration can be used in the BuildInfo resource.

A Jenkins integration can be added directly to a step in the integrations section to access its environment variables. 

Once the integration has been created, it provides the format of the callback URL and curl command lines that your Jenkins job must invoke to trigger execution of a pipeline in Pipelines.

Image Removed

with the Jenkins native step. Operation requires that the Jenkins Artifactory Plugin be installed in your Jenkins server.

For Jenkins to successfully interoperate with Pipelines, a bearer token generated by Pipelines must be provided to the required plugin for authentication of your JPD user account.

Configuration

To complete the Jenkins Server integration and connect it to the Jenkins Artifactory Plugin:

  1. In the Jenkins Server Integration UI, enter the required configuration information.
  2. Next to the field Token to configure Jenkins Plugin click Generate.
    Image Added
  3. Once the token is generated, click Copy to Clipboard
    Image Added
  4. In the Jenkins Artifactory Plugin configuration, in the JFrog Pipelines server section, Add the token to the Credentials., pasting the value from your clipboard.

  5. Return to Pipelines, and open the Jenkins Server Integration again for editing. You should now see a Callback URL presented. Click Copy webhook url to clipboard.
    Image Added
  6. In the Jenkins Artifactory Plugin configuration, past this URL into the Integration URL field.
    Image Added


Default Environment Variables

When you add this integration directly to a step, a set of environment variables is automatically made available.

Callback Password

Environment variable

Description

int_<integration-name>_urlHTTP endpoint of Jenkins
int_<integration-name>_hookUsernameusernameCallback UsernameJenkins username
int_<integration-name>_hookPasswordapitokenJenkins API token





Copyright © 2021 JFrog Ltd.