Change in osmo-gsm-tester[master]: contrib/jenkins*: build and publish manuals

This is merely a historical archive of years 2008-2021, before the migration to mailman3.

A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.

osmith gerrit-no-reply at lists.osmocom.org
Tue Dec 11 12:28:18 UTC 2018


osmith has submitted this change and it was merged. ( https://gerrit.osmocom.org/12213 )

Change subject: contrib/jenkins*: build and publish manuals
......................................................................

contrib/jenkins*: build and publish manuals

Add contrib/jenkins-build-manuals.sh, which clones or updates
osmo-gsm-manuals and builds the manuals. When the environment variable
PUBLISH=1 is set, it also uploads them.

Call jenkins-build-manuals.sh from jenkins-run.sh, without PUBLISH=1,
so the manuals get build-tested in the osmo-gsm-tester_gerrit job.

A new job master-osmo-gsm-tester will be added in the future, which
will run PUBLISH=1 jenkins-build-manuals.sh.

The jenkins-build-manuals.sh script does not use the osmo-ci.git
scripts for installing dependencies and cleaning up the workspace.
These scripts are not available on the node, which runs the
osmo-gsm-tester_gerrit job, and it is not trivial to add just them
(without building the osmo-ci Docker image etc.). The only dependency
is osmo-gsm-manuals, and it does not need to be compiled, so it seemed
to be the most maintainable solution to implement the clone/update and
clean up in a few lines of shell code instead.

Related: OS#3385
Change-Id: I4ebfe12a164f807b63bc897aff44db83fc0705bd
---
A contrib/jenkins-build-manuals.sh
M contrib/jenkins-make-check-and-run.sh
2 files changed, 41 insertions(+), 0 deletions(-)

Approvals:
  Jenkins Builder: Verified
  Neels Hofmeyr: Looks good to me, approved



diff --git a/contrib/jenkins-build-manuals.sh b/contrib/jenkins-build-manuals.sh
new file mode 100755
index 0000000..48f7780
--- /dev/null
+++ b/contrib/jenkins-build-manuals.sh
@@ -0,0 +1,40 @@
+#!/bin/sh -ex
+# environment variables:
+# * PUBLISH: upload manuals after building if set to "1"
+
+base="$PWD"
+export OSMO_GSM_MANUALS_DIR="$base/osmo-gsm-manuals"
+
+# Sanity check
+if ! [ -d "$base/doc/manuals" ]; then
+	echo "ERROR: this script needs to be executed from the top dir of osmo-gsm-tester.git."
+	exit 1
+fi
+
+# Clone/update osmo-gsm-manuals and wipe local modifications
+if [ -d "$OSMO_GSM_MANUALS_DIR" ]; then
+	git -C "$OSMO_GSM_MANUALS_DIR" pull
+else
+	git clone "https://git.osmocom.org/osmo-gsm-manuals" "$OSMO_GSM_MANUALS_DIR"
+fi
+git -C "$OSMO_GSM_MANUALS_DIR" checkout -f HEAD
+
+# Copy manuals source to empty temp dir (so we can easily clean up afterwards)
+temp="$base/_manuals_temp"
+if [ -d "$temp" ]; then
+	rm -rf "$temp"
+fi
+cp -r "$base/doc/manuals" "$temp"
+
+# Build the manuals
+cd "$temp"
+make
+make check
+
+# Publish
+if [ "$PUBLISH" = "1" ]; then
+	make publish
+fi
+
+# Clean up
+rm -r "$temp"
diff --git a/contrib/jenkins-make-check-and-run.sh b/contrib/jenkins-make-check-and-run.sh
index 3017fd4..2a9bc82 100755
--- a/contrib/jenkins-make-check-and-run.sh
+++ b/contrib/jenkins-make-check-and-run.sh
@@ -8,6 +8,7 @@
 cd osmo-gsm-tester
 make deps
 make check
+./contrib/jenkins-build-manuals.sh
 cd "$base"
 
 PATH="$base/osmo-gsm-tester/src:$PATH" \

-- 
To view, visit https://gerrit.osmocom.org/12213
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-gsm-tester
Gerrit-Branch: master
Gerrit-MessageType: merged
Gerrit-Change-Id: I4ebfe12a164f807b63bc897aff44db83fc0705bd
Gerrit-Change-Number: 12213
Gerrit-PatchSet: 4
Gerrit-Owner: osmith <osmith at sysmocom.de>
Gerrit-Reviewer: Jenkins Builder (1000002)
Gerrit-Reviewer: Neels Hofmeyr <nhofmeyr at sysmocom.de>
Gerrit-Reviewer: Pau Espin Pedrol <pespin at sysmocom.de>
Gerrit-Reviewer: osmith <osmith at sysmocom.de>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20181211/87a9e7a6/attachment.htm>


More information about the gerrit-log mailing list