cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From nikhilkh <...@git.apache.org>
Subject [GitHub] cordova-medic pull request: Adding Instructions for Jenkins setup
Date Fri, 13 May 2016 16:09:39 GMT
Github user nikhilkh commented on a diff in the pull request:

    https://github.com/apache/cordova-medic/pull/104#discussion_r63209355
  
    --- Diff: JENKINS.md ---
    @@ -0,0 +1,123 @@
    +# Jenkins Master Setup
    +## Purpose
    +The purpose of this document is to provide instructions on installation/deployment of
the Jenkins master machine.
    +
    +## Jenkins Installation
    +The Jenkins Installation instructions could be found [here][Jenkins Installation].
    +
    +## Plugins Installation
    +* [GitHub Pull Request Builder Plugin][GitHub Pull Request Builder Plugin]
    +* [Github Authentication plugin][Github Authentication plugin]
    +* [Multiple SCMs plugin][Multiple SCMs plugin]
    +
    +These plugins, listed above, needs to be installed on the Jenkins master. These plugins
are installed along with their dependencies (automatically). Steps on installing the plugins
could be found [here][Jenkins Plugins].
    +
    +_Note_: A restart of the jenkins server is required after plugin installation
    +
    +## GitHub User Creation
    +A new GitHub user has to be created for the purpose of CI. This user will be used for
2 purposes:
    +
    +* To update the status of the CI jobs in the PR (success/failure).
    +* To create a new OAuth Application that is used to authenticate users into your CI system
[This topic will be covered while configuring Github Authentication Plugin]
    +
    +For the initial setup, a new GitHub User has been created with id - [Cordova QA][Cordova
QA] and associated with [apachecordovabot@gmail.com][apachecordovabot@gmail.com]
    +
    +## GitHub OAuth Application Creation
    +Once a GitHub User has been created, it is time to create a new OAuth Application. This
application will be used to login users into your CI system and provide them with the required
access rights (such as admin, read only, etc.). The steps to create the OAuth Application
could be found [here][OAuth Application Creation Instruction]
    +
    +## Authentication Configuration
    +* Go to Jenkins Home Page -> Manage Jenkins -> Configure Global Security
    +* Check *Enable Security* checkbox
    +* Under Access Control ->  Security Realm, Select *Github Authentication Plugin*
    +* The following items must be configured under *Global Github OAuth Settings*:
    +    * *GitHub Web URI*: https://github.com
    +    * *GitHub API URI*: https://api.github.com
    +    * *Client Id*: *Client Id from the newly created GitHub OAuth Application*
    +    * *Client Secret*: *Client Secret from the newly created GitHub OAuth Application*
    +    * *OAuth Scope*: read:org,user:email
    +* Under Authorization, Select *GitHub Commiter Authorization Strategy*
    +* The following items must be configured under *GitHub Authorization Settings*
    +    * *Admin User names*: Provide the github usernames of the persons to be designated
as admins. 
    +    * Check *Grant READ permissions to all Authenticated Users*
    +    * Check *Grant READ permissions for Anonymous Users*
    +    * Check *Grant ViewStatus permissions for Anonymous Users* 
    +
    +__Note__: The OAuth scope could be modified per requirements. Details on the scopes could
be found [here][GitHub OAuth Scopes]. But it is important to remember that "read:org,user:email"
are basic and **mandatory** requirements for the Authentication plugin. If the scope does
not contain them, then the authentication will fail. 
    +
    +## Port Configuration
    +The Jenkins slaves uses a TCP Port to connect to the Master machine. Jenkins provides
the option to use a fixed port or random port. If your master machine is on Cloud (such as
Azure), you must choose the Fixed port and also open that port on the master machine in cloud.
    +
    +### On Jenkins
    +* Go to Jenkins Home Page -> Manage Jenkins -> Configure Global Security
    +* Check *Enable Security* checkbox
    +* Under *TCP port for JNLP slave agents*, choose *Fixed* and provide the port number
(such as 49666)
    +
    +### On Master Machine in cloud 
    +In Azure cloud, you need to open this port as an end point. By default, this port will
have an idle timeout of 4 minutes. This will not be sufficient. So, we need to use Azure Powershell
Tools, to modify this value (There is no UI option to modify this). The following command
could be used to create a port and set the idle timeout value. 
    +
    +```Get-AzureVM -ServiceName cordova-ci -Name cordova-ci | Add-AzureEndpoint -Name "JenkinsSlave"
-Protocol "tcp" -PublicPort 49666 -LocalPort 49666 -IdleTimeoutInMinutes 30 | Update-AzureVM```
    +
    +## Job Creation
    +* Go to Jenkins Home Page -> New Item
    +* Provide a *Item Name* (Such as "cordova-plugin-console")
    +* Choose *Multi-configuration project*
    +* Click *Ok*
    +* Provide a *Description*
    +* Check *GitHub Project*. Provide the correct project URL. (__Note__: This is an important
parameter. GitHub Pull Request will not work without this value)
    +* Check *This build is parameterized*. 
    +    * Add a String Parameter
    +    * Add *ghprbActualCommit* as *Name*
    +    * Add *master* as *Default Value*
    +    * This value will be used to start parameterized builds manually. 
    +* Under *Source Code Management*, Choose *Multiple SCMs*
    +* Add each repository you want to use. Normally for paramedic testing (say for cordova-plugin-console),
you need 3 repositories
    +    * cordova-plugin-console
    +    * cordova-paramedic
    +    * cordova-medic (for configuration files)
    +* For the specific repository that is tested, specify **${ghprbActualCommit}** as the
branch to build. For other two repositories, you could use master.
    +* Checkout each repository to a sub-directory. (This option could be found under Additional
Behaviors)
    +* Under *Build Trigger*, Choose *GitHub Pull Request Builder*. 
    +* Under *Advanced*:
    +    * Choose a Trigger phrase
    +    * Choose the correct crontab
    +    * Choose *Build every pull request automatically without asking (Dangerous!).*
    +* Under *Trigger Setup*, the following values need to be configured:
    +    * *Commit Status Build Triggered*: --none--
    +    * *Commit Status Build Started*: --none--
    +    * *Commit Status Build Result*: Provide appropriate messages for success and failure
    +* Under *Configuration Matrix*:
    +    * Add *Slaves* axis
    +    * Add *User Defined axis*
    +        * Provide platformName as Name
    +        * Provide the following values
    +            * windows-8.1-store
    +            * windows-10-store
    +            * windows-8.1-phone
    +            * ios
    +            * android
    +    * Check *Combination Filter* with the following filter:
    +    
    +```(label == "mac-slave" && platformName == "ios") || (label == "mac-slave" &&
platformName == "android") || (label == "windows-slave" && platformName == "windows-10-store")
|| (label == "windows-slave" && platformName == "windows-8.1-phone") || (label ==
"windows-slave" && platformName == "windows-8.1-store") || (label == "windows-slave"
&& platformName == "android")```
    +* Under *Build*:
    +    * Add *Execute Shell* step with the following commands:
    +        * ``cd cordova-paramedic``
    +        * ``npm install``
    +    * Add a second *Execute Shell* step with the following commands:
    +        * ```node cordova-paramedic/main.js --config $WORKSPACE/cordova-medic/jenkins-conf/$platformName.config.json
--plugin $WORKSPACE/cordova-plugin-console --outputDir $WORKSPACE --tccDb $WORKSPACE/cordova-medic/lib/tcc/TCC.db```
    --- End diff --
    
    My concern is that we will continue to change this and it will be very difficult to maintain
this document. Is there a way to export the Jenkins configuration?


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


Mime
View raw message