summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFatih Degirmenci <fatih.degirmenci@ericsson.com>2015-09-28 15:59:14 +0000
committerFatih Degirmenci <fatih.degirmenci@ericsson.com>2015-09-28 15:59:14 +0000
commit65dc9ef70b80d18c366f4b38d154e3b5a1a3f495 (patch)
tree4e17e4c883d763103ba3a219b6132f9df714f88c
parent5666dbb6a88aad1293c992c0d13f824b898da9e1 (diff)
Revert "Update slave connection document for Arno SR1"
This reverts commit 5666dbb6a88aad1293c992c0d13f824b898da9e1. Change-Id: I28b8b574f87cfa5b8ce3d2e1a3d9fb6f271d0fea
-rw-r--r--docs/opnfv-jenkins-slave-connection.rst81
1 files changed, 42 insertions, 39 deletions
diff --git a/docs/opnfv-jenkins-slave-connection.rst b/docs/opnfv-jenkins-slave-connection.rst
index 6114e27..2adea18 100644
--- a/docs/opnfv-jenkins-slave-connection.rst
+++ b/docs/opnfv-jenkins-slave-connection.rst
@@ -1,9 +1,9 @@
-================================================
-Connecting OPNFV Community Labs to OPNFV Jenkins
-================================================
+:Authors: Fatih Degirmenci (Ericsson AB)
+:Version: 0.1.0
-.. contents:: Table of Contents
- :backlinks: none
+================================
+Connecting Labs to OPNFV Jenkins
+================================
Abstract
========
@@ -12,34 +12,43 @@ This document describes how to connect resources (servers) located in Linux Foun
License
=======
-Connecting OPNFV Community Labs to OPNFV Jenkins (c) by Fatih Degirmenci (Ericsson AB)
+Connecting Labs to OPNFV Jenkins (c) by Fatih Degirmenci (Ericsson AB)
-Connecting OPNFV Labs to OPNFV Jenkins document is licensed under a Creative Commons Attribution 4.0 International License. You should have received a copy of the license along with this. If not, see <http://creativecommons.org/licenses/by/4.0/>.
+Connecting Labs to OPNFV Jenkins document is licensed under a Creative Commons Attribution 4.0 International License. You should have received a copy of the license along with this. If not, see <http://creativecommons.org/licenses/by/4.0/>.
+**Contents**
-Version History
-===============
+1 Version history
-+--------------------+--------------------+--------------------+----------------------+
-| **Date** | **Ver.** | **Author** | **Comment** |
-| | | | |
-+--------------------+--------------------+--------------------+----------------------+
-| 2015-05-05 | 0.1.0 | Fatih Degirmenci | First draft |
-| | | | |
-+--------------------+--------------------+--------------------+----------------------+
-| 2015-09-25 | 1.0.0 | Fatih Degirmenci | Instructions for the |
-| | | | Arno SR1 release |
-+--------------------+--------------------+--------------------+----------------------+
+2 Jenkins
-Jenkins
-=======
+3 Jenkins Slaves
+
+4 Connecting Slaves to OPNFV Jenkins
+
+5 References
+
+
+1 Version History
+===================
+
++--------------------+--------------------+--------------------+--------------------+
+| **Date** | **Ver.** | **Author** | **Comment** |
+| | | | |
++--------------------+--------------------+--------------------+--------------------+
+| 2015-05-05 | 0.1.0 | Fatih Degirmenci | First draft |
+| | | | |
++--------------------+--------------------+--------------------+--------------------+
+
+2 Jenkins
+===========
Jenkins is an extensible open source Continuous Integration (CI) server. [1]
Linux Foundation (LF) hosts and operates `OPNFV Jenkins <https://build.opnfv.org/ci/>`_.
-Jenkins Slaves
-==============
+3 Jenkins Slaves
+==================
**Slaves** are computers that are set up to build projects for a **Jenkins Master**. [2]
@@ -55,20 +64,20 @@ Two types of slaves are currently connected to OPNFV Jenkins and handling differ
The slaves connected to OPNFV Jenkins can be seen using this link: https://build.opnfv.org/ci/computer/
Slaves without red cross next to computer icon are fully functional.
-Connecting Slaves to OPNFV Jenkins
-==================================
+4 Connecting Slaves to OPNFV Jenkins
+======================================
The method that is normally used for connecting slaves to Jenkins requires direct SSH access to servers. [3] This is the method that is used for connecting slaves hosted in LF Lab.
Connecting slaves using direct SSH access can become a challenge given that OPNFV Project has number of different labs provided by community as mentioned in previous section. All these labs have different security requirements which can increase the effort and the time needed for connecting slaves to Jenkins. In order to reduce the effort and the time needed for connecting slaves and streamline the process, it has been decided to connect slaves using `Java Network Launch Protocol (JNLP) <https://docs.oracle.com/javase/tutorial/deployment/deploymentInDepth/jnlp.html>`_.
-Connecting Slaves from LF Lab to OPNFV Jenkins
-----------------------------------------------
+4.1 Connecting Slaves from LF Lab to OPNFV Jenkins
+--------------------------------------------------
Slaves hosted in LF Lab are handled by LF. All the requests and questions regarding these slaves should be submitted to `OPNFV LF Helpdesk <opnfv-helpdesk@rt.linuxfoundation.org>`_.
-Connecting Slaves from Community Labs to OPNFV Jenkins
-------------------------------------------------------
+4.2 Connecting Slaves from Community Labs to OPNFV Jenkins
+----------------------------------------------------------
As noted in corresponding section, slaves from Community Labs are connected using JNLP. Via JNLP, slaves open connection towards Jenkins Master instead of Jenkins Master accessing to them directly.
@@ -81,7 +90,7 @@ Please follow below steps to connect a slave to OPNFV Jenkins.
3. Create a local user on server you want to connect to OPNFV Jenkins. (named **jenkins** for example)
4. Download slave.jar using https://build.opnfv.org/ci/jnlpJars/slave.jar and place it to somewhere so jenkins user created in previous step can access.
5. Create a directory /home/jenkins/opnfv_slave_root.
-6. Contact LF by sending mail to opnfv-helpdesk@rt.linuxfoundation.org as getting the server connected requires help from LF.
+6. Contact LF via chat as getting the server connected requires help from LF. (aricg on freenode)
7. Provide needed information to LF such as the IP of the server, name of the slave, and slave root. (/home/jenkins/opnfv_slave_root for example)
8. LF will provide you the key/token you need to use.
9. Try to see if you can establish connection towards OPNFV Jenkins by using below command.
@@ -91,20 +100,14 @@ Please follow below steps to connect a slave to OPNFV Jenkins.
10. Navigate to OPNFV Jenkins and look for your slave. It should have some executors in “Idle” state if the connection is successful.
11. Once you reach this step, you have the server connection to OPNFV Jenkins completed. You can script the command you used above so the connection between slave and Jenkins can be kept open.
-Notes
-==========
-
-It is important to keep the slave.jar up to date since OPNFV Jenkins version may be updated any time. In order to make sure you are using compatible version of slave.jar, you can download it from https://build.opnfv.org/ci/jnlpJars/slave.jar whenever you reopen the connection towards OPNFV Jenkins. You may experience random disconnects if you do not do this regularly.
-
-References
-==========
-
+5 References
+==============
* `What is Jenkins <https://wiki.jenkins-ci.org/display/JENKINS/Meet+Jenkins>`_
* `Jenkins Terminology <https://wiki.jenkins-ci.org/display/JENKINS/Terminology>`_
* `Jenkins SSH Slaves Plugin <https://wiki.jenkins-ci.org/display/JENKINS/SSH+Slaves+plugin>`_
-
**Documentation tracking**
+
Revision: _sha1_
Build date: _date_