From 469b881ced67d6e862a81c48d6e3ba853af3b1e8 Mon Sep 17 00:00:00 2001
From: Lenny Verkhovsky <lennyb@mellanox.com>
Date: Mon, 27 Mar 2017 15:35:11 +0000
Subject: [PATCH] added Single Use Slave plugin

Change-Id: Ibb9579aa107d666bc38e9e285fb8ec4b7eec83bc
---
 doc/source/third_party_ci.rst | 22 ++++++++++++++++++++++
 manifests/jenkins_master.pp   |  3 +++
 2 files changed, 25 insertions(+)

diff --git a/doc/source/third_party_ci.rst b/doc/source/third_party_ci.rst
index d5002e5..0e7e1d1 100644
--- a/doc/source/third_party_ci.rst
+++ b/doc/source/third_party_ci.rst
@@ -553,6 +553,28 @@ Reconfigure your system to use Jenkins security settings stored in
 
     sudo puppet apply --verbose /etc/puppet/manifests/site.pp
 
+Configuring Jenkins Plugins (recommended)
+-----------------------------------------
+
+single-use slave:
+
+This plugin will mark nodes as offline when a job completes on them.
+This plugin is intended to be used with external tools like Nodepool,
+which has the ability to spin up slaves on demand and then reap them when
+Jenkins has run a job on them. This plugin is needed because there is a race
+condition between when the job completes and when the external tool is able
+to reap the node.
+Labels can be taken from the project-config/nodepool/nodepool.yaml file
+under section "labels".
+
+::
+
+    http://<host fqdn/ip>:8080/
+    Manage Jenkins --> Configure System
+    Under "Single Use Slaves"
+    Add comma seperated labels
+
+
 Updating your masterless puppet hosts
 =====================================
 
diff --git a/manifests/jenkins_master.pp b/manifests/jenkins_master.pp
index 3146501..70423af 100644
--- a/manifests/jenkins_master.pp
+++ b/manifests/jenkins_master.pp
@@ -100,6 +100,9 @@ class openstackci::jenkins_master (
   jenkins::plugin { 'token-macro':
     version => '1.5.1',
   }
+  jenkins::plugin { 'singleuseslave':
+    version => '1.0.0',
+  }
 
   if $manage_jenkins_jobs == true {
     if ! defined(Class['project_config']) {