diff --git a/geode-management/src/test/script/update-management-wiki.sh b/geode-management/src/test/script/update-management-wiki.sh new file mode 100755 index 000000000000..23e33c0cbd7a --- /dev/null +++ b/geode-management/src/test/script/update-management-wiki.sh @@ -0,0 +1,162 @@ +#! /usr/bin/env bash +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +URI_VERSION=/experimental + +set -e + +usage() { + echo "Usage: update-management-wiki.sh -u apache_username:apache_password" + echo ' -u Your id.apache.org creds in the form user:pass. You can also set $APACHE_CREDS' + exit 1 +} + +while getopts ":u:" opt; do + case ${opt} in + u ) + APACHE_CREDS=$OPTARG + ;; + \? ) + usage + ;; + esac +done + +if [[ "${APACHE_CREDS}" == "" ]] ; then + usage +fi + +if [[ "${APACHE_CREDS}" =~ : ]]; then + true +else + echo "Please specify creds in the form user:pass" + exit 1 +fi + +BRANCH=$(git rev-parse --abbrev-ref HEAD) +if [[ ${BRANCH} != "develop" ]] && [[ ${BRANCH} != "master" ]] ; then + echo "Please git checkout develop or git checkout master before running this script" + exit 1 +fi + +MASTER_PAGE_ID=115511910 +DEVELOP_PAGE_ID=132322415 +[[ "${BRANCH}" == "master" ]] && PAGE_ID=$MASTER_PAGE_ID || PAGE_ID=$DEVELOP_PAGE_ID + +echo "" +echo "============================================================" +echo "Building" +echo "============================================================" +set -x +(cd ${0%/*}/../../../.. && ./gradlew build installDist -x test -x javadoc -x rat -x pmdMain -x pmdTest) +set +x + +GEODE=$(cd ${0%/*}/../../../../geode-assembly/build/install/apache-geode; pwd) + +if [ -x "$GEODE/bin/gfsh" ] ; then + true +else + echo "gfsh not found" + exit 1 +fi + +echo "" +echo "============================================================" +echo "Checking that swagger-codegen is installed" +echo "============================================================" +brew install swagger-codegen || true +brew upgrade swagger-codegen || true + +echo "" +echo "============================================================" +echo "Starting up a locator to access swagger" +echo "============================================================" +set -x +ps -ef | grep swagger-locator | grep java | awk '{print $2}' | xargs kill -9 +[[ "${BRANCH}" == "master" ]] && GEODE_VERSION=$($GEODE/bin/gfsh version) || GEODE_VERSION=develop +$GEODE/bin/gfsh "start locator --name=swagger-locator" +set +x + +echo "" +echo "============================================================" +echo "Generating docs" +echo "============================================================" +set -x +swagger-codegen generate -i http://localhost:7070/management${URI_VERSION}/api-docs -l html -o static +set +x + +echo "" +echo "============================================================" +echo "Uploading to wiki" +echo "============================================================" +# step 1a: strip out body/header/html envelope +# step 1b: add line breaks in code examples, since otherwise they inexplicably get lost in the upload +# step 1c: escape quotes and newlines +# step 1d: future: do any search-and-replaces to make it prettier here, such as to make up for lost css +VALUE=$(cat static/index.html | awk ' + /<\/body>/ {inbody=0} + inbody==1 {print} + // {inbody=1} +' | awk ' + /
/ {incode=1}
+  incode==1  {print $0"
"}
+  incode!=1  {print}
+  /<\/code>/ {incode=0}
+' | sed 's/"/\\"/g')
+# step 2: get the current page version and ADD 1
+PAGE_VERSION=$(curl -s -u $APACHE_CREDS https://cwiki.apache.org/confluence/rest/api/content/${PAGE_ID} | jq .version.number)
+NEW_PAGE_VERSION=$(( PAGE_VERSION + 1 ))
+# step 3: insert as value into json update message
+TITLE="${GEODE_VERSION} Management REST API - ${URI_VERSION#/}"
+cat << EOF > body.json
+{
+  "id": "${PAGE_ID}",
+  "type": "page",
+  "title": "${TITLE}",
+  "space": {
+    "key": "GEODE"
+  },
+  "body": {
+    "storage": {
+      "value": "${VALUE}",
+      "representation": "storage"
+    }
+  },
+  "version": {
+    "number": ${NEW_PAGE_VERSION},
+    "minorEdit": true,
+    "message": "automatically generated from ${GEODE_VERSION} by update-management-wiki.sh"
+  }
+}
+EOF
+#step 4: upload to the wiki
+set -x
+curl -u $APACHE_CREDS -X PUT -H 'Content-Type: application/json' -d @body.json https://cwiki.apache.org/confluence/rest/api/content/${PAGE_ID}
+set +x
+
+echo ""
+echo "============================================================"
+echo "Cleaning up"
+echo "============================================================"
+set -x
+ps -ef | grep swagger-locator | grep java | awk '{print $2}' | xargs kill -9
+rm -Rf swagger-locator
+rm -Rf static
+rm body.json
+set +x
+
+# open your web browser to the newly-updated page
+open "https://cwiki.apache.org/confluence/display/pages/viewpage.action?pageId=${PAGE_ID}"
\ No newline at end of file