Update publish-openstack-python-docs to use tox role

Stop using run-docs.sh from jenkins/scripts.

Change-Id: Ibcdbb043e7344253c6149a98732e824216256f70
Depends-On: Ib998f83135a4fcb796a205e52c435ab29b7cab7b
Signed-off-by: Paul Belanger <pabelanger@redhat.com>

playbooks/python-docs/post.yaml

@@ -1,5 +1,6 @@
 - hosts: all
   roles:
+    - prepare-docs-for-afs
     - fetch-tox-output
     - role: fetch-sphinx-output
       sphinx_output_src: "src/{{ zuul.project.canonical_name }}/doc/build/html/"

playbooks/python-docs/run.yaml

@@ -1,6 +1,7 @@
 - hosts: all
-  tasks:
-    - name: Execute run-docs.sh.
-      shell: /usr/local/jenkins/slave_scripts/run-docs.sh venv
-      args:
-        chdir: "src/{{ zuul.project.canonical_name }}"
+  pre_tasks:
+    - name: Ensure tox is installed
+      shell: type tox || pip install --user tox
+
+  roles:
+    - role: tox

zuul.yaml

@@ -215,6 +215,9 @@
         name: pypi_info
       - gpg_key
 
+# NOTE(pabelanger): We have related untrusted job in openstack-zuul-jobs called
+# openstack-doc-build. We should discuss post PTG how to potentially deal with
+# duplication.
 - job:
     name: publish-openstack-python-docs
     parent: publish-openstack-afs
@@ -223,6 +226,16 @@
     pre-run: playbooks/python-docs/pre
     run: playbooks/python-docs/run
     post-run: playbooks/python-docs/post
+    required-projects:
+      - name: openstack/requirements
+    roles:
+      - zuul: openstack-infra/zuul-jobs
+      - zuul: openstack-infra/openstack-zuul-jobs
+    vars:
+      tox_environment:
+        UPPER_CONSTRAINTS_FILE: "{{ ansible_user_dir }}/src/git.openstack.org/openstack/requirements/upper-constraints.txt"
+      tox_envlist: venv
+      tox_extra_args: -vv python setup.py build_sphinx
 
 - job:
     name: publish-openstack-python-branch-tarball