Add run-docs role and tox-docs job

Change-Id: I0bdb5b461950533880157c09463a3256967c81c7
Signed-off-by: Paul Belanger <pabelanger@redhat.com>

.zuul.yaml

@@ -20,6 +20,10 @@
     parent: tox
     voting: false
 
+- job:
+    name: tox-docs
+    parent: tox
+
 - job:
     name: tox-linters
     parent: tox
@@ -32,6 +36,7 @@
     name: openstack-infra/zuul
     check:
       jobs:
+        - tox-docs
         - tox-cover
         - tox-linters
         - tox-py27

playbooks/roles/run-docs/defaults/main.yaml

@@ -0,0 +1,2 @@
+---
+run_docs_envlist: venv

playbooks/roles/run-docs/tasks/main.yaml

@@ -0,0 +1,4 @@
+- name: Execute run-docs.sh.
+  shell: "/usr/local/jenkins/slave_scripts/run-docs.sh {{ run_docs_envlist }}"
+  args:
+    chdir: "/home/zuul/workspace/src/{{ zuul.project }}"

playbooks/tox-docs.yaml

@@ -0,0 +1,3 @@
+- hosts: all
+  roles:
+    - run-docs