SOLR-10568: Add Jenkins script to download and locally install the software needed to build the Solr ref guide, and then build it.

dev-tools/scripts/jenkins.build.ref.guide.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+
+# This shell script will download the software required to build the ref
+# guide using RVM (Ruby Version Manager), and then run the following
+# under solr/solr-ref-guide: "ant clean build-site build-pdf".
+#
+# The following will be downloaded and installed into $HOME/.rvm/:
+# RVM, Ruby, and Ruby gems jekyll, jekyll-asciidoc, and pygments.rb.
+#
+# The script expects to be run in the top-level project directory.
+#
+# 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.
+
+set -x                                   # Echo commands to the console
+set -e                                   # Fail the script if any command fails
+
+RVM_PATH=$HOME/.rvm
+RUBY_VERSION=ruby-2.3.3
+GEMSET=solr-refguide-gemset
+
+# Install the "stable" RVM release to ~/.rvm/, and don't mess with .bash_profile etc.
+\curl -sSL https://get.rvm.io | bash -s -- --ignore-dotfiles stable
+
+set +x                                   # Temporarily disable command echoing to reduce clutter
+
+function echoRun() {
+    local cmd="$1"
+    echo "Running '$cmd'"
+    $cmd
+}
+
+echoRun "source $RVM_PATH/scripts/rvm"   # Load RVM into a shell session *as a Bash function*
+echoRun "rvm autolibs disable"           # Enable single-user mode
+echoRun "rvm install $RUBY_VERSION"      # Install Ruby 
+echoRun "rvm gemset create $GEMSET"      # Create this project's gemset
+echoRun "rvm $RUBY_VERSION@$GEMSET"      # Activate this project's gemset
+
+# Install gems in the gemset.  Param --force disables dependency conflict detection.
+echoRun "gem install --force --version 3.5.0 jekyll"
+echoRun "gem install --force --version 2.1.0 jekyll-asciidoc"
+echoRun "gem install --force --version 1.1.2 pygments.rb"
+
+cd solr/solr-ref-guide
+
+set -x                                   # Re-enable command echoing
+ant clean build-site build-pdf