Tutorial - Reporting an Integration Build of 3 components

The following steps define how to report an integration build from 3 components: two backends (Java & .NET) and a front end (JavaScript).

Below is an architecture diagram of the use case described in this tutorial

Step 0 - Define a common LabID

The Sealights' LabID is a string that identifies the testing environment. Normally, this string is generated in the dashboard under the Settings > Integration Build Labs:

Open

In the current example (our tutorial), the LabID used will be QA-ENV1.

Step 1 - Build, Report and Deploy the components one-by-one

1. Component-1 - Back end, Java (Tomcat)

   1. Build and Report Component #1 to the Sealights dashboard

      java -jar sl-build-scanner.jar -config -appname Component-1 -branchname tutorial/master -buildname 1.0.0 -pi *com.example.* java -jar sl-build-scanner.jar -scan -tokenfile .../sltoken.txt -buildsessionid=<Component-1 BSID> -workspacepath "..." -fi "*.class,*.jar" -r

   2. Deploy Component #1: In the JVM arguments, specify a Lab ID parameter (QA-ENV1).

      JAVA_OPTS=-javaagent:sl-test-listener.jar -Dsl.labId=QA-ENV1 -Dsl.buildSessionId=<Component-1 BSID> -Dsl.tokenFile=sltoken.txt

       

2. Component-2 - Back end, .NET (IIS)

   1. Build and Report Component #2 to the Sealights dashboard:

      SL.DotNet.exe config --appName "Component-2" --branchName "tutorial/master" --buildName "1.2.0" --includeNamespace myNameSpace.* --buildSessionIdFile buildSessionId.txt SL.DotNet.exe scan --buildSessionId=<Component-2 BSID> --workspacePath c:\path\to\binaries --ignoreGeneratedCode true

   2. Deploy Component #2: when starting the collector service session, specify the same Lab ID parameter as before:

       

3. Component-3 - Front end, JavaScript

   1. Build and Report Component #3 to the dashboard:

   2. Deploy the instrumented version of your code onto the webserver.

Step 2 - Create the Integration Build and report its components

Create an integration build using one of the following methods:

1. Dependencies file reported via a Sealights agent command

2. REST API calls using Sealights APIs

In our case, we will provide the following JSON file content to the agent scan command (as a file named sl-integration-components.json)

From the different options available, we’ll go with the Java agent to report this integration build

Step 3 - Execute tests against the Integration Build

Application Server Configuration Review

The build session ID used should correspond to the component (unique per component), whereas the lab ID should correspond to the environment (shared between components). For example:

Test Runner Configuration Review

• The build session ID used for reporting test executions should correspond to the integration build, under which the information will be displayed.

• The lab ID should reflect the same environment identifier as the other components which make up the integration build to ensure all the coverage data will be linked together (In our example: QA-ENV1).

• If running tests using the Maven plugin, make the following modifications to the .JSON configuration file before executing your tests with the SeaLights plugin enabled:

   

• If running tests using the Gradle plugin, make the following modifications to your build.gradle according to the following example:

• If running tests using Java CLI commands, use the following configuration in your start/end execution commands: