Add openstack-tox-with-sudo test jobs

Some tox jobs need to not have sudo revoked. Make a job that can be used
that runs tox as the other jobs do but does not revoke sudo first.

Also, add a openstack-tox-functional-with-sudo job as needed by os-vif.

Update some job descriptions.

Co-Authored-By: Andreas Jaeger <aj@suse.com>
Change-Id: Ida9404d2d6d2a4385e92cb40016f1c8bccd7198f
Needed-By: I5b3a6ce0355616084d968c1b01e5629cf0b674bd

playbooks/tox-with-sudo/run.yaml

@@ -0,0 +1,3 @@
+- hosts: all
+  roles:
+    - tox

zuul.d/jobs.yaml

@@ -234,6 +234,14 @@
     vars:
       tox_constraints_file: '{{ ansible_user_dir }}/src/git.openstack.org/openstack/requirements/upper-constraints.txt'
 
+- job:
+    name: openstack-tox-with-sudo
+    parent: openstack-tox
+    description: |
+      Job to run tox for tests with OpenStack project specific
+      settings such as constraints but without sudo access being revoked.
+    run: playbooks/tox-with-sudo/run.yaml
+
 - job:
     name: openstack-tox-py27
     parent: openstack-tox
@@ -345,7 +353,7 @@
     name: openstack-tox-functional
     parent: openstack-tox
     description: |
-      Run functional tests.
+      Run tox-based functional tests for an OpenStack Python project.
 
       Uses tox with the ``functional`` environment.
     irrelevant-files:
@@ -355,11 +363,27 @@
     vars:
       tox_envlist: functional
 
+- job:
+    name: openstack-tox-functional-with-sudo
+    parent: openstack-tox-with-sudo
+    description: |
+      Run tox-based functional tests for an OpenStack Python project.
+
+      Uses tox with the ``functional`` environment.
+      Sudo access is not revoked.
+    irrelevant-files:
+      - ^.*\.rst$
+      - ^doc/.*$
+      - ^releasenotes/.*$
+    vars:
+      tox_envlist: functional
+
 - job:
     name: openstack-tox-functional-py35
     parent: openstack-tox
     description: |
-      Run functional tests using python 3.5.
+      Run tox-based functional tests for an OpenStack Python project
+      under cPython version 3.5..
 
       Uses tox with the ``functional-py35`` environment.
     irrelevant-files: