openstack
/
project-config
Code Issues Proposed changes

update unified publishing job to work for tags 

The old version of the job converted the tag name to a branch and used
that as the publishing location. We do, however, want to be able to
publish docs for a given version of a deliverable when we tag it. That
will allow us to refer users directly to the guide for the version of
their tool or service.

This change assumes that the job is only configured in the release queue
and will not be run for pre-releases. If it sees that the trigger for
the job is a tag, it uses that as the output location. Otherwise it uses
the branch name. That gives us docs.openstack.org/$project/$version or
docs.openstack.org/$project/latest or
docs.openstack.org/$project/$series as the final destination of the
docs.

Change-Id: I5a3fe2775fc21c23fb1df6f6c987ec63000f1c7c
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
This commit is contained in:
Doug Hellmann 2017-06-28 15:08:20 -04:00
parent 82320aeb4a
commit 780cfd5270
1 changed files with 14 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
jenkins/jobs/openstack-publish-jobs.yaml
View File

@ -36,34 +36,26 @@
#!/bin/bash -x
if [[ $ZUUL_REFNAME =~ ^refs/tags/ ]]; then
# We need to determine the branch by looking to see
# where the tag exists. A tag can be on more than one
# branch, especially if the tag is applied and then the
# stable branch is created as we do in our normal stable
# branch creation process. If we get any stable
# branches, use the most recent one (assuming
# alphabetical ordering). If we do not see master, use
# whatever name we do see and let the logic below
# trigger an abort if we shouldn't be publishing.
refname=$(echo $ZUUL_REFNAME | cut -d/ -f2-)
git branch --contains $refname > branches.txt
if grep -q stable/ branches.txt; then
branch_name=$(grep stable/ branches.txt | sort | tail -n 1)
elif ! grep -q master branches.txt; then
branch_name=$(cat branches.txt | sort | tail -n 1)
else
branch_name=master
fi
# This job should not be configured to run for
# pre-releases, so if we have a tag we want to use it as
# the publishing location.
tag=$(echo $ZUUL_REFNAME | cut -d/ -f2-)
branch_name=""
else
# If the ref wasn't a tag, assume it is a branch.
branch_name=$ZUUL_REFNAME
tag=""
fi
# When building from master we want to publish to the
# "latest" directory. When building from a stable branch, we
# want to publish to a directory using that branch base
# When we have a tag, we want to use that as the publishing
# location so that we get version-specific docs. Otherwise,
# when building from master we want to publish to the
# "latest" directory and when building from a stable branch,
# we want to publish to a directory using that branch base
# name. Building from other branches is an error.
if [[ $branch_name = master ]]; then
if [[ ! -z "$tag" ]]; then
publish_name=$tag
elif [[ $branch_name = master ]]; then
publish_name=latest
elif [[ $branch_name =~ stable/ ]]; then
publish_name=$(basename $branch_name)