Jenkins integration

The Application Automation Tools plugin for the Jenkins continuous integration server provides a mechanism for uploading apps to the Digital Lab console.

First you define the Digital Lab server within Jenkins, and then you add build steps to upload your mobile apps with .apk (Android) or .ipa (iOS) file extensions.

 

Prerequisites

1. Install one of the five latest LTS versions of Jenkins.

2. Install the Jenkins plugin.

Back to top

Define the Digital Lab server

Before using Jenkins with Digital Lab, you need to configure Jenkins to recognize the Digital Lab server.

On the Jenkins Server home page, click Manage Jenkins > Configure System.

  1. Go to the Digital Lab section, and click Add Digital Lab server.
  2. Enter a name for the Digital Lab server that you are using, and its URL.
  3. Repeat the last two steps for each of the Digital Lab servers that you are accessing.

  4. For running functional tests where UFT One and Jenkins are hosted on separate machines, you need to create an execution node for the functional test:

    1. Select Manage Jenkins > Manage Nodes > New Node.
    2. Give the node a name, and select the Permanent Agent option.
    3. Enter the details for the UFT One machine.
    4. Save your changes.

Back to top

Use Digital Lab with SSL

This section is relevant for UFT Digital Lab only.

If the server certificate is not signed by a recognized certificate authority and you want to use Digital Lab securely with SSL, you must first install the Digital Lab server certificate.

1. Copy the Digital Lab server certificate to the Jenkins server machine.

2. Import the Digital Lab server certificate on the Jenkins server machine using the following command:

Copy code 
 keytool.exe -import -file "<local_path>\<certificate_filename>.cer" 
  -keystore "C:\Program Files (x86)\Jenkins\jre\lib\security\cacerts" 
  -alias mc  -storepass changeit -noprompt 

3. Restart the Jenkins service.

Back to top

Upload apps to Digital Lab

The Application Automation Tools Jenkins plugin provides a standalone builder for uploading apps to Digital Lab. If you want to create a job that runs a UFT One functional test with Mobile devices, see the UFT Help Center.

  1. Make sure you have added your Digital Lab server to the Jenkins configuration as described in Define the Digital Lab server.
  2. Copy your application package file, with .apk or .ipa extensions, to the Jenkins machine.
  3. On the Jenkins Server home page, click New Item.
  4. Enter an item name for the project.
  5. Select Free style project and click OK in the bottom left corner.
  6. In the General tab, scroll down to the Build section.
  7. Expand the Add build step drop-down and select Upload app to Digital Lab.
  8. Select your Digital Lab server from the drop-down list of servers.
  9. Provide your login credentials (user name and password) or execution key. If your server has the multiple share spaces enabled, include the nine-digit project ID in the Tenant ID field. If the feature is not enabled, leave this field empty.
  10. If you are connecting to a Digital Lab server through a proxy, select Use proxy settings and provide the relevant information.
  11. Click Add Application.

    • Type the full path of the .apk or .ipa package file of the app to upload to the Digital Lab server.

    • Select the Digital Lab workspace to which to upload the application.

    Repeat these steps for each app you want to upload.

  12. Click Apply to save your changes and continue with more build steps.
  13. Click Save when you are finished adding build steps.
  14. Run or trigger the job as you would with any standard Jenkins job.
  15. To troubleshoot, check the log file on the Digital Lab server for issues such as connectivity and security.

Back to top

See also: