...

SeaLights GitHub App Setup

In order to benefit of the Pull Request Analysis, you will need to create a new Appon your Github Enterprise instance.

• This app will be used by the Sealights Task Runner to push the information to your GitHub Entreprise instance.

The creation of the application is a pretty simple and straightforward procedure in GitHub Entreprise settings:

1. Open your GitHub Settings > Developer Settings > Github Apps > New GitHub App page

   • You can also access this setting page using a similar link to: https://githubenterprise.yourorg.net/settings/apps/new

2. Specify the app ID based on the following, after the application has been created:

...

3. The following Private Key is to be downloaded and placed in the same folder as the TaskRunner agent:

...

4. Then, navigate to Install App, and choose an account to install the SeaLights app on:

...

5. Select “All Repositories” in the following screen

...

SeaLights Task Runner App Configuration

To report the Pull Request data to SeaLights, the Task Runner must be installed locally on the GitHub server, or on a server with access to the GitHub Enterprise instance:

1. Download the Task Runner from the following link: https://

...

1. agents.

...

1. sealights.

...

1. co/sl_task_runner/sl_task_runner-

...

1. 4.

...

1. 0.

...

1. 2397.zip

2. Prepare a configuration file to be used by the Task Runner in JSON format:

   • The GitHub Enterprise server properties in this configuration file should be defined within json property "github" as follows:

{
    "tokenFile": "config/sltoken.txt",
	"github":
        {
            "url": "https://github.internal.net:443/api/v3",
            "owner":"repo-owner",
            "repo":"reponame",
            "appId":1,
            "privateKeyFile":"config/github-private-key"
        }
}

• The token to be used should be an Agent token

• The value of the URL should be the on prem Github API url

• Once the above steps have been completed, it’s time to run the task runner .jar file, specifying the configuration file created in the previous step:

java -Dsl.config.file=config/sl-taskrunner-cfg.json -jar sl_task_runner.jar

...

...

...

...

...

...

...

...

...

...

...

...

...

SeaLights GitHub App Installation

...

• This page can also be navigated to by going to your GitHub Settings > Developer Settings > Github Apps > New GitHub App

• Specify the app ID based on the following, after the application has been created:

...

• The following Private Key is to be downloaded and placed in the same folder as the TaskRunner agent:
  

...

• Then, navigate to Install App, and choose an account to install the SeaLights app on:

  Image Removed

• Select “All Repositories” in the following screen

  Image Removed

Configuring the pull request job

The pull request job needs to run the SeaLights build scan and test listener for the test stages you want the analysis on.
These results will be compared to the latest build you reported to SeaLights for the branch you are merging the Pull Request to.

Generating a session ID

You create the Pull Request build session ID by using the SeaLights Java Build Scanner (See: Downloading the java agent files) with the prConfig option:

java -jar sl-build-scanner.jar -prConfig {-token <arg> | -tokenfile <arg>} -appname <arg> -targetBranch <arg> -latestCommit <arg> -pullRequestNumber <arg> -repoUrl <arg> [-pi <arg>] [-pe <arg>]

...

Pull Request parameters explanation as seen in GitHub.com

...