Builds and publishes Compute API Guide

- Want to publish to developer.openstack.org
- Compute API Guide needs to have directory structure determined
  in https://review.openstack.org/#/c/230186/.

Change-Id: Ibc774d24f2bcc63902f67e2540497da838f15d18
Depends-on: Ic060a1e79e4b2f8695cb788ff4df018e0cfd3286

jenkins/jobs/api-jobs.yaml

@@ -75,3 +75,37 @@
           remove-prefix: 'www/'
           excludes: ''
       - console-log
+
+- job:
+    name: gate-compute-api-guide
+    description: Build and draft the Compute API Guide from nova source.
+    node: 'bare-precise || bare-trusty'
+
+    builds:
+      - revoke-sudo
+      - gerrit-git-prep
+      - tox:
+          envlist: 'api-guide'
+
+    publishers:
+      - console-log
+      - upload-api-guide-draft
+
+- job:
+    name: compute-api-guide
+    description: Build and publish the Compute API Guide from nova source.
+    node: 'bare-precise || bare-trusty'
+
+    builds:
+      - revoke-sudo
+      - gerrit-git-prep
+      - tox:
+          envlist: 'api-guide'
+
+    publishers:
+      - ftp:
+          site: developer.openstack.org
+          source: 'doc/source/api-guide/build/html/**'
+          target: 'api-guide/compute'
+          remove-prefix: 'doc/source/api-guide/build/html/'
+

jenkins/jobs/macros.yaml

@@ -858,6 +858,17 @@
               keep-hierarchy: true
               copy-after-failure: true
 
+- publisher:
+    name: upload-api-guide-draft
+    publishers:
+      - scp:
+          site: 'static.openstack.org'
+          files:
+            - target: 'docs-draft/$LOG_PATH'
+              source: 'doc/source/api-guide/build/html/**'
+              keep-hierarchy: true
+              copy-after-failure: true
+
 - publisher:
     name: upload-docs-draft
     publishers:

zuul/layout.yaml

@@ -1265,6 +1265,11 @@ jobs:
   - name: ^gate-.*-docs$
     success-pattern: http://docs-draft.openstack.org/{build.parameters[LOG_PATH]}/doc/build/html/
 
+  - name: gate-compute-api-guide
+    success-pattern: http://docs-draft.openstack.org/{build.parameters[LOG_PATH]}/doc/build/html/
+    voting: false
+    branch: ^(?!stable/(juno|kilo|liberty)).*$
+
   - name: ^gate-.*-js-draft
     parameter-function: set_node_options_default_trusty
     success-pattern: http://docs-draft.openstack.org/{build.parameters[LOG_PATH]}/dist/
@@ -6454,6 +6459,7 @@ projects:
       - gate-tempest-dsvm-cells
       - gate-tempest-dsvm-full-ceph
       - gate-tempest-dsvm-multinode-full
+      - gate-compute-api-guide
     gate:
       - gate-nova-tox-functional
       - gate-devstack-dsvm-cells
@@ -6463,6 +6469,7 @@ projects:
       - gate-tempest-dsvm-cells
     post:
       - nova-coverage
+      - compute-api-guide
     experimental:
       - gate-grenade-dsvm-forward
       - gate-nova-pip-missing-reqs