Merge "Set GERRIT_REFSPEC defaults for Gerrit Trigger jobs"

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

diff --git a/src/site/markdown/jenkins.markdown b/src/site/markdown/jenkins.markdown
index f2e4a6aaa59ec256dcf0e5576464e263effed1c0..68f2152c49b0d1b19cba801cf77c4b8566ccf197 100644 (file)
--- a/src/site/markdown/jenkins.markdown
+++ b/src/site/markdown/jenkins.markdown
@@ -397,7 +397,7 @@ under the **DEPENDENCIES** variable.
 
 If no dependencies are listed then this job type is disabled by default.
 
-### Patch Test Job
+### <a name="patch_test_job">Patch Test Job</a>
 
 Trigger: **test-integration**
 
@@ -422,6 +422,18 @@ Some considerations when using this job:
   times by a system test knowable person, the integration group can help with
   that
 
+### Autorelease Validate Job
+
+Trigger: **revalidate**
+
+This job runs the PROJECT-validate-autorelease-BRANCH job which is used as a
+quick sanity test to ensure that a patch does not depend on features that do
+not exist in the current release.
+
+The **revalidate** trigger is useful in cases where a project's verify job
+passed however validate failed due to infra problems or intermittent issues.
+It will retrigger just the validate-autorelease job.
+
 ## <a name="jjb_basic_configuration">Basic Job Configuration</a>
 
 To create jobs based on the above templates you can use the example
@@ -468,6 +480,12 @@ jjb/\<project\>/\<project\>.yaml containing your project's base template.
     #                         (defaults: verify,merge,daily,integration,sonar)
     #
     #          Example      : verify,merge,daily,integration
+    #
+    # -a / --archive-artifacts  : Comma-seperated list of patterns of artifacts
+    #                             to archive on build completion.
+    #                             See: http://ant.apache.org/manual/Types/fileset.html
+    #
+    #          Example      : *.log,*.patches
 
 If all your project requires is the basic verify, merge, and
 daily jobs then using the job template should be all you need to
@@ -499,8 +517,11 @@ NOT want to tune simply remove the parameter or comment out the line with a
     JOB_TEMPLATES: verify,merge,sonar
     STREAMS:
     - beryllium:
+        branch: master
         jdks: openjdk7,openjdk8
-    - stable/lithium:
+        autorelease: true
+    - stable-lithium:
+        branch: stable/lithium
         jdks: openjdk7
     POM: dfapp/pom.xml
     MVN_GOALS: clean install javadoc:aggregate -DrepoBuild -Dmaven.repo.local=$WORKSPACE/.m2repo -Dorg.ops4j.pax.url.mvn.localRepository=$WORKSPACE/.m2repo
@@ -514,6 +535,11 @@ additionally define a "jdks:" section listing the jdks the verify jobs should
 run tests against for the branch; additionally the first jdk listed will be
 used as the default jdk for non-verify type jobs.
 
+Note: Projects that are participating in the simultanious release should set
+"autorelease: true" under the streams they are participating in autorelease
+for. This enables a new job type validate-autorelease which is used to help
+identify if Gerrit patches might break autorelease or not.
+
 #### Advanced
 
 It is also possible to take advantage of both the auto updater and creating