This
What is the Jenkins SyncPack?
The "Jenkins" SyncPack includes a configuration object, applications, and steps that bidirectionally sync jobs, pipeline jobs, and node status between Jenkins and SL1.
Prerequisites for this SyncPack
This SyncPack requires the following:
- A subscription that includes CMDB/Inventory Workflow Automations
- "Base Steps" SyncPack version 1.3.2 or later
- Administrator access to Jenkins
The following table lists the port access required by PowerFlow and this SyncPack:
| Source IP | PowerFlow Destination | PowerFlow Source Port | Destination Port | Requirement |
| PowerFlow | SL1 API | Any | TCP 443 | SL1 API Access |
| PowerFlow | Jenkins API | Any | TCP 443 | Jenkins API Access |
| PowerFlow | SL1 Database | Any | TCP 7706 | SL1 Database Access |
Contents of the SyncPack
This section lists the contents of the Jenkins SyncPack.
PowerFlow Applications
- Create External Notes For SL1 Event. This application queries Jenkins for job information to be added to the associated SL1 event.
- Create Event In SL1 For Jenkins Job Run. This application creates an SL1 event when a Jenkins job fails.
- Create Event In SL1 For Jenkins Node Status. This application creates an SL1 event when a node is offline in Jenkins.
- Create Event In SL1 For Jenkins Pipeline Job Run. This application creates an SL1 event when a Jenkins pipeline job fails.
- Update SL1 Event Triggered. This application updates an SL1 event with Jenkins job information.
- Trigger Event In SL1. This application creates an SL1 event when an SL1 event reaches a major severity threshold.
- Create Virtual Device In SL1 For Jenkins Jobs And Nodes. This application creates a virtual device in SL1 that is used to identify Jenkins jobs and nodes.
For more information about how to configure these applications, see Configuring Applications for the Jenkins SyncPack.
Configuration Object
- Base Jenkins Configuration. This configuration object can be used as a template after the SyncPack is installed on the PowerFlow system. The configuration object includes the following:
- Details for connecting to SL1, including the host, username, and password.
- Details for connecting to Jenkins, including the URL, username, and password.
- Details for notifications including the sender and receiving email, password, server, and port.
- Details for connecting to Jenkins devices including device ID, collector group ID, and device class ID.
Steps
The following steps are included in this SyncPack:
- Build Jenkins Job
- Build Jenkins Job From SL1 Event
- Build Jenkins Pipeline Job
- Create Jenkins Virtual Devices On SL1
- Create SL1 Alert
- Create Virtual Device
- Get Event Details From SL1
- Get Jenkins Nodes Status
- Get List Of Existing Virtual Devices Of Nodes
- Get Virtual Device
- Post Update To SL1
- Read Cache
- Update Jenkins Details To SL1
- Update SL1 Event of Jenkins Build Job
Installing the SyncPack
A SyncPack file has the .whl file extension type. You can download the SyncPack file from the ScienceLogic Support site.
Downloading the SyncPack
To locate and download the SyncPack:
- Go to the ScienceLogic Support Site.
- Click the tab and select PowerPack.
- In the Search PowerPacks field, search for the SyncPack and select it from the search results. The Release Version page appears.
- On the tab, click the name of the SyncPack version that you want to install. The Release File Details page appears.
- Click the button or click the name of the .zip file containing the .whl file for this SyncPack to start downloading the file.
After you download a SyncPack, you can import it to your PowerFlow system using the PowerFlow user interface.
Importing the SyncPack
To import a SyncPack in the PowerFlow user interface:
- On the SyncPacks page (
) of the PowerFlow user interface, click . The Import SyncPack page appears. - Click and select the .whl file for the SyncPack you want to install. You can also drag and drop a .whl file to the Import SyncPack page.
- Click . PowerFlow registers and uploads the SyncPack. The SyncPack is added to the SyncPacks page.
- You will need to activate and install the SyncPack in PowerFlow. For more information, see the following topic.
You cannot edit the content package in a SyncPack published by ScienceLogic. You must make a copy of a ScienceLogic SyncPack and save your changes to the new SyncPack to prevent overwriting any information in the original SyncPack when upgrading.
Installing the SyncPack
To activate and install a SyncPack in the PowerFlow user interface:
-
On the SyncPacks page of the PowerFlow user interface, click the button (
) for the SyncPack you want to install and select Activate & Install. The Activate & Install SyncPack modal appears.If you try to activate and install a SyncPack that is already activated and installed, you can choose to "force" installation across all the nodes in the PowerFlow system.
If you do not see the PowerPack that you want to install, click the Filter icon (
) on the SyncPacks page and select Toggle Inactive SyncPacks to see a list of the imported PowerPacks.
- Click to confirm the activation and installation. When the SyncPack is activated, the SyncPacks page displays a green check mark icon (
) for that SyncPack. If the activation or installation failed, then a red exclamation mark icon (
) appears. - For more information about the activation and installation process, click the check mark icon () or the exclamation mark icon () in the Activated column for that SyncPack. For a successful installation, the "Activate & Install SyncPack" application appears, and you can view the Step Log for the steps. For a failed installation, the Error Logs window appears.
- If you have other versions of the same SyncPack on your PowerFlow system, you can click the button () for that SyncPack and select Change active version to activate a different version other than the version that is currently running.