TSK-899: now smoke testing documentation

.travis.yml

@@ -90,10 +90,11 @@ matrix:
       install: ci/change_version.sh -m .
         && ( cd web && npm install --silent )
         && ( cd web && npm run build:prod-silent )
-        && mvn -q install -T 4C -am -DskipTests -Dcheckstyle.skip -pl :taskana-rest-spring
+        && mvn -q install -T 4C -am -DskipTests -Dcheckstyle.skip -pl :taskana-rest-spring,:taskana-cdi
         && mvn -q prepare-package -pl :taskana-rest-spring
         && mvn -q install -f history -T 4C -am -DskipTests -Dmaven.javadoc.skip -Dcheckstyle.skip -pl :taskana-simplehistory-rest-spring-example
         && mvn -q install -P history.plugin -DskipTests -Dcheckstyle.skip -pl :taskana-rest-spring-example-boot
+      before_script: ci/verify_docs_jar.sh
       script: |
         mvn deploy -T 4C -P `[[ "$TRAVIS_TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]] && echo "release" || echo "snapshot"` \
         --settings ci/mvnsettings.xml -DskipTests -Dcheckstyle.skip -pl !:taskana-spring-example,!:taskana-cdi-example,\
@@ -110,3 +111,6 @@ matrix:
         space: Taskana
         on:
           all_branches: true
+      # travis_terminate is necessary since after_deploy is a job phase which can change the build result.
+      # it is not documented, so this is a little hack. see: https://docs.travis-ci.com/user/job-lifecycle/#breaking-the-build
+      after_deploy: ci/verify_docs_alive.sh || travis_terminate 1

ci/commitPoms.sh

@@ -56,7 +56,7 @@ function main() {
       echo "Branches detected: $branch"
       exit 1
     fi
-
+    set -x
     git config --global user.email $GH_EMAIL
     git config --global user.name $GH_USERNAME
 

ci/prepare_db.bat

@@ -40,12 +40,12 @@ SET PROP_FILE=%HOMEPATH%\taskanaUnitTest.properties
     SET /P CONTAINER_EXISTS=< %TEMP%\temp
     del %TEMP%\temp
 
-    IF NOT DEFINED CONAINER_RUNNING IF DEFINED CONTAINER_EXISTS (
+    IF DEFINED CONTAINER_EXISTS (
         ECHO docker start taskana-db2_10_5
         docker start taskana-db2_10_5
     )
 
-    IF NOT DEFINED CONAINER_RUNNING IF NOT DEFINED CONTAINER_EXISTS (
+    IF NOT DEFINED CONTAINER_EXISTS (
         ECHO docker run -d -p 50100:50000 --name taskana-db2_10_5 taskana/db2:10.5 -d
         docker run -d -p 50100:50000 --name taskana-db2_10_5 taskana/db2:10.5 -d
     )
@@ -73,12 +73,12 @@ SET PROP_FILE=%HOMEPATH%\taskanaUnitTest.properties
     SET /P CONTAINER_EXISTS=< %TEMP%\temp
     del %TEMP%\temp
 
-    IF NOT DEFINED CONAINER_RUNNING IF DEFINED CONTAINER_EXISTS (
+    IF DEFINED CONTAINER_EXISTS (
         ECHO docker start taskana-db2_11_1
         docker start taskana-db2_11_1
     )
 
-    IF NOT DEFINED CONAINER_RUNNING IF NOT DEFINED CONTAINER_EXISTS (
+    IF NOT DEFINED CONTAINER_EXISTS (
         ECHO docker run -d -p 50101:50000 --name taskana-db2_11_1 taskana/db2:11.1 -d
         docker run -d -p 50101:50000 --name taskana-db2_11_1 taskana/db2:11.1 -d
     )
@@ -106,12 +106,12 @@ SET PROP_FILE=%HOMEPATH%\taskanaUnitTest.properties
     SET /P CONTAINER_EXISTS=< %TEMP%\temp
     del %TEMP%\temp
 
-    IF NOT DEFINED CONAINER_RUNNING IF DEFINED CONTAINER_EXISTS (
+    IF DEFINED CONTAINER_EXISTS (
         ECHO docker start taskana-postgres_10_4
         docker start taskana-postgres_10_4
     )
 
-    IF NOT DEFINED CONAINER_RUNNING IF NOT DEFINED CONTAINER_EXISTS (
+    IF NOT DEFINED CONTAINER_EXISTS (
         ECHO docker run -d -p 50102:5432 --name taskana-postgres_10_4 -e POSTGRES_PASSWORD=postgres postgres:10.4
         docker run -d -p 50102:5432 --name taskana-postgres_10_4 -e POSTGRES_PASSWORD=postgres postgres:10.4
     )

ci/verify_docs_alive.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+set -e # fail fast
+set -x
+BASE_URL=https://taskana.mybluemix.net/taskana
+
+test 200 -eq $(curl -sw %{http_code} -o /dev/null "$BASE_URL/docs/rest/rest-api.html")
+test -z "$(curl -s $BASE_URL/docs/rest/rest-api.html | grep 'Unresolved directive.*adoc')"
+for module in taskana-core taskana-cdi taskana-spring; do
+  test 200 -eq $(curl -sw %{http_code} -o /dev/null "$BASE_URL/docs/java/$module/pro/taskana/package-summary.html")
+done

ci/verify_docs_jar.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -e #fail fast
+
+function verifyDocs() {
+  test -d "$1"
+  test $(find "$1" | wc -l) -eq $(grep "$2" <<<"$JAR_CONTENT" | wc -l)
+}
+
+REL=$(dirname "$0")
+JAR_FILE_LOCATION="$REL/../rest/taskana-rest-spring-example-boot/target/taskana-rest-spring-example-boot.jar"
+set -x
+test -e "$JAR_FILE_LOCATION"
+set +x
+JAR_CONTENT=$(jar tf "$JAR_FILE_LOCATION")
+set -x
+
+verifyDocs "$REL/../lib/taskana-core/target/apidocs" "/static/docs/java/taskana-core"
+verifyDocs "$REL/../lib/taskana-cdi/target/apidocs" "/static/docs/java/taskana-cdi"
+verifyDocs "$REL/../lib/taskana-spring/target/apidocs" "/static/docs/java/taskana-spring"
+set +x
+echo "the jar file '$JAR_FILE_LOCATION' contains all javadoc"