Display UML diagrams for doc gerrit reviews

Install plantuml as part of the verify build step
before sphinx html builder runs.  UML diagrams
will then be included with the verify job archived
html folder for use in gerrit code reviews.

Change-Id: I7eb1b42d57d5352257a43f5e5d9ef1ef9a175d11
Issue-ID: DOC-314
Signed-off-by: Rich Bennett <rb2745@att.com>

diff --git a/jjb/doc/doc-install-plantuml.sh b/jjb/doc/doc-install-plantuml.sh
new file mode 100644 (file)
index 0000000..0f5aedd
--- /dev/null
+++ b/jjb/doc/doc-install-plantuml.sh
@@ -0,0 +1,19 @@
+#!/bin/bash
+set -x
+if [ ! -d /usr/share/plantuml ]
+       then
+       sudo mkdir -p /usr/share/plantuml
+       cd /usr/share/plantuml
+       sudo wget https://nexus.onap.org/service/local/repositories/central/content/net/sourceforge/plantuml/plantuml/8059/plantuml-8059.jar
+       sudo mv plantuml-8059.jar plantuml.jar
+       fi
+
+if [ ! -f /usr/bin/plantuml ]
+       then
+       sudo touch /usr/bin/plantuml
+       sudo chmod +w /usr/bin/plantuml
+       echo "#!/bin/bash" > /tmp/x.$$
+       echo "java -jar /usr/share/plantuml/plantuml.jar \$@"  >> /tmp/x.$$
+       sudo cp /tmp/x.$$ /usr/bin/plantuml
+       sudo chmod +x /usr/bin/plantuml
+       fi

diff --git a/jjb/doc/doc-templates-rtd.yaml b/jjb/doc/doc-templates-rtd.yaml
index 4bc2d11..77cea69 100644 (file)
--- a/jjb/doc/doc-templates-rtd.yaml
+++ b/jjb/doc/doc-templates-rtd.yaml
@@ -68,6 +68,7 @@
           else
               git fetch origin $GERRIT_REFSPEC && git checkout FETCH_HEAD
           fi
+      - shell: !include-raw: doc-install-plantuml.sh
       - shell: |
           #!/bin/bash
           virtualenv $WORKSPACE/venv-tox