Add info about running jobs in Sandbox to JJB docs

[releng/builder.git] / src / site / markdown / jenkins.md

diff --git a/src/site/markdown/jenkins.md b/src/site/markdown/jenkins.md
index 9a96b27e5acc8911f39de923445b3571609987da..143cb250f75d7c81328e75f8862be0c839c67ca8 100644 (file)
--- 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)
 
 # <a name="jenkins_master">Jenkins Master</a>
@@ -784,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/ <job-name>
 
+### <a name="jjb_manual_run">Running Jobs</a>
+
+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.
+
 ## <a name="jjb_use_docker">Docker Method</a>
 
 If [using Docker](#jjb_install_docker):