X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=src%2Fsite%2Fmarkdown%2Fjenkins.md;h=143cb250f75d7c81328e75f8862be0c839c67ca8;hb=79bff24099fc075993a28c48a3dcd3526a1582d4;hp=5a1cd0c962be34a8e7fde4407109d699ffed5853;hpb=d1df95cda9f4adf2f74388fd7bce7478f11e6ae5;p=releng%2Fbuilder.git
diff --git a/src/site/markdown/jenkins.md b/src/site/markdown/jenkins.md
index 5a1cd0c96..143cb250f 100644
--- a/src/site/markdown/jenkins.md
+++ b/src/site/markdown/jenkins.md
@@ -21,6 +21,9 @@ Sections:
* [Jenkins Sandbox](#jenkins_sandbox)
* [Configuration](#sandbox_config)
* [Manual Method](#jjb_use_manual)
+ * [Test Jobs](#jjb_manual_test)
+ * [Push Jobs](#jjb_manual_push)
+ * [Run Jobs](#jjb_manual_run)
* [Docker Method](#jjb_use_docker)
# Jenkins Master
@@ -243,28 +246,28 @@ actual slave and start handling jobs on it.
- Jenkins Label ubuntu_trusty_mininet |
+ Jenkins Label ubuntu_mininet |
Slave Template name ubuntu-trusty-mininet |
Vagrant Definition releng/builder/vagrant/ubuntu-mininet |
Spinup Script releng/builder/jenkins-scripts/mininet-ubuntu.sh |
- Basic Ubuntu system with ovs ??? and mininet ???
+ Basic Ubuntu system with ovs 2.0.2 and mininet 2.1.0
|
- Jenkins Label ubuntu_trusty_mininet_ovs_23 |
+ Jenkins Label ubuntu_mininet_ovs_23 |
Slave Template name ubuntu-trusty-mininet-ovs-23 |
Vagrant Definition releng/builder/vagrant/ubuntu-mininet-ovs-23 |
Spinup Script releng/builder/jenkins-scripts/mininet-ubuntu.sh |
- Basic Ubuntu system with ovs 2.3 and mininet ???
+ Basic Ubuntu system with ovs 2.3 and mininet 2.2.1
|
@@ -375,7 +378,7 @@ each use of JJB.
The recommended way to install JJB is via pip.
-Clone the latest version of the [`releng/builder`][4] repo.
+First, clone the latest version of the [`releng/builder`][4] repo.
$ git clone https://git.opendaylight.org/gerrit/p/releng/builder.git
@@ -384,12 +387,16 @@ and activated](#jjb_install_venv) a virtual environment for JJB.
$ mkvirtualenv jjb
-When in doubt, the best version of JJB to attempt to use is the version
-specified in the [`builder/jjb/requirements.txt`][33] file.
+The recommended version of JJB to install is the version specified in the
+[`builder/jjb/requirements.txt`][33] file.
# From the root of the releng/builder repo
(jjb)$ pip install -r jjb/requirements.txt
+To validate that JJB was successfully installed you can run this command:
+
+ (jjb)$ jenkins-jobs --version
+
To change the version of JJB specified by [`builder/jjb/requirements.txt`][33]
to install from the latest commit to the master branch of JJB's git repository:
@@ -425,19 +432,19 @@ and activated](#jjb_install_venv) a virtual environment for JJB.
$ mkvirtualenv jjb
You can then use [JJB's `requirements.txt`][20] file to install its
-dependences.
+dependencies. Note that we're not using `sudo` to install as root, since we want
+to make use of the venv we've configured for our current user.
# In the cloned JJB repo, with the desired version of the code checked out
(jjb)$ pip install -r requirements.txt
-Finally, install JJB.
+Then install JJB from the repo with:
- # In the cloned JJB repo, with the desired version of the code checked out
- (jjb)$ python setup.py sdist
- (jjb)$ pip install dist/jenkins-job-builder-*.tar.gz
+ (jjb)$ pip install .
-Note that we're not using `sudo` to install as root, since we want to make
-use of the venv we've configured for our current user.
+To validate that JJB was successfully installed you can run this command:
+
+ (jjb)$ jenkins-jobs --version
### JJB Docker Image
@@ -780,6 +787,24 @@ can push them to the Jenkins sandbox.
# Don't push all jobs by omitting the final param! (ctrl+c to abort)
jenkins-jobs --conf jenkins.ini update jjb/
+### Running Jobs
+
+Once you have your Jenkins job configuration [pushed to the
+Sandbox](#jjb_manual_push) you can trigger it to run.
+
+Find your newly-pushed job on the [Sandbox's web UI][27]. Click on its name to
+see the job's details.
+
+Make sure you're [logged in][32] to the Sandbox.
+
+Click "Build with Parameters" and then "Build".
+
+Wait for your job to be scheduled and run. Click on the job number to see
+details, including console output.
+
+Make changes to your JJB configuration, re-test, re-push and re-run until
+your job is ready.
+
## Docker Method
If [using Docker](#jjb_install_docker):