Jenkins plugin

Perform the following steps to enable the plugin in Jenkins.

To enable the plugin:

1. On the Jenkins homepage, in the left pane, click New Item.

2. In theEnter an item namefield, specify the name for your new item.
3. Select any project type except pipeline.
4. Click OK.

5. Under Build Environment, do the following:

   1. Select the Perfecto Connect checkbox. You may need to get help from your Jenkins Administrator to create the Perfecto credentials
   2. Next to the Credentials list, click Add and then select Jenkins.

   3. In the Add Credentials dialog box, do the following: 

      1. From the Kind list, select Perfecto.
      2. Provide your cloud name, username, and Perfecto security token.
      3. Click Add.
   4. From the Credentials list, select the credentials you added.
   5. In the Perfecto Connect Path field, provide the path to Perfecto Connect, such as /Users/Mymac/Downloads on Mac.
   6. In the Perfecto Connect File Name field, provide the file name of the Perfecto Connect executable, such as perfectoconnect on Mac or perfectoconnect64.exe or perfectoconnect32.exe on Windows.

   7. (Optional) Click Advanced to set advanced Perfecto Connect configuration options, as follows:

      • In the Additional Parameters field, provide additional Perfecto Connect parameters, such as bridgeproxyip and bridgeproxyport. For example:

        Copy

        - --bridgeproxyip=127.0.0.1 --bridgeproxyport=8888

        For more information, see Work with Perfecto Connect.

      • To override the name of the Tunnel ID environment variable, in the Override Tunnel ID Name field, provide a different name.
      • To reuse a Tunnel ID already created earlier, in the Existing Tunnel ID field, provide the existing ID.

This section illustrates how to connect to Perfecto Connect with Maven and Gradle.

Connect with Maven

To connect to Perfecto Connect with Maven, specify the following information for the build:

• Root POM: pom.xml

• Goals and options: clean install -DtunnelId=${tunnelId]

Connect with Gradle

To connect to Perfecto Connect with Gradle, specify the following information for the build:

• Select Invoke Gradle.

• Specify the Gradle Version as GRADLE_HOME.

1. Under Post-build Actions, add a post-build task.

2. In the Script field, enter the following script:

   Copy

   /<path to Perfecto Connect>/<name of Perfecto Connect executable> stop

   For example:

   Copy

   Mac

   /Users/mymac/Downloads/perfectoconnect stop

   Copy

   Windows

   C:\Users\Administrator\Downloads\perfectoconnect64.exe stop

You may want to use the following independent and alternate practices in combination with the Jenkins plugin, in particular how to create a Jenkins pipeline with Perfecto Connect and how to upload a file to the Perfecto media repository.

Create a Perfecto Connect pipeline

1. Create a new pipeline and add the below code to the Pipeline Script field:

   Copy

   import javax.swing.GroupLayout.ParallelGroup
   import groovy.json.JsonSlurperClassic
   import groovy.json.JsonSlurper
    
   node {
   String cloudName = "<<CLOUD NAME e.g. demo>>";
   String securityToken = "<<SECURITY TOKEN>>";
   String perfectoConnectPath = "/Users/myMac/Downloads/perfectoconnect";
       environment {
           tunnelId = ""    }
       stage('perfectoconnect start'){
           if(cloudName.contains("<<")){
                error "Kindly update cloudName, securityToken and perfectoConnectPath"        }
           String script = perfectoConnectPath + " start  -c " + cloudName + ".perfectomobile.com  -s " + securityToken;
           echo script;
           tunnelId = sh (script: script , returnStdout: true).trim()
           env.tunnelId = "${tunnelId}"    }
       stage('script'){
           echo "Tunnel id: ${tunnelId}"    }
       stage('perfectoconnect stop'){
           sh label: '', returnStdout: true, script: perfectoConnectPath + " stop"    }
   }

2. In the script, update the cloudName, securityToken, and perfectoConnectPath as applicable.

Upload the app to Perfecto

To upload the app to the Perfecto media repository, see Upload Item to Repository.