Add a readthedocs publish trigger to .zuul.yaml

This patch set adds a trigger on post to trigger a RTD job to start
building the documentation post-merge.

Change-Id: Icd0ad1670b0d239e601a4456f84cc46e2f28aaf2

.zuul.yaml

@@ -27,20 +27,21 @@
       jobs:
         - airship-deckhand-tox-py27-postgresql
         - airship-deckhand-tox-py35-postgresql
-        # NOTE(portdirect): enable when voting enabled.
-        # - airship-deckhand-ubuntu:
-        #     irrelevant-files:
-        #       - ^.*\.rst$
-        #       - ^doc/.*$
-        #       - ^releasenotes/.*$
         - airship-deckhand-functional-docker-py35
         - airship-deckhand-functional-uwsgi-py35
         - airship-deckhand-integration-uwsgi-py35
         - airship-deckhand-docker-build-gate
     post:
       jobs:
+        - airship-deckhand-doc-publish
         - airship-deckhand-docker-publish
 
+- nodeset:
+    name: airship-deckhand-single-node
+    nodes:
+      - name: primary
+        label: ubuntu-xenial
+
 - job:
     name: airship-deckhand-tox-py27-postgresql
     parent: openstack-tox-py27
@@ -158,7 +159,7 @@
     name: airship-deckhand-docker-build-gate
     timeout: 1800
     run: tools/gate/playbooks/docker-image-build.yaml
-    nodeset: openstack-helm-single-node
+    nodeset: airship-deckhand-single-node
     irrelevant-files:
       - ^.*\.rst$
       - ^doc/.*$
@@ -176,7 +177,7 @@
     name: airship-deckhand-docker-publish
     timeout: 1800
     run: tools/gate/playbooks/docker-image-build.yaml
-    nodeset: openstack-helm-single-node
+    nodeset: airship-deckhand-single-node
     secrets:
       - airship_deckhand_quay_creds
     irrelevant-files:
@@ -195,6 +196,42 @@
         static:
           - latest
 
+- job:
+    name: airship-deckhand-doc-publish
+    description: |
+      Publish documentation on airship-deckhand.readthedocs.io
+    timeout: 300
+    run: tools/gate/playbooks/rtd-build-trigger.yaml
+    nodeset: airship-deckhand-single-node
+    secrets:
+      - deckhand_rtd_credential
+
+- secret:
+    name: deckhand_rtd_credential
+    data:
+      token: !encrypted/pkcs1-oaep
+        - ptw5Bg0LRV1LYhiv1Cqxphq3UZGYqNI7GVeTJBy5NiidvMRMk/Fvd1lDRevp52scwSHNy
+          1jDUR+XolBaiHgySQbaDneuFr0oFyU72VZLBg53xe7U5aQfPzAdDx6teIly1hWpPmTNal
+          SEQGtF05Nv6PniM4IS9VPHsaRJjiP14t8CpUAwIO/YZWWmSzZo2qeMAGXOXUwGmiR23R8
+          rmlLUXxyMm1v+B/CszfIfSloy3kqB/PuUmoPTC/UdZMVWYv4vJT6SErsc24m0fixXJVwd
+          3ysJv1fOisZYpJaY68a1CghuSza2OZngZNQ5iro1DW5mKcpuEhBbF2tJzuUnvjT635FZZ
+          TuaKFfinmxYa5sMg7fxwfzdJEkMslQKbthJe5nNouBazKEppanIytld+6xSbJw/B1OvJt
+          6vjF8vb42PQSnzLwQXBQmryE6QM22ky2C3ublhuA/Bd/oJHiA7m2r+svTzBMTXfV8pLtj
+          rEjofiAZ0BlieNy/2m0c/KnIuv9rxVYxWdFSR36NJ0EcpKGnvdcnXbi4ko+QcEuDuAnUi
+          eCrX0VDoz4F7WlBUPbc4lujD364AGnoxwsGOinjLExsM0oWiDYG0E5SNXrOVzht9a90qV
+          8UT24WwKzSiwCBOcWzD0zY0ifxvmb3oQKIjZQiSh8kPXHv9ljP3oW9NVWltwzo=
+      id: !encrypted/pkcs1-oaep
+        - OpmuFRUcuoFd7C8soC4ExkJq1K6uo9FQFc5Nw3TBqR70iCYZQs+r4+TyV8/L1L6sddKBl
+          NlV9wQg7RzSZgEzYvzNr3xTyKjxJYdiCbB6YpK/Du7aW5wvOrxhjP6m2+PdbpsGPNkYio
+          YvFgiZuRqt0qQwUp46MJo11rf09ReboDbpDUUdon6E53mbc0V6VUmW9t02zWGuPqmnpS1
+          3NPtCNgZi3Ie6/9AYlSsxpQHWUqcTo2K0XSHHan4MKAVewveATwsEYg2Rs07ud4qeVpsS
+          /YVoWAf4cnn1eDJeUzUAlQGBILbKspOXM9jqg95xm57Plh0cYPeQ/fEhB4tYeaHL+g3Nx
+          0wfmeE7+LsCLIC2Wg+p90WWnh0jV7kwNfAy3j5cDukbDIdptHm+b+yzCc5phwY5io4KFY
+          POmdd3Si2V99d/wc3oXnqCmal8XmLruKd8Qq100ErJhPJQ0VeO9TM9MxenKAavMjYnX2m
+          ioXsLnq6c3bhVxDg3gOmqWrPtPe3VkHnN3hptYr79QKGg65VNCasrc6Y88IGH/nOQSKaB
+          KaJ9sAH4+80U7nvaK6KDOb+8Kvl4qavSSNwtQaSyeYdkviibTuO40Qpg4PO3KHqYq1VEb
+          SMfJSw4+n+aTdU/o4nQlmivTuN9D5MQY/7Bklw/Dro1R1nw0AjugBz0ZEmMFoQ=
+
 - secret:
     name: airship_deckhand_quay_creds
     data:

tools/gate/playbooks/rtd-build-trigger.yaml

@@ -0,0 +1,22 @@
+# Copyright 2018 AT&T Intellectual Property. All other rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+- hosts: primary
+  tasks:
+    - name: Trigger RTD job
+      uri:
+        method: POST
+        body: 'token={{ deckhand_rtd_credential.token }}'
+        url: 'https://readthedocs.org/api/v2/webhook/{{ zuul.project.short_name }}/{{ deckhand_rtd_credential.id }}/'
+        follow_redirects: all