Backport zuul jobs

With latest changes to Zuul, we need to backport the jobs as well
from master.

Change-Id: I4189d5d3378dba68eb2d0a4119fa48aa03c3ec45

.zuul.yaml

@@ -1,5 +1,107 @@
-# This just contains the jobs to call, the jobs are defined in the
-# master branch.
+# Shared Zuul v3 definitions for OpenStack CI.
+
+# These jobs are used in api-site, openstack-manuals, and security-doc
+# repositories.
+
+- job:
+    name: build-tox-manuals
+    description: |
+      Base job to build manual related documents. These build jobs
+      invoke a tox command and expect the published content to be in
+      publish-docs directory. This content is published on the root of
+      the website.
+
+      Note that this build job does not create a root-marker file,
+      this has to be done by scripts called from tox.
+    parent: openstack-tox
+    success-url: publish-docs/
+    post-run: playbooks/build-manuals-tox/post.yaml
+    roles:
+      - zuul: openstack-infra/zuul-jobs
+
+- job:
+    name: build-tox-manuals-checkbuild
+    parent: build-tox-manuals
+    vars:
+      tox_envlist: checkbuild
+
+- job:
+    name: build-tox-manuals-checklang
+    parent: build-tox-manuals
+    vars:
+      tox_envlist: checklang
+    files:
+      - ^.*\.po$
+      - ^.*\.pot$
+      - ^.*requirements.txt$
+      - ^bindep.txt
+      - ^doc-tools-check-languages.conf
+      - ^tools/
+      - ^tox.ini
+
+# Templates to easily group jobs.
+- project-template:
+    name: openstack-manuals-jobs
+    description: |
+      Runs jobs for non-translated documents.
+    check:
+      jobs:
+        - openstack-tox-linters
+        - build-tox-manuals-checkbuild
+    gate:
+      jobs:
+        - openstack-tox-linters
+        - build-tox-manuals-checkbuild
+    post:
+      jobs:
+        - publish-openstack-manuals
+
+- project-template:
+    name: openstack-manuals-developer-jobs
+    description: |
+      Runs jobs for non-translated documents.
+      This will publish content to developer.openstack.org.
+    check:
+      jobs:
+        - openstack-tox-linters
+        - build-tox-manuals-checkbuild
+    gate:
+      jobs:
+        - openstack-tox-linters
+        - build-tox-manuals-checkbuild
+    post:
+      jobs:
+        - publish-openstack-manuals-developer
+
+
+- project-template:
+    name: openstack-manuals-build-translation
+    description: |
+      Runs jobs to build translated documents.
+    check:
+      jobs:
+        - build-tox-manuals-checklang
+    gate:
+      jobs:
+        - build-tox-manuals-checklang
+    post:
+      jobs:
+        - publish-openstack-manuals-lang
+
+- project-template:
+    name: openstack-manuals-developer-build-translation
+    description: |
+      Runs jobs to build translated documents.
+      This will publish content to developer.openstack.org.
+    check:
+      jobs:
+        - build-tox-manuals-checklang
+    gate:
+      jobs:
+        - build-tox-manuals-checklang
+    post:
+      jobs:
+        - publish-openstack-manuals-developer-lang
 
 # Configuration for this repository, determines which jobs to run.
 - project: