Add opendev-publish-tox-docs

This job is meant to be used in a tag or release pipeline to build
and publish docs for a tag.

Change-Id: I43dd83f06d227153026f3007c76f206b2be055f4
This commit is contained in:
James E. Blair 2019-03-29 13:34:30 -07:00
parent fc233e2194
commit 037616d647
2 changed files with 43 additions and 1 deletions

View File

@ -0,0 +1,26 @@
- hosts: localhost
tasks:
- name: Write branch marker text
copy:
dest: "{{ zuul.executor.log_root }}/docs/.root-marker"
content: "Project: {{ zuul.project.name }} Branch: {{ zuul.branch }} Build: {{ zuul.build }} Revision: {{ zuul.ref }}"
- name: Set publication directory to tag
when: "zuul.tag is defined"
set_fact:
publication_dir: "{{ zuul.tag }}"
- name: Get an AFS token
include_role:
name: create-afs-token
- name: Create publication directory
file:
path: "/afs/.openstack.org/project/opendev.org/docs/{{ zuul.project.name }}/"
state: directory
- name: Upload to AFS
include_role:
name: upload-afs
vars:
afs_source: "{{ zuul.executor.log_root }}/docs/"
afs_target: "/afs/.openstack.org/project/opendev.org/docs/{{ zuul.project.name }}/{{ publication_dir }}"
- name: Destroy AFS token
include_role:
name: destroy-afs-token

View File

@ -253,10 +253,26 @@
post-run: playbooks/tox-docs/post.yaml
success-url: docs/
- job:
name: opendev-publish-tox-docs
parent: opendev-tox-docs
description: |
Publish a ref-based documentation build.
Use this in the tag or release pipelines to publish a build
based on a newly-created tag.
post-run: playbooks/tox-docs/publish.yaml
secrets:
- secret: opendev-zuul-docs
name: afs
- job:
name: opendev-promote-docs
description: |
Publish a previously built documentation tarball.
Publish a previously built branch-tip documentation tarball.
Use this in the promote pipeline to publish a branch tip tarball
built in the gate pipeline.
run: playbooks/docs/promote.yaml
nodeset:
nodes: []