Myst Studio Plugin for Jenkins
As part of the build process, we require Jenkins to publish details of each artifact build to Myst Studio. To enable this, we need to install and configure the Myst Studio plugin for Jenkins.
Install Myst Plugin
The first step is to install the Myst Studio plugin for Jenkins. To do this, go to the Myst Documentation site and download the Myst Studio Plugin for Jenkins (hpi). Ensure that the version of the plugin selected is the same as the version of Myst Studio being used.
Once downloaded, log into Jenkins and select Manage Jenkins
.
Next, select Manage Plugins
and select the Advanced
tab. Scroll down to the Upload Plugin
section. Click on Choose File
and browse to and select the plugin that we downloaded in the previous step.
Jenkins will upload and install the plugin. We will need to restart our Jenkins instance once the plugin has been uploaded.
After restarting Jenkins, to validate that the plugin has been successfully installed, go to the Manage Plugins
page and select the Installed
tab.
Enter myst
in the Filter
criteria and we should be able to see the installed Myst plugin as shown below.
Retrieve the API key from Myst Studio
The next step is to retrieve the API Key for connecting to Myst Studio. Login to Myst Studio and from the side menu navigate to Administration
> Users
, this will display the list of Myst Users. Locate the mystsystemuser
- we can filter on User Name
to make this simpler.
Click on the down arrow next to the Edit
button of the Myst System User (API User) and select Show API Key
. This will display the user details including the API Key
.
Take a copy of the API Key. We will use this in the next step to configure Jenkins.
A new key may also be generated by clicking
Generate New Key
.
Configure Myst Plugin
Within Jenkins, click on Manage Jenkins
on the left-hand side of the screen then select Configure System
.
Scroll down to the Myst Studio Configuration section and enter the following information:
Studio Endpoint - This is the URL for Myst Studio and takes the format
http://<myst-server-url>:<server-port>
. The default server port is 8085.API Token - This token is used to authorize communication between Jenkins and Myst Studio and is the API Key that we obtained from Myst Studio in the previous section.
Next, click Connect
. The Myst Studio plugin will attempt to connect with Myst Studio. If the connection is successful, the message Connected successfully
will be displayed.
Once done, click Save
to save your configurations within Jenkins.