Use our Bamboo plugin to integrate BambooCI with BrowserStack in 5 minutes. Use this Plugin to -

1. Manage your BrowserStack credentials globally or per build job.
2. Set up and teardown BrowserStack Local for testing internal, dev or staging environments.
3. Embed BrowserStack Automate reports in your Bamboo job results.

Before installing the plugin please make sure that you have the necessary privileges to administer your Bamboo installation. We recommend that you do this when there are no active build jobs running on Bamboo.

1. Log into your Bamboo instance as an admin.
2. Click the admin dropdown (Settings icon on the top menu) and choose Add-ons.
3. The Manage add-ons screen will load.
4. Click Find new add-ons, located under the the ADD-ONS section on the left-hand side of the page.
5. Locate BrowserStack Plugin for Bamboo via search.
6. Results include add-on versions compatible with your Bamboo instance.
7. Click Install to download and install your add-on.
8. You're all set!

Follow these steps to configure BrowserStack globally inside your Bamboo

1. Go to Settings > Overview > BrowserStack Configuration in the Bamboo administration control panel.
2. Add your BrowserStack Username and Access Key.
3. Save your changes.

BrowserStack Local Testing allows you to test your private and internal servers, alongside public URLs, using the BrowserStack cloud, which has support for firewalls, proxies and Active Directory. The BrowserStack plugin is responsible for -

1. Downloading the BrowserStack local binary for every platform that the build job is running on
2. Setting up and tearing down the secure tunnel.

The BrowserStack Bamboo plugin sets the following environment variables:

BROWSERSTACK_USERNAME
BROWSERSTACK_ACCESS_KEY
BROWSERSTACK_LOCAL
BROWSERSTACK_LOCAL_IDENTIFIER

Use these environment variables to set the DesiredCapabilities in your tests. For example:

String username = System.getenv("BROWSERSTACK_USERNAME");
String accessKey = System.getenv("BROWSERSTACK_ACCESS_KEY");
String browserstackLocal = System.getenv("BROWSERSTACK_LOCAL");
String browserstackLocalIdentifier = System.getenv("BROWSERSTACK_LOCAL_IDENTIFIER");

DesiredCapabilities capabilities = new DesiredCapabilities();
capabilities.setCapability("os", "Windows");
capabilities.setCapability("browser", "chrome");
capabilities.setCapability("browserstack.local", browserstackLocal);
capabilities.setCapability("browserstack.localIdentifier", browserstackLocalIdentifier);
driver = new RemoteWebDriver(new URL("https://" + username + ":" + accessKey + "@hub.browserstack.com/wd/hub"), capabilities);

To enable BrowserStack Local follow these steps:

1. Check Enable BrowserStack Local in the BrowserStack Configuration section. Note that in case you're already using BrowserStack Local through our bindings, you don't need to check this.
2. Use Modifiers to set any additional configuration (Full list of options here)

You should now be able to run local tests on BrowserStack!

You can use BrowserStack Plugin for Bamboo to configure individual jobs. Any configuration passed at job level will override the Global configuration set in the Administration section. To set a job configuration -

1. Check Override Admin Config inside the Miscellaneous tab for the job.
2. You will now be able to enter your BrowserStack credentials.
3. Check Enable BrowserStack Local to test on your local development servers.

You can use the BrowserStack plugin to view your test reports right inside Bamboo.

For viewing BrowserStack Automate report in your Bamboo CI test results

1. Project must be a Java project.
2. Project must be built with Maven and use either TestNG or JUnit for testing.

Add the following dependencies to your pom.xml file:

<dependency>
    <groupId>com.browserstack</groupId>
    <artifactId>automate-testassist</artifactId>
    <version>0.7.2-SNAPSHOT</version>
</dependency>

Add the following repositories to your pom.xml file:

<repositories>
  <repository>
    <id>sonatype-nexus-snapshots</id>
    <url>https://oss.sonatype.org/content/repositories/snapshots</url>
  </repository>
</repositories>

<pluginRepositories>
  <pluginRepository>
   <id>sonatype-nexus-snapshots</id>
      <url>https://oss.sonatype.org/content/repositories/snapshots</url>
  </pluginRepository>
</pluginRepositories>

Add the following plugin to your pom.xml file:

<build>
    <plugins>
      <plugin>
        <groupId>com.browserstack</groupId>
        <artifactId>automate-maven-plugin</artifactId>
        <version>0.7.2-SNAPSHOT</version>
        <configuration>
            <source>${jdk.source.version}</source>
            <target>${jdk.target.version}</target>
            <complianceLevel>${jdk.source.version}</complianceLevel>
        </configuration>
        <executions>
          <execution>
            <goals>
              <goal>test-compile</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
</build>

You must define the Maven properties, jdk.source.version and jdk.target.version to match the Java versions of your project.

Create a new artifact named BSTACK_REPORTS which stores all of the **/*.xml files generated by your test suite.

You should now be able to see BrowserStack test reports in the BrowserStack Report tab