On Boarding a Globalyzer Project

Before On Boarding a Globalyzer Project

Lingoport has created a Pre-flight Check for Globalyzer. Before on boarding a Globalyzer project, please do the pre-flight check.

To on-board a Globalyzer project, some basic information is needed:

Code Repository Location

• The code repository location and branch for the project.
• Git locations could look like: https://github.com/group/project ; In addition, the branch for the Git project is needed.
• SVN locations could look like: https://svn.group.com/project/trunk.
• Read and Write Access granted to repository.

Globalyzer Scan Information

• The directories and files to be scanned, as well as what should not be scanned, like code libraries.
• The rulesets to be used to scan the source code.
• A Globalyzer Project file is created with this information and put in the code repository.

On Boarding the Globalyzer Automation Job

Jenkins

Create the Jenkins job

To begin the on-boarding process, go to Jenkins, and select the 1-Automation Tab, and New Item

• Make a copy of Lingoport.SampleLite
• Set the name of the new job to <groupname>.<projectname>
• Make sure Add to current view is checked and select OK

Configure the Jenkins job

General

• General section: Select the GitHub project and fill in the Project url (if using git repositories)
• Throttle Concurrent Builds should be checked.
• Throttle this project as part of one or more categories
• LRM Throttle should be checked.

Source Code Management

Source Code Management section: Set up the Repository, Credentials, and Branch. For example if the Git repository is Acme/myproject and the code to work with is in the 'development' branch, then set the Repository URL to https://github.com/Acme/myproject.git. It is often easy to copy this from GitHub. For the branch, make sure to define it as */development. If the '*/' is left off, there will be problems.

Build Triggers

These are left unchecked by default, but the Build Periodically can be set to build on a repeating basis.

Build Environment

Leave these unchecked.

Build

Globalyzer requires a Project Definition File. Is is recommended that this is put in the repository in a lingoport folder, although it can be anywhere as long as it can be found. Here is an example of a Project Definition File.

For the full instructions to setup a project definition file, see our help page.

Post Build Actions

• Nothing needs to be modified in this section

Select the Save button. Enable the project and Build Now. The Jenkins project should run and push the results to the Lingoport Dashboard.

For more information, see Project Configuration Files

Verifying the Automation Job

The Jenkins job should complete successfully and populate the Lingoport Dashboard.

To check if it completed successfully, select the project and look at the Build History

The indicator should look like a blue ball. If it is a red ball, select it to go to Console Output and look for errors.

If the indicator is blue, then login to the Lingoport Dashboard and verify that the project is on the Dashboard. The Globalyzer Dashboard will show the number of issues found and the rule sets that were used to scan the code as well as how much code was scanned.

If there are problems at this point, please contact support@lingoport.com for assistance.