Add branch docs jobs

These publish docs for the branch tip and are designed for use in
the promote pipeline.

Change-Id: I1bc0c88879417737838897b046de43fa1a04a4fd

playbooks/docs/promote.yaml

@@ -0,0 +1,38 @@
+- hosts: localhost
+  tasks:
+    - name: Download docs archive
+      include_role:
+        name: download-artifact
+      vars:
+        download_artifact_job: zuul-tox-docs
+        download_artifact_api: "https://zuul.opendev.org/api/tenant/{{ zuul.tenant }}"
+        download_artifact_name: docs_archive
+        download_artifact_pipeline: gate
+    - name: Create working directory
+      file:
+        path: "{{ zuul.executor.work_root }}/docs"
+        state: directory
+    - name: Extract docs archive
+      unarchive:
+        src: "{{ zuul.executor.work_root }}/docs-html.tar.bz2"
+        dest: "{{ zuul.executor.work_root }}/docs"
+    - name: Write branch marker text
+      copy:
+        dest: "{{ zuul.executor.work_root }}/docs/.root-marker"
+        content: "Project: {{ zuul.project.name }} Branch: {{ zuul.branch }} Build: {{ zuul.build }} Revision: {{ zuul.ref }}"
+    - name: Get an AFS token
+      include_role:
+        name: create-afs-token
+    - name: Create publication directory
+      file:
+        path: "/afs/.openstack.org/project/zuul-ci.org/www/docs/{{ zuul.project.short_name }}/"
+        state: directory
+    - name: Upload to AFS
+      include_role:
+        name: upload-afs
+      vars:
+        afs_source: "{{ zuul.executor.work_root }}/docs/"
+        afs_target: "/afs/.openstack.org/project/zuul-ci.org/www/docs/{{ zuul.project.short_name }}"
+    - name: Destroy AFS token
+      include_role:
+        name: destroy-afs-token

zuul.d/jobs.yaml

@@ -0,0 +1,14 @@
+- job:
+    name: zuul-tox-docs
+    parent: opendev-tox-docs
+
+- job:
+    name: zuul-promote-docs
+    description: |
+      Publish a previously built documentation tarball.
+    run: playbooks/docs/promote.yaml
+    nodeset:
+      nodes: []
+    secrets:
+      - secret: zuul-afs
+        name: afs

zuul.d/secrets.yaml

@@ -0,0 +1,15 @@
+- secret:
+    name: zuul-afs
+    data:
+      keytab: !encrypted/pkcs1-oaep
+        - SSW0rq7zWYhA8yDGkaYfY3gUPAHuhO5CXyjFCMtUVBNp5LG+H1Z0tM8ZN23/JNVyjX1ZB
+          PAwG67fbmlJx/S+FFz/a/Mwps9qzCXRMY+Qsw+PhtDe3aC6VslPFXPyEj06GkGIRBKgOu
+          Px/FurMzLY+Jy2UQAdshA8dztu9hDHLS9V/PsbX4XpPQ5z/BigpkwA5qvNTusGYF18rXp
+          7F2wOxBQnP8adHDfyNOA/Q5cHvfaQXkg+Qvm1ck02Z6rVrseiuqQ95zcSMS3v6RjmfTUS
+          R7THv/Pb3iAbd5jt6fPSVn1yyffoUHPEmx1MHDH9lO36gRkgWVuTpb/XR4emVuxfmck1X
+          suNMCxYPMtmuF4Tfu6DwhVvfQ+2rCcqkhgYXyOW+7HnQWEU6aPB4xmx9IeYPqDaX6xhlQ
+          G5WnW0mGUFKQTqM+GlvdusBGfEnGrzL9zHEqYqFf2MulX0jCp6TIBzDE/j8oCLVyJ3hc7
+          q+WeV4P1G8yWvyW4Pt8GethrqWI9bJ5ECMCNC8T2qAjatE1CXFZRD4zGbb6wu+69wdmig
+          nHKh0taOv2qQzvUeM1FhS2lTz7P+Y0GqKPEp38v4LbcIuz+2f3DHGy3oFFpmza3FRY2Hm
+          M65OaTRiJQQV1TvCQHmmfDM/FJxfCmjH5lI7zxeW0mBmUOqdNWPxQm6OidkSXk=
+      service_name: service/zuul-website@OPENSTACK.ORG