summaryrefslogtreecommitdiffstats
path: root/doc/source
diff options
context:
space:
mode:
authorPeter Eisentraut <peter@eisentraut.org>2015-11-21 11:19:10 -0500
committerDarragh Bailey <daragh.bailey@gmail.com>2017-05-27 12:22:06 +0100
commit919052714c3a017e96cceceb5344517aa4435572 (patch)
treee3313fb76e4da3f66f9fb581368dd3c170ee6521 /doc/source
parent3799ed2c980240edc9c794190c22f9c210969a6e (diff)
downloadpython-jenkins-job-builder-919052714c3a017e96cceceb5344517aa4435572.tar.gz
python-jenkins-job-builder-919052714c3a017e96cceceb5344517aa4435572.tar.xz
python-jenkins-job-builder-919052714c3a017e96cceceb5344517aa4435572.zip
Add option to make test output file layout match Jenkins
Before, `jenkins-job-builder test -o outdir` would write outdir/job_name With the new option `--config-xml`, it writes outdir/job_name/config.xml to match the layout that Jenkins uses internally. This is more useful for diffing against existing Jenkins installations or uploading job definitions by other means. Also, it seems better to give the output files an .xml extension. Change-Id: I78fc7aff531925ee071b8e19f40f766b4af0b5ad
Diffstat (limited to 'doc/source')
-rw-r--r--doc/source/execution.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/source/execution.rst b/doc/source/execution.rst
index aa75f43a..43a85937 100644
--- a/doc/source/execution.rst
+++ b/doc/source/execution.rst
@@ -153,6 +153,14 @@ You can also pass JJB a directory containing multiple job definition files::
which will write XML files to the output directory for all of the jobs
defined in the defs directory.
+If you run::
+
+ jenkins-jobs test /path/to/defs -o /path/to/output --config-xml
+
+the output directory will contain config.xml files similar to the
+internal storage format of Jenkins. This might allow you to more
+easily compare the output to an existing Jenkins installation.
+
.. _updating-jobs:
Updating Jobs