DOCUMENTATION
Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Apr 06, 2021 15:24

You can use Perfecto Connect as part of the CI process by integrating it with a Jenkins CI job on Windows or Linux.


To integrate with Jenkins on Windows

To integrate Perfecto Connect with Jenkins on Windows:

  1. Create a new Jenkins Job.
  2. Add the Git repository URL. We use this repository.
  3. Download and extract the Perfecto Connect client. The perfecto connect binary should reside in a fixed folder, such as C:\Perfecto\, only the Windows Jenkins instance.
    Download URL: http://downloads.connect.perfectomobile.com/clients/Perfecto-Connect-windows.zip
    Make sure you extract perfectoconnect.exe from the archive.

  4. Activate the Perfecto Connect client.
    Start the client providing the URL of the Perfecto Lab and your personal security token, assigning the output to a local variable. Save the client's output to a properties file as TUNNEL_ID=<value>.
    To start the client, we execute:

    C:\Perfecto\perfectoconnect.exe start -c <cloudURL> -s <security-token>

    For more information about how to use the client, see Download the Perfecto Connect client.

  5. Inject the environment variable from the properties file.
    This injects the value of the TUNNEL_ID from the properties file to the build job.

  6. Run tests. In this sample, we use Gradle to run tests. We pass the Perfecto Lab URL, the security token, and the TUNNEL_ID that we got from the client.

  7. Stop the Perfecto Connect client as a post-build action.
To integrate with Jenkins on Linux

To integrate Perfecto Connect with Jenkins on Linux:

  1. Create a new Jenkins Job.
  2. Add the Git repository URL. We use this repository.

  3. Download and extract the Perfecto Connect client and extract the binary.
    For more information about how to download the client, see Download the Perfecto Connect client.

  4. Activate the Perfecto Connect client.
    Start the client providing the URL of the Perfecto Lab and your personal security token, assigning the output to a local variable. Save the client's output to a properties file as TUNNEL_ID=<value>.
    To start the client, we execute: 

    ./perfectoconnect start -c <cloudURL> -s <security-token>

    For more information about how to use the client, see Download the Perfecto Connect client.

  5. Inject the environment variable from the properties file. This will inject the value of the TUNNEL_ID from the properties file to the build job.

  6. Run tests. In this sample, we use Gradle to run tests. We pass the Perfecto Lab URL, the security token, and the TUNNEL_ID that we got from the client. 

  7. Stop the Perfecto Connect client as a post-build action.