summaryrefslogtreecommitdiffstats
path: root/jenkins_jobs/modules/general.py
diff options
context:
space:
mode:
authorDarragh Bailey <dbailey@hp.com>2015-11-30 13:20:15 +0100
committerThanh Ha <thanh.ha@linuxfoundation.org>2017-10-23 13:29:21 -0400
commitaf9d984baa7f93ba8e846ff30a681d04117397e7 (patch)
tree5b9fa93edf1436319b5f657bfdb2a8a7ec101f3d /jenkins_jobs/modules/general.py
parent16a307188e1059f6971e7c475ae7bd4c7afb388c (diff)
downloadpython-jenkins-job-builder-af9d984baa7f93ba8e846ff30a681d04117397e7.tar.gz
python-jenkins-job-builder-af9d984baa7f93ba8e846ff30a681d04117397e7.tar.xz
python-jenkins-job-builder-af9d984baa7f93ba8e846ff30a681d04117397e7.zip
Basic folder support
Allows specifying a folder attribute for each job generated, which in turn is used when creating or uploading to place the job under the requested folder. The job name is expanded after defaults are applied, to support the attribute being defined within a set of defaults applied to a number of jobs. This in turn allows for multiple jobs with the same basename to exist, provided they are targeted at different folders. Does not support creating the folders if they do not exist. Change-Id: I8c2157c4c81087cc972a048d1b88d5f08ac65361
Diffstat (limited to 'jenkins_jobs/modules/general.py')
-rw-r--r--jenkins_jobs/modules/general.py7
1 files changed, 6 insertions, 1 deletions
diff --git a/jenkins_jobs/modules/general.py b/jenkins_jobs/modules/general.py
index 658d3c14..0bfca537 100644
--- a/jenkins_jobs/modules/general.py
+++ b/jenkins_jobs/modules/general.py
@@ -56,6 +56,12 @@ Example:
Path for a custom workspace. Defaults to Jenkins default
configuration.
+ * **folder**:
+ The folder attribute provides an alternative to using '<path>/<name>' as
+ the job name to specify which Jenkins folder to upload the job to.
+ Requires the `CloudBees Folders Plugin.
+ <https://wiki.jenkins-ci.org/display/JENKINS/CloudBees+Folders+Plugin>`_
+
* **child-workspace**:
Path for a child custom workspace. Defaults to Jenkins default
configuration. This parameter is only valid for matrix type jobs.
@@ -103,7 +109,6 @@ Example:
* **raw**:
If present, this section should contain a single **xml** entry. This XML
will be inserted at the top-level of the :ref:`Job` definition.
-
"""
import logging