diff --git a/hack/jenkins/job-configs/global.yaml b/hack/jenkins/job-configs/global.yaml
index 5a51ecc622c..179f50213a0 100644
--- a/hack/jenkins/job-configs/global.yaml
+++ b/hack/jenkins/job-configs/global.yaml
@@ -85,6 +85,16 @@
100.0
+# Implements Docker Build and Publish Plugin
+# https://wiki.jenkins-ci.org/display/JENKINS/CloudBees+Docker+Build+and+Publish+plugin
+# From the docs: 'This plugin provides the ability to build projects with a Dockerfile, and publish the resultant
+# tagged image (repo) to the docker registry.'
+#
+# repoName: docker registry repo name to publish the image
+# dockerfilePath: workspace relative path to the 'Dockerfile' to build
+# tag: Tag to apply to the built image
+# credentialsId: Jenkins 'Username with password' credentials ID (hex string) to authenticate to docker registry.
+# Found under http:/credentials -> "Advanced"
- builder:
name: docker-build-publish
builders:
diff --git a/hack/jenkins/job-configs/node-e2e.yaml b/hack/jenkins/job-configs/node-e2e.yaml
index d42e0897e18..0e9621f3963 100644
--- a/hack/jenkins/job-configs/node-e2e.yaml
+++ b/hack/jenkins/job-configs/node-e2e.yaml
@@ -1,3 +1,13 @@
+# Job template to checkout source from github to $WORKSPACE/go/src/{gitbasedir} and build + publish a docker image.
+# - Tags the docker image with 'canary'.
+# - Job is executed daily and when changes are found polling github (every 5m).
+# - Console output is published to google cloud storage.
+#
+# gitproject: name of the project - for display purposes only
+# owner: owner to be notified for job failures. test results are published to owner email
+# repoName: github repo to checkout e.g. kubernetes/kubernetes or google/cadvisor. Must match the docker image repo name where the image will be published.
+# gitbasedir: directory under $WORKSPACE/go/src to checkout source repo to - e.g. k8s.io/kubernetes or github.com/google/cadvisor
+# dockerfilePath: workspace relative path to the 'Dockerfile' to build
- job-template:
name: '{gitproject}-dockercanarybuild-ci'
description: 'Build and push {gitproject} docker image.
Test Owner: {owner}.'
@@ -38,6 +48,16 @@
fail: true
- timestamps
+# Job template to checkout source from github to $WORKSPACE/go/src/{gitbasedir}, setup go environment variables, and execute a
+# shell script.
+# - Job is executed daily and when changes are found polling github (every 5m).
+# - Console output is published to google cloud storage.
+#
+# gitproject: name of the project - for display purposes only
+# owner: owner to be notified for job failures. test results are published to owner email
+# repoName: github repo to checkout e.g. kubernetes/kubernetes or google/cadvisor
+# gitbasedir: directory under $WORKSPACE/go/src to checkout source repo to - e.g. k8s.io/kubernetes or github.com/google/cadvisor
+# shell: shell to execute from workspace
- job-template:
name: '{gitproject}-gce-e2e-ci'
description: '{gitproject} continuous e2e tests.
Test Owner: {owner}.'