Installing Jenkins

For more information about our Jenkins Plugin, please visit https://wiki.jenkins-ci.org/display/JENKINS/CrossBrowserTesting+Plugin

Features

1. Running Selenium Scripts in Python, Ruby, Java, CSharp, and Javascript on CrossBrowserTesting.com
2. Running Selenium Scripts using Shell or Batch Scripts on CrossBrowserTesting.com
3. Running Automated Screenshot Testing on CrossBrowserTesting.com
4. Automated Starting and Stopping of the CrossBrowserTesting.com NodeJS local tunnel to test local and development webpages behind your firewall
5. Enable Test Views with links to download Screenshots for Screenshot Tests, and view videos and packet captures for Selenium scripts
6. Use different API Credentials for each build

Installation

via the interface

1. Go to your installation’s management screen.
2. Click Manage Plugins.
3. Click the Available tab.
4. Find the CrossBrowserTesting.com Plugin and select the checkbox.
5. then click either Install without restart or Download now and install after restart.

by hand(not recommended)

1. Download CrossBrowserTesting.hpi.
2. Save the downloaded .hpi file into your `$JENKINS_HOME/plugins` directory.
3. Restart Jenkins.

Configuration

Environment Variables

The CrossBrowserTesting.com Jenkins Plugin passes your build step information to your Selenium scripts as environment variables. The exact syntax will vary depending on your scripting language.

See the examples directory for a few language specific sample scripts.

Saving Your CrossBrowserTesting.com API Credentials

1. Go to your installation’s management screen.
2. Click Configure System.
3. Find the section labeled CrossBrowserTesting.com.
4. Enter your CrossBrowserTesting.com Username and API Key information. You can find your api key here (must be logged in)
5. Click Save.
6. Optional (Version >= 1.3.0): You can use different API Credentials for each build by selecting the Advanced section within the build configuration page.

Build/Configure

Enable Selenium and Screenshot Views

1. In the CrossBrowserTesting.com Build Environment, Select “Enable Test Results Pages”
2. During your build, links on your sidebar will populate and allow you to interact with the test.
3. You can view and download screenshots for a Screenshots Test
4. You can view videos, snapshots, and network packet captures for Selenium Tests

Version >= 0.11 Build Environment

1. Configure your Jenkins Project.
2. In Build Environment, Check the box next to CrossBrowserTesting.com
3. For Screenshot Tests: Pick a BrowserList and enter a URL (you must have you API credentials saved for the browserlist to populate)
4. For Selenium Tests: Add the Operating System, Browser, and Screen Resolution that you want to run a Selenium Test on. You can add multiple configurations by clicking Add Selenium Tests
5. Click Save
6. Click Build Now to build the project. All files in the project’s workspace will be ran (make sure the selenium scripts are executable). Output from the selenium script will be displayed in Console Output for the build.
7. Optional: Check Use Local Tunnel to run tests on webpages behind your firewall. (The CBT NodeJS Tunnel must be installed globally.)

Version <= 0.10 Build Step

1. Configure your Jenkins Project.
2. Click Add build step.
3. Click CrossBrowserTesting.com.
4. Add the Operating System, Browser, and Screen Resolution that you want to run a Selenium Test on. You can add multiple build steps to run multiple selenium tests.
5. Click Save
6. Click Build Now to build the project. All files in the project’s workspace will be ran (make sure the selenium scripts are executable). Output from the selenium script will be displayed in Console Output for the build.