build/run-tests.sh

   1 #!/bin/bash
   2 # Copyright (C) The Arvados Authors. All rights reserved.
   3 #
   4 # SPDX-License-Identifier: AGPL-3.0
   5
   6 . `dirname "$(readlink -f "$0")"`/libcloud-pin.sh
   7
   8 COLUMNS=80
   9 . `dirname "$(readlink -f "$0")"`/run-library.sh
  10
  11 read -rd "\000" helpmessage <<EOF
  12 $(basename $0): Install and test Arvados components.
  13
  14 Exit non-zero if any tests fail.
  15
  16 Syntax:
  17         $(basename $0) WORKSPACE=/path/to/arvados [options]
  18
  19 Options:
  20
  21 --skip FOO     Do not test the FOO component.
  22 --skip sanity  Skip initial dev environment sanity checks.
  23 --skip install Do not run any install steps. Just run tests.
  24                You should provide GOPATH, GEMHOME, and VENVDIR options
  25                from a previous invocation if you use this option.
  26 --only FOO     Do not test anything except the FOO component.
  27 --temp DIR     Install components and dependencies under DIR instead of
  28                making a new temporary directory. Implies --leave-temp.
  29 --leave-temp   Do not remove GOPATH, virtualenv, and other temp dirs at exit.
  30                Instead, show the path to give as --temp to reuse them in
  31                subsequent invocations.
  32 --repeat N     Repeat each install/test step until it succeeds N times.
  33 --retry        Prompt to retry if an install or test suite fails.
  34 --only-install Run specific install step
  35 --short        Skip (or scale down) some slow tests.
  36 --interactive  Set up, then prompt for test/install steps to perform.
  37 WORKSPACE=path Arvados source tree to test.
  38 CONFIGSRC=path Dir with config.yml file containing PostgreSQL section for use by tests.
  39 services/api_test="TEST=test/functional/arvados/v1/collections_controller_test.rb"
  40                Restrict apiserver tests to the given file
  41 sdk/python_test="--test-suite tests.test_keep_locator"
  42                Restrict Python SDK tests to the given class
  43 apps/workbench_test="TEST=test/integration/pipeline_instances_test.rb"
  44                Restrict Workbench tests to the given file
  45 services/arv-git-httpd_test="-check.vv"
  46                Show all log messages, even when tests pass (also works
  47                with services/keepstore_test etc.)
  48 ARVADOS_DEBUG=1
  49                Print more debug messages
  50 envvar=value   Set \$envvar to value. Primarily useful for WORKSPACE,
  51                *_test, and other examples shown above.
  52
  53 Assuming "--skip install" is not given, all components are installed
  54 into \$GOPATH, \$VENDIR, and \$GEMHOME before running any tests. Many
  55 test suites depend on other components being installed, and installing
  56 everything tends to be quicker than debugging dependencies.
  57
  58 As a special concession to the current CI server config, CONFIGSRC
  59 defaults to $HOME/arvados-api-server if that directory exists.
  60
  61 More information and background:
  62
  63 https://arvados.org/projects/arvados/wiki/Running_tests
  64
  65 Available tests:
  66
  67 apps/workbench (*)
  68 apps/workbench_units (*)
  69 apps/workbench_functionals (*)
  70 apps/workbench_integration (*)
  71 apps/workbench_benchmark
  72 apps/workbench_profile
  73 cmd/arvados-client
  74 cmd/arvados-server
  75 doc
  76 lib/cli
  77 lib/cmd
  78 lib/controller
  79 lib/controller/federation
  80 lib/controller/railsproxy
  81 lib/controller/router
  82 lib/controller/rpc
  83 lib/crunchstat
  84 lib/crunch-run
  85 lib/cloud
  86 lib/cloud/azure
  87 lib/cloud/cloudtest
  88 lib/dispatchcloud
  89 lib/dispatchcloud/container
  90 lib/dispatchcloud/scheduler
  91 lib/dispatchcloud/ssh_executor
  92 lib/dispatchcloud/worker
  93 lib/mount
  94 lib/pam
  95 lib/service
  96 services/api
  97 services/arv-git-httpd
  98 services/crunchstat
  99 services/dockercleaner
 100 services/fuse
 101 services/fuse:py3
 102 services/health
 103 services/keep-web
 104 services/keepproxy
 105 services/keepstore
 106 services/keep-balance
 107 services/login-sync
 108 services/crunch-dispatch-local
 109 services/crunch-dispatch-slurm
 110 services/ws
 111 sdk/cli
 112 sdk/python
 113 sdk/python:py3
 114 sdk/ruby
 115 sdk/go/arvados
 116 sdk/go/arvadosclient
 117 sdk/go/auth
 118 sdk/go/dispatch
 119 sdk/go/keepclient
 120 sdk/go/health
 121 sdk/go/httpserver
 122 sdk/go/manifest
 123 sdk/go/blockdigest
 124 sdk/go/asyncbuf
 125 sdk/go/stats
 126 sdk/go/crunchrunner
 127 sdk/cwl:py3
 128 sdk/R
 129 sdk/java-v2
 130 tools/sync-groups
 131 tools/crunchstat-summary
 132 tools/crunchstat-summary:py3
 133 tools/keep-exercise
 134 tools/keep-rsync
 135 tools/keep-block-check
 136
 137 (*) apps/workbench is shorthand for apps/workbench_units +
 138     apps/workbench_functionals + apps/workbench_integration
 139
 140 EOF
 141
 142 # First make sure to remove any ARVADOS_ variables from the calling
 143 # environment that could interfere with the tests.
 144 unset $(env | cut -d= -f1 | grep \^ARVADOS_)
 145
 146 # Reset other variables that could affect our [tests'] behavior by
 147 # accident.
 148 GITDIR=
 149 GOPATH=
 150 VENVDIR=
 151 VENV3DIR=
 152 PYTHONPATH=
 153 GEMHOME=
 154 PERLINSTALLBASE=
 155 R_LIBS=
 156 export LANG=en_US.UTF-8
 157
 158 short=
 159 only_install=
 160 temp=
 161 temp_preserve=
 162
 163 clear_temp() {
 164     if [[ -z "$temp" ]]; then
 165         # we didn't even get as far as making a temp dir
 166         :
 167     elif [[ -z "$temp_preserve" ]]; then
 168         rm -rf "$temp"
 169     else
 170         echo "Leaving behind temp dirs in $temp"
 171     fi
 172 }
 173
 174 fatal() {
 175     clear_temp
 176     echo >&2 "Fatal: $* (encountered in ${FUNCNAME[1]} at ${BASH_SOURCE[1]} line ${BASH_LINENO[0]})"
 177     exit 1
 178 }
 179
 180 exit_cleanly() {
 181     trap - INT
 182     if which create-plot-data-from-log.sh >/dev/null; then
 183         create-plot-data-from-log.sh $BUILD_NUMBER "$WORKSPACE/apps/workbench/log/test.log" "$WORKSPACE/apps/workbench/log/"
 184     fi
 185     rotate_logfile "$WORKSPACE/apps/workbench/log/" "test.log"
 186     stop_services
 187     rotate_logfile "$WORKSPACE/services/api/log/" "test.log"
 188     report_outcomes
 189     clear_temp
 190     exit ${#failures}
 191 }
 192
 193 sanity_checks() {
 194     [[ -n "${skip[sanity]}" ]] && return 0
 195     ( [[ -n "$WORKSPACE" ]] && [[ -d "$WORKSPACE/services" ]] ) \
 196         || fatal "WORKSPACE environment variable not set to a source directory (see: $0 --help)"
 197     [[ -z "$CONFIGSRC" ]] || [[ -s "$CONFIGSRC/config.yml" ]] \
 198         || fatal "CONFIGSRC is $CONFIGSRC but '$CONFIGSRC/config.yml' is empty or not found (see: $0 --help)"
 199     echo Checking dependencies:
 200     echo "locale: ${LANG}"
 201     [[ "$(locale charmap)" = "UTF-8" ]] \
 202         || fatal "Locale '${LANG}' is broken/missing. Try: echo ${LANG} | sudo tee -a /etc/locale.gen && sudo locale-gen"
 203     echo -n 'ruby: '
 204     ruby -v \
 205         || fatal "No ruby. Install >=2.1.9 (using rbenv, rvm, or source)"
 206     echo -n 'go: '
 207     go version \
 208         || fatal "No go binary. See http://golang.org/doc/install"
 209     [[ $(go version) =~ go1.([0-9]+) ]] && [[ ${BASH_REMATCH[1]} -ge 12 ]] \
 210         || fatal "Go >= 1.12 required. See http://golang.org/doc/install"
 211     echo -n 'gcc: '
 212     gcc --version | egrep ^gcc \
 213         || fatal "No gcc. Try: apt-get install build-essential"
 214     echo -n 'fuse.h: '
 215     find /usr/include -path '*fuse/fuse.h' | egrep --max-count=1 . \
 216         || fatal "No fuse/fuse.h. Try: apt-get install libfuse-dev"
 217     echo -n 'gnutls.h: '
 218     find /usr/include -path '*gnutls/gnutls.h' | egrep --max-count=1 . \
 219         || fatal "No gnutls/gnutls.h. Try: apt-get install libgnutls28-dev"
 220     echo -n 'virtualenv: '
 221     python3 -m venv -h | egrep --max-count=1 . \
 222         || fatal "No virtualenv. Try: apt-get install python3-venv"
 223     echo -n 'Python3 pyconfig.h: '
 224     find /usr/include -path '*/python3*/pyconfig.h' | egrep --max-count=1 . \
 225         || fatal "No Python3 pyconfig.h. Try: apt-get install python3-dev"
 226     which netstat \
 227         || fatal "No netstat. Try: apt-get install net-tools"
 228     echo -n 'nginx: '
 229     PATH="$PATH:/sbin:/usr/sbin:/usr/local/sbin" nginx -v \
 230         || fatal "No nginx. Try: apt-get install nginx"
 231     echo -n 'perl: '
 232     perl -v | grep version \
 233         || fatal "No perl. Try: apt-get install perl"
 234     for mod in ExtUtils::MakeMaker JSON LWP Net::SSL; do
 235         echo -n "perl $mod: "
 236         perl -e "use $mod; print \"\$$mod::VERSION\\n\"" \
 237             || fatal "No $mod. Try: apt-get install perl-modules libcrypt-ssleay-perl libjson-perl libwww-perl"
 238     done
 239     echo -n 'gitolite: '
 240     which gitolite \
 241         || fatal "No gitolite. Try: apt-get install gitolite3"
 242     echo -n 'npm: '
 243     npm --version \
 244         || fatal "No npm. Try: wget -O- https://nodejs.org/dist/v6.11.2/node-v6.11.2-linux-x64.tar.xz | sudo tar -C /usr/local -xJf - && sudo ln -s ../node-v6.11.2-linux-x64/bin/{node,npm} /usr/local/bin/"
 245     echo -n 'cadaver: '
 246     cadaver --version | grep -w cadaver \
 247           || fatal "No cadaver. Try: apt-get install cadaver"
 248     echo -n 'libattr1 xattr.h: '
 249     find /usr/include -path '*/attr/xattr.h' | egrep --max-count=1 . \
 250         || fatal "No libattr1 xattr.h. Try: apt-get install libattr1-dev"
 251     echo -n 'libcurl curl.h: '
 252     find /usr/include -path '*/curl/curl.h' | egrep --max-count=1 . \
 253         || fatal "No libcurl curl.h. Try: apt-get install libcurl4-gnutls-dev"
 254     echo -n 'libpq libpq-fe.h: '
 255     find /usr/include -path '*/postgresql/libpq-fe.h' | egrep --max-count=1 . \
 256         || fatal "No libpq libpq-fe.h. Try: apt-get install libpq-dev"
 257     echo -n 'libpam pam_appl.h: '
 258     find /usr/include -path '*/security/pam_appl.h' | egrep --max-count=1 . \
 259         || fatal "No libpam pam_appl.h. Try: apt-get install libpam0g-dev"
 260     echo -n 'postgresql: '
 261     psql --version || fatal "No postgresql. Try: apt-get install postgresql postgresql-client-common"
 262     echo -n 'phantomjs: '
 263     phantomjs --version || fatal "No phantomjs. Try: apt-get install phantomjs"
 264     echo -n 'xvfb: '
 265     which Xvfb || fatal "No xvfb. Try: apt-get install xvfb"
 266     echo -n 'graphviz: '
 267     dot -V || fatal "No graphviz. Try: apt-get install graphviz"
 268     echo -n 'geckodriver: '
 269     geckodriver --version | grep ^geckodriver || echo "No geckodriver. Try: wget -O- https://github.com/mozilla/geckodriver/releases/download/v0.23.0/geckodriver-v0.23.0-linux64.tar.gz | sudo tar -C /usr/local/bin -xzf - geckodriver"
 270
 271     if [[ "$NEED_SDK_R" = true ]]; then
 272       # R SDK stuff
 273       echo -n 'R: '
 274       which Rscript || fatal "No Rscript. Try: apt-get install r-base"
 275       echo -n 'testthat: '
 276       Rscript -e "library('testthat')" || fatal "No testthat. Try: apt-get install r-cran-testthat"
 277       # needed for roxygen2, needed for devtools, needed for R sdk
 278       pkg-config --exists libxml-2.0 || fatal "No libxml2. Try: apt-get install libxml2-dev"
 279       # needed for pkgdown, builds R SDK doc pages
 280       which pandoc || fatal "No pandoc. Try: apt-get install pandoc"
 281     fi
 282     echo 'procs with /dev/fuse open:'
 283     find /proc/*/fd -lname /dev/fuse 2>/dev/null | cut -d/ -f3 | xargs --no-run-if-empty ps -lywww
 284     echo 'grep fuse /proc/self/mountinfo:'
 285     grep fuse /proc/self/mountinfo
 286 }
 287
 288 rotate_logfile() {
 289   # i.e.  rotate_logfile "$WORKSPACE/apps/workbench/log/" "test.log"
 290   # $BUILD_NUMBER is set by Jenkins if this script is being called as part of a Jenkins run
 291   if [[ -f "$1/$2" ]]; then
 292     THEDATE=`date +%Y%m%d%H%M%S`
 293     mv "$1/$2" "$1/$THEDATE-$BUILD_NUMBER-$2"
 294     gzip "$1/$THEDATE-$BUILD_NUMBER-$2"
 295   fi
 296 }
 297
 298 declare -a failures
 299 declare -A skip
 300 declare -A only
 301 declare -A testargs
 302 skip[apps/workbench_profile]=1
 303
 304 while [[ -n "$1" ]]
 305 do
 306     arg="$1"; shift
 307     case "$arg" in
 308         --help)
 309             echo >&2 "$helpmessage"
 310             echo >&2
 311             exit 1
 312             ;;
 313         --skip)
 314             skip[$1]=1; shift
 315             ;;
 316         --only)
 317             only[$1]=1; skip[$1]=""; shift
 318             ;;
 319         --short)
 320             short=1
 321             ;;
 322         --interactive)
 323             interactive=1
 324             ;;
 325         --skip-install)
 326             skip[install]=1
 327             ;;
 328         --only-install)
 329             only_install="$1"; shift
 330             ;;
 331         --temp)
 332             temp="$1"; shift
 333             temp_preserve=1
 334             ;;
 335         --leave-temp)
 336             temp_preserve=1
 337             ;;
 338         --repeat)
 339             repeat=$((${1}+0)); shift
 340             ;;
 341         --retry)
 342             retry=1
 343             ;;
 344         *_test=*)
 345             suite="${arg%%_test=*}"
 346             args="${arg#*=}"
 347             testargs["$suite"]="$args"
 348             ;;
 349         *=*)
 350             eval export $(echo $arg | cut -d= -f1)=\"$(echo $arg | cut -d= -f2-)\"
 351             ;;
 352         *)
 353             echo >&2 "$0: Unrecognized option: '$arg'. Try: $0 --help"
 354             exit 1
 355             ;;
 356     esac
 357 done
 358
 359 # R SDK installation is very slow (~360s in a clean environment) and only
 360 # required when testing it. Skip that step if it is not needed.
 361 NEED_SDK_R=true
 362
 363 if [[ ${#only[@]} -ne 0 ]] &&
 364    [[ -z "${only['sdk/R']}" && -z "${only['doc']}" ]]; then
 365   NEED_SDK_R=false
 366 fi
 367
 368 if [[ ${skip["sdk/R"]} == 1 && ${skip["doc"]} == 1 ]]; then
 369   NEED_SDK_R=false
 370 fi
 371
 372 if [[ $NEED_SDK_R == false ]]; then
 373         echo "R SDK not needed, it will not be installed."
 374 fi
 375
 376 checkpidfile() {
 377     svc="$1"
 378     pid="$(cat "$WORKSPACE/tmp/${svc}.pid")"
 379     if [[ -z "$pid" ]] || ! kill -0 "$pid"; then
 380         tail $WORKSPACE/tmp/${1}*.log
 381         echo "${svc} pid ${pid} not running"
 382         return 1
 383     fi
 384     echo "${svc} pid ${pid} ok"
 385 }
 386
 387 checkhealth() {
 388     svc="$1"
 389     base=$("${VENV3DIR}/bin/python3" -c "import yaml; print(list(yaml.safe_load(open('$ARVADOS_CONFIG','r'))['Clusters']['zzzzz']['Services']['$1']['InternalURLs'].keys())[0])")
 390     url="$base/_health/ping"
 391     if ! curl -Ss -H "Authorization: Bearer e687950a23c3a9bceec28c6223a06c79" "${url}" | tee -a /dev/stderr | grep '"OK"'; then
 392         echo "${url} failed"
 393         return 1
 394     fi
 395 }
 396
 397 checkdiscoverydoc() {
 398     dd="https://${1}/discovery/v1/apis/arvados/v1/rest"
 399     if ! (set -o pipefail; curl -fsk "$dd" | grep -q ^{ ); then
 400         echo >&2 "ERROR: could not retrieve discovery doc from RailsAPI at $dd"
 401         tail -v $WORKSPACE/tmp/railsapi.log
 402         return 1
 403     fi
 404     echo "${dd} ok"
 405 }
 406
 407 start_services() {
 408     if [[ -n "$ARVADOS_TEST_API_HOST" ]]; then
 409         return 0
 410     fi
 411     . "$VENV3DIR/bin/activate"
 412     echo 'Starting API, controller, keepproxy, keep-web, arv-git-httpd, ws, and nginx ssl proxy...'
 413     if [[ ! -d "$WORKSPACE/services/api/log" ]]; then
 414         mkdir -p "$WORKSPACE/services/api/log"
 415     fi
 416     # Remove empty api.pid file if it exists
 417     if [[ -f "$WORKSPACE/tmp/api.pid" && ! -s "$WORKSPACE/tmp/api.pid" ]]; then
 418         rm -f "$WORKSPACE/tmp/api.pid"
 419     fi
 420     all_services_stopped=
 421     fail=1
 422
 423     cd "$WORKSPACE" \
 424         && eval $(python3 sdk/python/tests/run_test_server.py start --auth admin) \
 425         && export ARVADOS_TEST_API_HOST="$ARVADOS_API_HOST" \
 426         && export ARVADOS_TEST_API_INSTALLED="$$" \
 427         && checkpidfile api \
 428         && checkdiscoverydoc $ARVADOS_API_HOST \
 429         && eval $(python3 sdk/python/tests/run_test_server.py start_nginx) \
 430         && checkpidfile nginx \
 431         && python3 sdk/python/tests/run_test_server.py start_controller \
 432         && checkpidfile controller \
 433         && checkhealth Controller \
 434         && checkdiscoverydoc $ARVADOS_API_HOST \
 435         && python3 sdk/python/tests/run_test_server.py start_keep_proxy \
 436         && checkpidfile keepproxy \
 437         && python3 sdk/python/tests/run_test_server.py start_keep-web \
 438         && checkpidfile keep-web \
 439         && checkhealth WebDAV \
 440         && python3 sdk/python/tests/run_test_server.py start_arv-git-httpd \
 441         && checkpidfile arv-git-httpd \
 442         && checkhealth GitHTTP \
 443         && python3 sdk/python/tests/run_test_server.py start_ws \
 444         && checkpidfile ws \
 445         && export ARVADOS_TEST_PROXY_SERVICES=1 \
 446         && (env | egrep ^ARVADOS) \
 447         && fail=0
 448     deactivate
 449     if [[ $fail != 0 ]]; then
 450         unset ARVADOS_TEST_API_HOST
 451     fi
 452     return $fail
 453 }
 454
 455 stop_services() {
 456     if [[ -n "$all_services_stopped" ]]; then
 457         return
 458     fi
 459     unset ARVADOS_TEST_API_HOST ARVADOS_TEST_PROXY_SERVICES
 460     . "$VENV3DIR/bin/activate" || return
 461     cd "$WORKSPACE" \
 462         && python3 sdk/python/tests/run_test_server.py stop_nginx \
 463         && python3 sdk/python/tests/run_test_server.py stop_arv-git-httpd \
 464         && python3 sdk/python/tests/run_test_server.py stop_ws \
 465         && python3 sdk/python/tests/run_test_server.py stop_keep-web \
 466         && python3 sdk/python/tests/run_test_server.py stop_keep_proxy \
 467         && python3 sdk/python/tests/run_test_server.py stop_controller \
 468         && python3 sdk/python/tests/run_test_server.py stop \
 469         && all_services_stopped=1
 470     deactivate
 471     unset ARVADOS_CONFIG
 472 }
 473
 474 interrupt() {
 475     failures+=("($(basename $0) interrupted)")
 476     exit_cleanly
 477 }
 478 trap interrupt INT
 479
 480 setup_ruby_environment() {
 481     if [[ -s "$HOME/.rvm/scripts/rvm" ]] ; then
 482         source "$HOME/.rvm/scripts/rvm"
 483         using_rvm=true
 484     elif [[ -s "/usr/local/rvm/scripts/rvm" ]] ; then
 485         source "/usr/local/rvm/scripts/rvm"
 486         using_rvm=true
 487     else
 488         using_rvm=false
 489     fi
 490
 491     if [[ "$using_rvm" == true ]]; then
 492         # If rvm is in use, we can't just put separate "dependencies"
 493         # and "gems-under-test" paths to GEM_PATH: passenger resets
 494         # the environment to the "current gemset", which would lose
 495         # our GEM_PATH and prevent our test suites from running ruby
 496         # programs (for example, the Workbench test suite could not
 497         # boot an API server or run arv). Instead, we have to make an
 498         # rvm gemset and use it for everything.
 499
 500         [[ `type rvm | head -n1` == "rvm is a function" ]] \
 501             || fatal 'rvm check'
 502
 503         # Put rvm's favorite path back in first place (overriding
 504         # virtualenv, which just put itself there). Ignore rvm's
 505         # complaint about not being in first place already.
 506         rvm use @default 2>/dev/null
 507
 508         # Create (if needed) and switch to an @arvados-tests-* gemset,
 509         # salting the gemset name so it doesn't interfere with
 510         # concurrent builds in other workspaces. Leave the choice of
 511         # ruby to the caller.
 512         gemset="arvados-tests-$(echo -n "${WORKSPACE}" | md5sum | head -c16)"
 513         rvm use "@${gemset}" --create \
 514             || fatal 'rvm gemset setup'
 515
 516         rvm env
 517         (bundle version | grep -q 2.0.2) || gem install bundler -v 2.0.2
 518         bundle="$(which bundle)"
 519         echo "$bundle"
 520         "$bundle" version | grep 2.0.2 || fatal 'install bundler'
 521     else
 522         # When our "bundle install"s need to install new gems to
 523         # satisfy dependencies, we want them to go where "gem install
 524         # --user-install" would put them. (However, if the caller has
 525         # already set GEM_HOME, we assume that's where dependencies
 526         # should be installed, and we should leave it alone.)
 527
 528         if [ -z "$GEM_HOME" ]; then
 529             user_gempath="$(gem env gempath)"
 530             export GEM_HOME="${user_gempath%%:*}"
 531         fi
 532         PATH="$(gem env gemdir)/bin:$PATH"
 533
 534         # When we build and install our own gems, we install them in our
 535         # $GEMHOME tmpdir, and we want them to be at the front of GEM_PATH and
 536         # PATH so integration tests prefer them over other versions that
 537         # happen to be installed in $user_gempath, system dirs, etc.
 538
 539         tmpdir_gem_home="$(env - PATH="$PATH" HOME="$GEMHOME" gem env gempath | cut -f1 -d:)"
 540         PATH="$tmpdir_gem_home/bin:$PATH"
 541         export GEM_PATH="$tmpdir_gem_home"
 542
 543         echo "Will install dependencies to $(gem env gemdir)"
 544         echo "Will install arvados gems to $tmpdir_gem_home"
 545         echo "Gem search path is GEM_PATH=$GEM_PATH"
 546         bundle="$(gem env gempath | cut -f1 -d:)/bin/bundle"
 547         (
 548             export HOME=$GEMHOME
 549             bundlers="$(gem list --details bundler)"
 550             versions=(1.11.0 1.17.3 2.0.2)
 551             for v in ${versions[@]}; do
 552                 if ! echo "$bundlers" | fgrep -q "($v)"; then
 553                     gem install --user $(for v in ${versions[@]}; do echo bundler:${v}; done)
 554                     break
 555                 fi
 556             done
 557             "$bundle" version | tee /dev/stderr | grep -q 'version 2'
 558         ) #|| fatal 'install bundler' ## This is needed for now.
 559     fi
 560 }
 561
 562 with_test_gemset() {
 563     if [[ "$using_rvm" == true ]]; then
 564         "$@"
 565     else
 566         GEM_HOME="$tmpdir_gem_home" GEM_PATH="$tmpdir_gem_home" "$@"
 567     fi
 568 }
 569
 570 gem_uninstall_if_exists() {
 571     if gem list "$1\$" | egrep '^\w'; then
 572         gem uninstall --force --all --executables "$1"
 573     fi
 574 }
 575
 576 setup_virtualenv() {
 577     local venvdest="$1"; shift
 578     if ! [[ -e "$venvdest/bin/activate" ]] || ! [[ -e "$venvdest/bin/pip3" ]]; then
 579         python3 -m venv "$@" "$venvdest" || fatal "virtualenv $venvdest failed"
 580     elif [[ -n "$short" ]]; then
 581         return
 582     fi
 583     "$venvdest/bin/pip3" install --no-cache-dir 'setuptools>=18.5' 'pip>=7'
 584 }
 585
 586 initialize() {
 587     # If dependencies like ruby, go, etc. are installed in
 588     # /var/lib/arvados -- presumably by "arvados-server install" --
 589     # then we want to use those versions, instead of whatever happens
 590     # to be installed in /usr.
 591     PATH="/var/lib/arvados/bin:${PATH}"
 592     sanity_checks
 593
 594     echo "WORKSPACE=$WORKSPACE"
 595
 596     # Clean up .pyc files that may exist in the workspace
 597     cd "$WORKSPACE"
 598     find -name '*.pyc' -delete
 599
 600     if [[ -z "$temp" ]]; then
 601         temp="$(mktemp -d)"
 602     fi
 603
 604     # Set up temporary install dirs (unless existing dirs were supplied)
 605     for tmpdir in VENV3DIR GOPATH GEMHOME PERLINSTALLBASE R_LIBS
 606     do
 607         if [[ -z "${!tmpdir}" ]]; then
 608             eval "$tmpdir"="$temp/$tmpdir"
 609         fi
 610         if ! [[ -d "${!tmpdir}" ]]; then
 611             mkdir "${!tmpdir}" || fatal "can't create ${!tmpdir} (does $temp exist?)"
 612         fi
 613     done
 614
 615     rm -vf "${WORKSPACE}/tmp/*.log"
 616
 617     export PERLINSTALLBASE
 618     export PERL5LIB="$PERLINSTALLBASE/lib/perl5${PERL5LIB:+:$PERL5LIB}"
 619
 620     export R_LIBS
 621
 622     export GOPATH
 623     # Make sure our compiled binaries under test override anything
 624     # else that might be in the environment.
 625     export PATH=$GOPATH/bin:$PATH
 626
 627     # Jenkins config requires that glob tmp/*.log match something. Ensure
 628     # that happens even if we don't end up running services that set up
 629     # logging.
 630     mkdir -p "${WORKSPACE}/tmp/" || fatal "could not mkdir ${WORKSPACE}/tmp"
 631     touch "${WORKSPACE}/tmp/controller.log" || fatal "could not touch ${WORKSPACE}/tmp/controller.log"
 632
 633     unset http_proxy https_proxy no_proxy
 634
 635     # Note: this must be the last time we change PATH, otherwise rvm will
 636     # whine a lot.
 637     setup_ruby_environment
 638
 639     echo "PATH is $PATH"
 640 }
 641
 642 install_env() {
 643     go mod download || fatal "Go deps failed"
 644     which goimports >/dev/null || go get golang.org/x/tools/cmd/goimports || fatal "Go setup failed"
 645
 646     setup_virtualenv "$VENV3DIR"
 647
 648     # Needed for run_test_server.py which is used by certain (non-Python) tests.
 649     (
 650         set -e
 651         "${VENV3DIR}/bin/pip3" install PyYAML
 652         "${VENV3DIR}/bin/pip3" install httplib2
 653         "${VENV3DIR}/bin/pip3" install future
 654         "${VENV3DIR}/bin/pip3" install google-api-python-client
 655         "${VENV3DIR}/bin/pip3" install ciso8601
 656         "${VENV3DIR}/bin/pip3" install pycurl
 657         "${VENV3DIR}/bin/pip3" install ws4py
 658         cd "$WORKSPACE/sdk/python"
 659         python3 setup.py install
 660     ) || fatal "installing PyYAML and sdk/python failed"
 661 }
 662
 663 retry() {
 664     remain="${repeat}"
 665     while :
 666     do
 667         if ${@}; then
 668             if [[ "$remain" -gt 1 ]]; then
 669                 remain=$((${remain}-1))
 670                 title "(repeating ${remain} more times)"
 671             else
 672                 break
 673             fi
 674         elif [[ "$retry" == 1 ]]; then
 675             read -p 'Try again? [Y/n] ' x
 676             if [[ "$x" != "y" ]] && [[ "$x" != "" ]]
 677             then
 678                 break
 679             fi
 680         else
 681             break
 682         fi
 683     done
 684 }
 685
 686 do_test() {
 687     case "${1}" in
 688         apps/workbench_units | apps/workbench_functionals | apps/workbench_integration)
 689             suite=apps/workbench
 690             ;;
 691         *)
 692             suite="${1}"
 693             ;;
 694     esac
 695     if [[ -n "${skip[$suite]}" || \
 696               -n "${skip[$1]}" || \
 697               (${#only[@]} -ne 0 && ${only[$suite]} -eq 0 && ${only[$1]} -eq 0) ]]; then
 698         return 0
 699     fi
 700     case "${1}" in
 701         services/api)
 702             stop_services
 703             check_arvados_config "$1"
 704             ;;
 705         gofmt | doc | lib/cli | lib/cloud/azure | lib/cloud/ec2 | lib/cloud/cloudtest | lib/cmd | lib/dispatchcloud/ssh_executor | lib/dispatchcloud/worker)
 706             check_arvados_config "$1"
 707             # don't care whether services are running
 708             ;;
 709         *)
 710             check_arvados_config "$1"
 711             if ! start_services; then
 712                 checkexit 1 "$1 tests"
 713                 title "test $1 -- failed to start services"
 714                 return 1
 715             fi
 716             ;;
 717     esac
 718     retry do_test_once ${@}
 719 }
 720
 721 go_ldflags() {
 722     version=${ARVADOS_VERSION:-$(git log -n1 --format=%H)-dev}
 723     echo "-X git.arvados.org/arvados.git/lib/cmd.version=${version} -X main.version=${version}"
 724 }
 725
 726 do_test_once() {
 727     unset result
 728
 729     title "test $1"
 730     timer_reset
 731
 732     result=
 733     if which deactivate >/dev/null; then deactivate; fi
 734     if ! . "$VENV3DIR/bin/activate"
 735     then
 736         result=1
 737     elif [[ "$2" == "go" ]]
 738     then
 739         covername="coverage-$(echo "$1" | sed -e 's/\//_/g')"
 740         coverflags=("-covermode=count" "-coverprofile=$WORKSPACE/tmp/.$covername.tmp")
 741         # We do "go install" here to catch compilation errors
 742         # before trying "go test". Otherwise, coverage-reporting
 743         # mode makes Go show the wrong line numbers when reporting
 744         # compilation errors.
 745         go install -ldflags "$(go_ldflags)" "$WORKSPACE/$1" && \
 746             cd "$WORKSPACE/$1" && \
 747             if [[ -n "${testargs[$1]}" ]]
 748         then
 749             # "go test -check.vv giturl" doesn't work, but this
 750             # does:
 751             go test ${short:+-short} ${testargs[$1]}
 752         else
 753             # The above form gets verbose even when testargs is
 754             # empty, so use this form in such cases:
 755             go test ${short:+-short} ${coverflags[@]} "git.arvados.org/arvados.git/$1"
 756         fi
 757         result=${result:-$?}
 758         if [[ -f "$WORKSPACE/tmp/.$covername.tmp" ]]
 759         then
 760             go tool cover -html="$WORKSPACE/tmp/.$covername.tmp" -o "$WORKSPACE/tmp/$covername.html"
 761             rm "$WORKSPACE/tmp/.$covername.tmp"
 762         fi
 763         [[ $result = 0 ]] && gofmt -e -d *.go
 764     elif [[ "$2" == "pip" ]]
 765     then
 766         tries=0
 767         cd "$WORKSPACE/$1" && while :
 768         do
 769             tries=$((${tries}+1))
 770             # $3 can name a path directory for us to use, including trailing
 771             # slash; e.g., the bin/ subdirectory of a virtualenv.
 772             if [[ -e "${3}activate" ]]; then
 773                 . "${3}activate"
 774             fi
 775             python setup.py ${short:+--short-tests-only} test ${testargs[$1]}
 776             result=$?
 777             if [[ ${tries} < 3 && ${result} == 137 ]]
 778             then
 779                 printf '\n*****\n%s tests killed -- retrying\n*****\n\n' "$1"
 780                 continue
 781             else
 782                 break
 783             fi
 784         done
 785     elif [[ "$2" != "" ]]
 786     then
 787         "test_$2"
 788     else
 789         "test_$1"
 790     fi
 791     result=${result:-$?}
 792     checkexit $result "$1 tests"
 793     title "test $1 -- `timer`"
 794     return $result
 795 }
 796
 797 check_arvados_config() {
 798     if [[ "$1" = "env" ]] ; then
 799         return
 800     fi
 801     if [[ -z "$ARVADOS_CONFIG" ]] ; then
 802         # Create config file.  The run_test_server script requires PyYAML,
 803         # so virtualenv needs to be active.  Downstream steps like
 804         # workbench install which require a valid config.yml.
 805         if [[ ! -s "$VENV3DIR/bin/activate" ]] ; then
 806             install_env
 807         fi
 808         . "$VENV3DIR/bin/activate"
 809         cd "$WORKSPACE"
 810         eval $(python3 sdk/python/tests/run_test_server.py setup_config)
 811         deactivate
 812     fi
 813 }
 814
 815 do_install() {
 816     if [[ -n "${skip[install]}" || ( -n "${only_install}" && "${only_install}" != "${1}" && "${only_install}" != "${2}" ) ]]; then
 817         return 0
 818     fi
 819     check_arvados_config "$1"
 820     retry do_install_once ${@}
 821 }
 822
 823 do_install_once() {
 824     title "install $1"
 825     timer_reset
 826
 827     result=
 828     if which deactivate >/dev/null; then deactivate; fi
 829     if [[ "$1" != "env" ]] && ! . "$VENV3DIR/bin/activate"; then
 830         result=1
 831     elif [[ "$2" == "go" ]]
 832     then
 833         go install -ldflags "$(go_ldflags)" "$WORKSPACE/$1"
 834     elif [[ "$2" == "pip" ]]
 835     then
 836         # $3 can name a path directory for us to use, including trailing
 837         # slash; e.g., the bin/ subdirectory of a virtualenv.
 838
 839         # Need to change to a different directory after creating
 840         # the source dist package to avoid a pip bug.
 841         # see https://arvados.org/issues/5766 for details.
 842
 843         # Also need to install twice, because if it believes the package is
 844         # already installed, pip it won't install it.  So the first "pip
 845         # install" ensures that the dependencies are met, the second "pip
 846         # install" ensures that we've actually installed the local package
 847         # we just built.
 848         cd "$WORKSPACE/$1" \
 849             && "${3}python3" setup.py sdist rotate --keep=1 --match .tar.gz \
 850             && cd "$WORKSPACE" \
 851             && "${3}pip3" install --no-cache-dir "$WORKSPACE/$1/dist"/*.tar.gz \
 852             && "${3}pip3" install --no-cache-dir --no-deps --ignore-installed "$WORKSPACE/$1/dist"/*.tar.gz
 853     elif [[ "$2" != "" ]]
 854     then
 855         "install_$2"
 856     else
 857         "install_$1"
 858     fi
 859     result=${result:-$?}
 860     checkexit $result "$1 install"
 861     title "install $1 -- `timer`"
 862     return $result
 863 }
 864
 865 bundle_install_trylocal() {
 866     (
 867         set -e
 868         echo "(Running bundle install --local. 'could not find package' messages are OK.)"
 869         if ! "$bundle" install --local --no-deployment; then
 870             echo "(Running bundle install again, without --local.)"
 871             "$bundle" install --no-deployment
 872         fi
 873         "$bundle" package
 874     )
 875 }
 876
 877 install_doc() {
 878     cd "$WORKSPACE/doc" \
 879         && bundle_install_trylocal \
 880         && rm -rf .site
 881 }
 882
 883 install_gem() {
 884     gemname=$1
 885     srcpath=$2
 886     with_test_gemset gem_uninstall_if_exists "$gemname" \
 887         && cd "$WORKSPACE/$srcpath" \
 888         && bundle_install_trylocal \
 889         && gem build "$gemname.gemspec" \
 890         && with_test_gemset gem install --no-document $(ls -t "$gemname"-*.gem|head -n1)
 891 }
 892
 893 install_sdk/ruby() {
 894     install_gem arvados sdk/ruby
 895 }
 896
 897 install_sdk/R() {
 898   if [[ "$NEED_SDK_R" = true ]]; then
 899     cd "$WORKSPACE/sdk/R" \
 900        && Rscript --vanilla install_deps.R
 901   fi
 902 }
 903
 904 install_sdk/perl() {
 905     cd "$WORKSPACE/sdk/perl" \
 906         && perl Makefile.PL INSTALL_BASE="$PERLINSTALLBASE" \
 907         && make install INSTALLDIRS=perl
 908 }
 909
 910 install_sdk/cli() {
 911     install_gem arvados-cli sdk/cli
 912 }
 913
 914 install_services/login-sync() {
 915     install_gem arvados-login-sync services/login-sync
 916 }
 917
 918 install_services/api() {
 919     stop_services
 920     check_arvados_config "services/api"
 921     cd "$WORKSPACE/services/api" \
 922         && RAILS_ENV=test bundle_install_trylocal \
 923             || return 1
 924
 925     rm -f config/environments/test.rb
 926     cp config/environments/test.rb.example config/environments/test.rb
 927
 928     # Clear out any lingering postgresql connections to the test
 929     # database, so that we can drop it. This assumes the current user
 930     # is a postgresql superuser.
 931     cd "$WORKSPACE/services/api" \
 932         && test_database=$("${VENV3DIR}/bin/python3" -c "import yaml; print(yaml.safe_load(open('$ARVADOS_CONFIG','r'))['Clusters']['zzzzz']['PostgreSQL']['Connection']['dbname'])") \
 933         && psql "$test_database" -c "SELECT pg_terminate_backend (pg_stat_activity.pid::int) FROM pg_stat_activity WHERE pg_stat_activity.datname = '$test_database';" 2>/dev/null
 934
 935     mkdir -p "$WORKSPACE/services/api/tmp/pids"
 936
 937     cert="$WORKSPACE/services/api/tmp/self-signed"
 938     if [[ ! -e "$cert.pem" || "$(date -r "$cert.pem" +%s)" -lt 1512659226 ]]; then
 939         (
 940             dir="$WORKSPACE/services/api/tmp"
 941             set -e
 942             openssl req -newkey rsa:2048 -nodes -subj '/C=US/ST=State/L=City/CN=localhost' -out "$cert.csr" -keyout "$cert.key" </dev/null
 943             openssl x509 -req -in "$cert.csr" -signkey "$cert.key" -out "$cert.pem" -days 3650 -extfile <(printf 'subjectAltName=DNS:localhost,DNS:::1,DNS:0.0.0.0,DNS:127.0.0.1,IP:::1,IP:0.0.0.0,IP:127.0.0.1')
 944         ) || return 1
 945     fi
 946
 947     cd "$WORKSPACE/services/api" \
 948         && rm -rf tmp/git \
 949         && mkdir -p tmp/git \
 950         && cd tmp/git \
 951         && tar xf ../../test/test.git.tar \
 952         && mkdir -p internal.git \
 953         && git --git-dir internal.git init \
 954             || return 1
 955
 956     (
 957         set -e
 958         cd "$WORKSPACE/services/api"
 959         export RAILS_ENV=test
 960         if "$bundle" exec rails db:environment:set ; then
 961             "$bundle" exec rake db:drop
 962         fi
 963         "$bundle" exec rake db:setup
 964         "$bundle" exec rake db:fixtures:load
 965     ) || return 1
 966 }
 967
 968 declare -a pythonstuff
 969 pythonstuff=(
 970     sdk/python:py3
 971     sdk/cwl:py3
 972     services/dockercleaner:py3
 973     services/fuse:py3
 974     tools/crunchstat-summary:py3
 975 )
 976
 977 declare -a gostuff
 978 gostuff=($(cd "$WORKSPACE" && git grep -lw func | grep \\.go | sed -e 's/\/[^\/]*$//' | sort -u))
 979
 980 install_apps/workbench() {
 981     cd "$WORKSPACE/apps/workbench" \
 982         && mkdir -p tmp/cache \
 983         && RAILS_ENV=test bundle_install_trylocal \
 984         && RAILS_ENV=test RAILS_GROUPS=assets "$bundle" exec rake npm:install
 985 }
 986
 987 test_doc() {
 988     (
 989         set -e
 990         cd "$WORKSPACE/doc"
 991         ARVADOS_API_HOST=qr1hi.arvadosapi.com
 992         # Make sure python-epydoc is installed or the next line won't
 993         # do much good!
 994         PYTHONPATH=$WORKSPACE/sdk/python/ "$bundle" exec rake linkchecker baseurl=file://$WORKSPACE/doc/.site/ arvados_workbench_host=https://workbench.$ARVADOS_API_HOST arvados_api_host=$ARVADOS_API_HOST
 995     )
 996 }
 997
 998 test_gofmt() {
 999     cd "$WORKSPACE" || return 1
1000     dirs=$(ls -d */ | egrep -v 'vendor|tmp')
1001     [[ -z "$(gofmt -e -d $dirs | tee -a /dev/stderr)" ]]
1002 }
1003
1004 test_services/api() {
1005     rm -f "$WORKSPACE/services/api/git-commit.version"
1006     cd "$WORKSPACE/services/api" \
1007         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake test TESTOPTS=\'-v -d\' ${testargs[services/api]}
1008 }
1009
1010 test_sdk/ruby() {
1011     cd "$WORKSPACE/sdk/ruby" \
1012         && "$bundle" exec rake test TESTOPTS=-v ${testargs[sdk/ruby]}
1013 }
1014
1015 test_sdk/R() {
1016   if [[ "$NEED_SDK_R" = true ]]; then
1017     cd "$WORKSPACE/sdk/R" \
1018         && Rscript --vanilla run_test.R
1019   fi
1020 }
1021
1022 test_sdk/cli() {
1023     cd "$WORKSPACE/sdk/cli" \
1024         && mkdir -p /tmp/keep \
1025         && KEEP_LOCAL_STORE=/tmp/keep "$bundle" exec rake test TESTOPTS=-v ${testargs[sdk/cli]}
1026 }
1027
1028 test_sdk/java-v2() {
1029     cd "$WORKSPACE/sdk/java-v2" && gradle test ${testargs[sdk/java-v2]}
1030 }
1031
1032 test_services/login-sync() {
1033     cd "$WORKSPACE/services/login-sync" \
1034         && "$bundle" exec rake test TESTOPTS=-v ${testargs[services/login-sync]}
1035 }
1036
1037 test_apps/workbench_units() {
1038     local TASK="test:units"
1039     cd "$WORKSPACE/apps/workbench" \
1040         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} TESTOPTS=\'-v -d\' ${testargs[apps/workbench]} ${testargs[apps/workbench_units]}
1041 }
1042
1043 test_apps/workbench_functionals() {
1044     local TASK="test:functionals"
1045     cd "$WORKSPACE/apps/workbench" \
1046         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} TESTOPTS=\'-v -d\' ${testargs[apps/workbench]} ${testargs[apps/workbench_functionals]}
1047 }
1048
1049 test_apps/workbench_integration() {
1050     local TASK="test:integration"
1051     cd "$WORKSPACE/apps/workbench" \
1052         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} TESTOPTS=\'-v -d\' ${testargs[apps/workbench]} ${testargs[apps/workbench_integration]}
1053 }
1054
1055 test_apps/workbench_benchmark() {
1056     local TASK="test:benchmark"
1057     cd "$WORKSPACE/apps/workbench" \
1058         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} ${testargs[apps/workbench_benchmark]}
1059 }
1060
1061 test_apps/workbench_profile() {
1062     local TASK="test:profile"
1063     cd "$WORKSPACE/apps/workbench" \
1064         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} ${testargs[apps/workbench_profile]}
1065 }
1066
1067 install_deps() {
1068     # Install parts needed by test suites
1069     do_install env
1070     do_install cmd/arvados-server go
1071     do_install sdk/cli
1072     do_install sdk/perl
1073     do_install sdk/python pip "${VENV3DIR}/bin/"
1074     do_install sdk/ruby
1075     do_install services/api
1076     do_install services/arv-git-httpd go
1077     do_install services/keepproxy go
1078     do_install services/keepstore go
1079     do_install services/keep-web go
1080     do_install services/ws go
1081 }
1082
1083 install_all() {
1084     do_install env
1085     do_install doc
1086     do_install sdk/ruby
1087     do_install sdk/R
1088     do_install sdk/perl
1089     do_install sdk/cli
1090     do_install services/login-sync
1091     ## FIXME, ignore all python2
1092     for p in "${pythonstuff[@]}"
1093     do
1094         dir=${p%:py3}
1095         if [[ ${dir} = ${p} ]]; then
1096             if [[ -z ${skip[python2]} ]]; then
1097                 do_install ${dir} pip
1098             fi
1099         elif [[ -n ${PYTHON3} ]]; then
1100             if [[ -z ${skip[python3]} ]]; then
1101                 do_install ${dir} pip "$VENV3DIR/bin/"
1102             fi
1103         fi
1104     done
1105     for g in "${gostuff[@]}"
1106     do
1107         do_install "$g" go
1108     done
1109     do_install services/api
1110     do_install apps/workbench
1111 }
1112
1113 test_all() {
1114     stop_services
1115     do_test services/api
1116
1117     # Shortcut for when we're only running apiserver tests. This saves a bit of time,
1118     # because we don't need to start up the api server for subsequent tests.
1119     if [ ! -z "$only" ] && [ "$only" == "services/api" ]; then
1120         rotate_logfile "$WORKSPACE/services/api/log/" "test.log"
1121         exit_cleanly
1122     fi
1123
1124     do_test gofmt
1125     do_test doc
1126     do_test sdk/ruby
1127     do_test sdk/R
1128     do_test sdk/cli
1129     do_test services/login-sync
1130     do_test sdk/java-v2
1131     ## FIXME, ignore all python2
1132     for p in "${pythonstuff[@]}"
1133     do
1134         dir=${p%:py3}
1135         if [[ ${dir} = ${p} ]]; then
1136             if [[ -z ${skip[python2]} ]]; then
1137                 do_test ${dir} pip
1138             fi
1139         elif [[ -n ${PYTHON3} ]]; then
1140             if [[ -z ${skip[python3]} ]]; then
1141                 do_test ${dir} pip "$VENV3DIR/bin/"
1142             fi
1143         fi
1144     done
1145
1146     for g in "${gostuff[@]}"
1147     do
1148         do_test "$g" go
1149     done
1150     do_test apps/workbench_units
1151     do_test apps/workbench_functionals
1152     do_test apps/workbench_integration
1153     do_test apps/workbench_benchmark
1154     do_test apps/workbench_profile
1155 }
1156
1157 help_interactive() {
1158     echo "== Interactive commands:"
1159     echo "TARGET                 (short for 'test DIR')"
1160     echo "test TARGET"
1161     echo "10 test TARGET         (run test 10 times)"
1162     echo "test TARGET:py3        (test with python3)"
1163     echo "test TARGET -check.vv  (pass arguments to test)"
1164     echo "install TARGET"
1165     echo "install env            (go/python libs)"
1166     echo "install deps           (go/python libs + arvados components needed for integration tests)"
1167     echo "reset                  (...services used by integration tests)"
1168     echo "exit"
1169     echo "== Test targets:"
1170     echo "${!testfuncargs[@]}" | tr ' ' '\n' | sort | column
1171 }
1172
1173 initialize
1174
1175 declare -A testfuncargs=()
1176 for g in "${gostuff[@]}"; do
1177     testfuncargs[$g]="$g go"
1178 done
1179 for p in "${pythonstuff[@]}"; do
1180     dir=${p%:py3}
1181     testfuncargs[$dir:py3]="$dir pip $VENV3DIR/bin/"
1182 done
1183
1184 testfuncargs["sdk/cli"]="sdk/cli"
1185 testfuncargs["sdk/R"]="sdk/R"
1186 testfuncargs["sdk/java-v2"]="sdk/java-v2"
1187 testfuncargs["apps/workbench_units"]="apps/workbench_units"
1188 testfuncargs["apps/workbench_functionals"]="apps/workbench_functionals"
1189 testfuncargs["apps/workbench_integration"]="apps/workbench_integration"
1190 testfuncargs["apps/workbench_benchmark"]="apps/workbench_benchmark"
1191 testfuncargs["apps/workbench_profile"]="apps/workbench_profile"
1192
1193 if [[ -z ${interactive} ]]; then
1194     install_all
1195     test_all
1196 else
1197     skip=()
1198     only=()
1199     only_install=()
1200     if [[ -e "$VENV3DIR/bin/activate" ]]; then stop_services; fi
1201     setnextcmd() {
1202         if [[ "$TERM" = dumb ]]; then
1203             # assume emacs, or something, is offering a history buffer
1204             # and pre-populating the command will only cause trouble
1205             nextcmd=
1206         elif [[ ! -e "$VENV3DIR/bin/activate" ]]; then
1207             nextcmd="install deps"
1208         else
1209             nextcmd=""
1210         fi
1211     }
1212     echo
1213     help_interactive
1214     nextcmd="install deps"
1215     setnextcmd
1216     HISTFILE="$WORKSPACE/tmp/.history"
1217     history -r
1218     while read -p 'What next? ' -e -i "$nextcmd" nextcmd; do
1219         history -s "$nextcmd"
1220         history -w
1221         count=1
1222         if [[ "${nextcmd}" =~ ^[0-9] ]]; then
1223           read count nextcmd <<<"${nextcmd}"
1224         fi
1225         read verb target opts <<<"${nextcmd}"
1226         target="${target%/}"
1227         target="${target/\/:/:}"
1228         case "${verb}" in
1229             "exit" | "quit")
1230                 exit_cleanly
1231                 ;;
1232             "reset")
1233                 stop_services
1234                 ;;
1235             "test" | "install")
1236                 case "$target" in
1237                     "")
1238                         help_interactive
1239                         ;;
1240                     all | deps)
1241                         ${verb}_${target}
1242                         ;;
1243                     *)
1244                         argstarget=${target%:py3}
1245                         testargs["$argstarget"]="${opts}"
1246                         tt="${testfuncargs[${target}]}"
1247                         tt="${tt:-$target}"
1248                         while [ $count -gt 0 ]; do
1249                           do_$verb $tt
1250                           let "count=count-1"
1251                         done
1252                         ;;
1253                 esac
1254                 ;;
1255             "" | "help" | *)
1256                 help_interactive
1257                 ;;
1258         esac
1259         if [[ ${#successes[@]} -gt 0 || ${#failures[@]} -gt 0 ]]; then
1260             report_outcomes
1261             successes=()
1262             failures=()
1263         fi
1264         cd "$WORKSPACE"
1265         setnextcmd
1266     done
1267     echo
1268 fi
1269 exit_cleanly