Difference between revisions of "Localyzer Jenkins Configure System"

From Lingoport Wiki
Jump to: navigation, search
(Rebasing)
(22 intermediate revisions by 3 users not shown)
Line 1: Line 1:
After the plugins are installed, Jenkins should be configured. The following assumes that the Jenkins home directory is '''/home/jenkins'''. On some systems, the Jenkins home directory is set to '''/var/lib/jenkins''' instead. Verify your home directory before making changes.
+
This section assumes that the Jenkins home directory is '''/home/jenkins'''. On some systems, the Jenkins home directory is set to '''/var/lib/jenkins''' instead. Verify your home directory to follow the instructions below. For generality, '''<HOME>''' will be used in place of the actual directory.
   
 
== Environment Variables ==
 
== Environment Variables ==
Line 5: Line 5:
   
 
The following are the name value pairs to add:
 
The following are the name value pairs to add:
* '''LRM_HOME''' (e.g.: /home/jenkins/lingoport/lrm-server-2.0)
+
* '''LRM_HOME''' (e.g.: <HOME>/lingoport/lrm-server-x.x)
* '''DASHBOARD_HOME''' (e.g.: /home/jenkins/lingoport/dashboard-client-2.0)
+
* '''DASHBOARD_HOME''' (e.g.: <HOME>/lingoport/dashboard-client-x.x)
   
  +
If you are using '''TFS''', add the TFS command line executable location to the PATH:
== Throttle ==
 
  +
* '''$PATH''' (e.g.: PATH:/home/jenkins/team_foundation_server/TEE-CLC-12.0.2/ )
Go to Configure (Configure System) and under the Throttle Concurrent Builds, add a category (MAIN for instance) with 1 Maximum Total Concurrent Builds and 1 Maximum Concurrent Builds Per Node.
 
   
  +
== Rebasing ==
Every Jenkins job MUST have this throttle setup.
 
  +
  +
If you are using '''Git''', rebasing is used to keep the branch of an LRM project with a specified branch, such as master. To do so, an LRM project '''config_vcs.properties''' file must end up with the following property:
  +
  +
VCS_GIT_REBASE_BRANCH=master
  +
  +
  +
* '''If the LRM plugin is used,''' the <code>config_vcs.properties</code> gets overwritten. Add at the same location a file called '''<code>config_vcs.properties_rebase</code>''' with the above line in it, it will be '''appended''' to the <code>config_vcs.properties</code> files
  +
  +
  +
* If using a special script, the <code>config_vcs.properties</code> may persist from one invocation to another. In that case, simply add the <code>VCS_GIT_REBASE_BRANCH=master</code> line at the end of the <code>config_vcs.properties</code> file.
   
 
== Configure Global Security ==
 
== Configure Global Security ==
The minimal configuration would be to setup Jenkins' own user database and a matrix based security, with
+
The minimal configuration would be to setup the configuration with:
  +
* Jenkins' own user database and
  +
* a matrix based security,
  +
  +
with the following privileges:
 
* anonymous have a set of very few privileges, if any.
 
* anonymous have a set of very few privileges, if any.
 
* 'authenticated' the ability to run builds, and
 
* 'authenticated' the ability to run builds, and
 
* a few administration accounts with all privileges
 
* a few administration accounts with all privileges
  +
  +
Note: If you want to continue the configuration using scripts, you need to allow the Job/Read permission on anonymous users.
  +
  +
== Next Step ==
  +
[[LRM Jenkins Plugins]]

Revision as of 22:49, 24 November 2020

This section assumes that the Jenkins home directory is /home/jenkins. On some systems, the Jenkins home directory is set to /var/lib/jenkins instead. Verify your home directory to follow the instructions below. For generality, <HOME> will be used in place of the actual directory.

Environment Variables

To set the environment variables, select Jenkins and Manage Jenkins on the left. From there, select Configure System. On the configuration page, scroll down to the Global properties section and select Environmental variables.

The following are the name value pairs to add:

  • LRM_HOME (e.g.: <HOME>/lingoport/lrm-server-x.x)
  • DASHBOARD_HOME (e.g.: <HOME>/lingoport/dashboard-client-x.x)

If you are using TFS, add the TFS command line executable location to the PATH:

  • $PATH (e.g.: PATH:/home/jenkins/team_foundation_server/TEE-CLC-12.0.2/ )

Rebasing

If you are using Git, rebasing is used to keep the branch of an LRM project with a specified branch, such as master. To do so, an LRM project config_vcs.properties file must end up with the following property:

 VCS_GIT_REBASE_BRANCH=master


  • If the LRM plugin is used, the config_vcs.properties gets overwritten. Add at the same location a file called config_vcs.properties_rebase with the above line in it, it will be appended to the config_vcs.properties files


  • If using a special script, the config_vcs.properties may persist from one invocation to another. In that case, simply add the VCS_GIT_REBASE_BRANCH=master line at the end of the config_vcs.properties file.

Configure Global Security

The minimal configuration would be to setup the configuration with:

  • Jenkins' own user database and
  • a matrix based security,

with the following privileges:

  • anonymous have a set of very few privileges, if any.
  • 'authenticated' the ability to run builds, and
  • a few administration accounts with all privileges

Note: If you want to continue the configuration using scripts, you need to allow the Job/Read permission on anonymous users.

Next Step

LRM Jenkins Plugins