[CORD-2913] Add Makefile to test JJB jobs locally and README describing
how to use them.
Change-Id: I663f332f8076d00a22231d7bfd535578ac3b153f
diff --git a/.gitignore b/.gitignore
index 11b529f..f07503c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -29,4 +29,7 @@
__pycache__/
*.pyc
-onap_sandbox
+# jjb local testing
+venv-jjb
+job-configs
+
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..ab690d9
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,23 @@
+# Makefile for testing JJB jobs in a virtualenv
+
+.PHONY: test clean
+
+VENV_DIR ?= venv-jjb
+JJB_VERSION ?= 2.0.0
+JOBCONFIG_DIR ?= job-configs
+
+$(VENV_DIR):
+ @echo "Setting up virtualenv for JJB testing"
+ virtualenv $@
+ $@/bin/pip install jenkins-job-builder==$(JJB_VERSION) pipdeptree
+
+$(JOBCONFIG_DIR):
+ mkdir $@
+
+test: $(VENV_DIR) $(JOBCONFIG_DIR)
+ source $(VENV_DIR)/bin/activate ; \
+ pipdeptree ; \
+ jenkins-jobs -l DEBUG test --recursive -o $(JOBCONFIG_DIR) jjb/ ;
+
+clean:
+ rm -rf $(VENV_DIR) $(JOBCONFIG_DIR)
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..30d7499
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# ci-management for CORD
+
+This repo holds configuration for the Jenkins testing infrastructure used by
+CORD.
+
+The best way to work with this repo is to check it out with `repo`, per these
+instructions: [Downloading testing and QA
+repositories](https://guide.opencord.org/getting_the_code.html#downloading-testing-and-qa-repositories)
+
+> NOTE: This repo uses git submodules. If you have trouble with the tests or
+> other tasks, please run: `git submodule init && git submodule update` to
+> obtain these submodules, as `repo` won't do this automatically for you.
+
+## Testing job definitions
+
+[Documentation for Jenkins Job Builder
+(JJB)](https://docs.openstack.org/infra/jenkins-job-builder/index.html)
+
+JJB job definitions can be tested by running:
+
+```shell
+make test
+```
+
+Which will create a python virtualenv, install jenkins-job-builder in it, then
+try building all the job files.
+