Trigger latest each time. 14/62314/4
authorAric Gardner <agardner@linuxfoundation.org>
Mon, 18 Nov 2019 14:59:28 +0000 (09:59 -0500)
committerAric Gardner <agardner@linuxfoundation.org>
Mon, 18 Nov 2019 21:04:40 +0000 (16:04 -0500)
Trigger "latest" and "branch"

By default rtd serves documentation at /latest/

When a buid was triggered via curl, using a the old method.
"generic api integration"

curl -X POST -d "branches=${GERRIT_BRANCH}" -d "token=$RTD_TOKEN"
"$RTD_BUILD_URL

this returned for example:

{"build_triggered":true,"project":"o-ran-sc-doc","versions":
["latest","master"]}

So the previous behavior was to build latest and master from a call with
branches=master

when we post via the v3 api.
lftools rtd project-build-trigger "$rtdproject" "$STREAM"

It actually respects the $STREAM variable and only builds "master"
This is not what we want,
we want latest to be updated as well.
so we need to trigger both builds.

It is possible to, after project creation "enable master branch"
and then "delete default branch"
so that /latest/ ceases to exist.
but having /latest/ is the default behavior is seems best to
not fight against it, to simplify initial project setup.

The best solution I see right now is to just always trigger latest
as well as the branch we want to build.

Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I6e2062aa30383ee79a1d64d8f5327ef9a05cece6

shell/rtdv3.sh

index c1014f4..3246767 100644 (file)
@@ -85,5 +85,7 @@ echo "INFO: Running merge job"
     fi
   fi
 
+  # api v3 method does not update latest whith stream.
   lftools rtd project-build-trigger "$rtdproject" "$STREAM"
+  lftools rtd project-build-trigger "$rtdproject" latest
 fi