3 . `dirname "$(readlink -f "$0")"`/libcloud-pin
6 . `dirname "$(readlink -f "$0")"`/run-library.sh
8 read -rd "\000" helpmessage <<EOF
9 $(basename $0): Install and test Arvados components.
11 Exit non-zero if any tests fail.
14 $(basename $0) WORKSPACE=/path/to/arvados [options]
18 --skip FOO Do not test the FOO component.
19 --only FOO Do not test anything except the FOO component.
20 --temp DIR Install components and dependencies under DIR instead of
21 making a new temporary directory. Implies --leave-temp.
22 --leave-temp Do not remove GOPATH, virtualenv, and other temp dirs at exit.
23 Instead, show the path to give as --temp to reuse them in
24 subsequent invocations.
25 --skip-install Do not run any install steps. Just run tests.
26 You should provide GOPATH, GEMHOME, and VENVDIR options
27 from a previous invocation if you use this option.
28 --only-install Run specific install step
29 --short Skip (or scale down) some slow tests.
30 WORKSPACE=path Arvados source tree to test.
31 CONFIGSRC=path Dir with api server config files to copy into source tree.
32 (If none given, leave config files alone in source tree.)
33 services/api_test="TEST=test/functional/arvados/v1/collections_controller_test.rb"
34 Restrict apiserver tests to the given file
35 sdk/python_test="--test-suite test.test_keep_locator"
36 Restrict Python SDK tests to the given class
37 apps/workbench_test="TEST=test/integration/pipeline_instances_test.rb"
38 Restrict Workbench tests to the given file
39 services/arv-git-httpd_test="-check.vv"
40 Show all log messages, even when tests pass (also works
41 with services/keepstore_test etc.)
43 Print more debug messages
44 envvar=value Set \$envvar to value. Primarily useful for WORKSPACE,
45 *_test, and other examples shown above.
47 Assuming --skip-install is not given, all components are installed
48 into \$GOPATH, \$VENDIR, and \$GEMHOME before running any tests. Many
49 test suites depend on other components being installed, and installing
50 everything tends to be quicker than debugging dependencies.
52 As a special concession to the current CI server config, CONFIGSRC
53 defaults to $HOME/arvados-api-server if that directory exists.
55 More information and background:
57 https://arvados.org/projects/arvados/wiki/Running_tests
62 apps/workbench_benchmark
63 apps/workbench_profile
66 services/arv-git-httpd
68 services/dockercleaner
77 services/crunch-dispatch-local
78 services/crunch-dispatch-slurm
92 tools/crunchstat-summary
94 tools/keep-block-check
98 # First make sure to remove any ARVADOS_ variables from the calling
99 # environment that could interfere with the tests.
100 unset $(env | cut -d= -f1 | grep \^ARVADOS_)
102 # Reset other variables that could affect our [tests'] behavior by
118 if [[ -z "$temp" ]]; then
119 # we didn't even get as far as making a temp dir
121 elif [[ -z "$temp_preserve" ]]; then
124 echo "Leaving behind temp dirs in $temp"
130 echo >&2 "Fatal: $* (encountered in ${FUNCNAME[1]} at ${BASH_SOURCE[1]} line ${BASH_LINENO[0]})"
136 create-plot-data-from-log.sh $BUILD_NUMBER "$WORKSPACE/apps/workbench/log/test.log" "$WORKSPACE/apps/workbench/log/"
137 rotate_logfile "$WORKSPACE/apps/workbench/log/" "test.log"
139 rotate_logfile "$WORKSPACE/services/api/log/" "test.log"
146 ( [[ -n "$WORKSPACE" ]] && [[ -d "$WORKSPACE/services" ]] ) \
147 || fatal "WORKSPACE environment variable not set to a source directory (see: $0 --help)"
148 echo Checking dependencies:
149 echo -n 'virtualenv: '
150 virtualenv --version \
151 || fatal "No virtualenv. Try: apt-get install virtualenv (on ubuntu: python-virtualenv)"
154 || fatal "No go binary. See http://golang.org/doc/install"
155 [[ $(go version) =~ go1.([0-9]+) ]] && [[ ${BASH_REMATCH[1]} -ge 6 ]] \
156 || fatal "Go >= 1.6 required. See http://golang.org/doc/install"
158 gcc --version | egrep ^gcc \
159 || fatal "No gcc. Try: apt-get install build-essential"
161 find /usr/include -wholename '*fuse/fuse.h' \
162 || fatal "No fuse/fuse.h. Try: apt-get install libfuse-dev"
163 echo -n 'pyconfig.h: '
164 find /usr/include -name pyconfig.h | egrep --max-count=1 . \
165 || fatal "No pyconfig.h. Try: apt-get install python-dev"
167 PATH="$PATH:/sbin:/usr/sbin:/usr/local/sbin" nginx -v \
168 || fatal "No nginx. Try: apt-get install nginx"
170 perl -v | grep version \
171 || fatal "No perl. Try: apt-get install perl"
172 for mod in ExtUtils::MakeMaker JSON LWP Net::SSL; do
173 echo -n "perl $mod: "
174 perl -e "use $mod; print \"\$$mod::VERSION\\n\"" \
175 || fatal "No $mod. Try: apt-get install perl-modules libcrypt-ssleay-perl libjson-perl libwww-perl"
179 || fatal "No gitolite. Try: apt-get install gitolite3"
183 # i.e. rotate_logfile "$WORKSPACE/apps/workbench/log/" "test.log"
184 # $BUILD_NUMBER is set by Jenkins if this script is being called as part of a Jenkins run
185 if [[ -f "$1/$2" ]]; then
186 THEDATE=`date +%Y%m%d%H%M%S`
187 mv "$1/$2" "$1/$THEDATE-$BUILD_NUMBER-$2"
188 gzip "$1/$THEDATE-$BUILD_NUMBER-$2"
195 skip[apps/workbench_profile]=1
202 echo >&2 "$helpmessage"
211 only="$1"; skip[$1]=""; shift
221 only_install="$1"; shift
234 suite="${arg%%_test=*}"
236 testargs["$suite"]="$args"
239 eval export $(echo $arg | cut -d= -f1)=\"$(echo $arg | cut -d= -f2-)\"
242 echo >&2 "$0: Unrecognized option: '$arg'. Try: $0 --help"
249 echo 'Starting API server...'
251 && eval $(python sdk/python/tests/run_test_server.py start --auth admin) \
252 && export ARVADOS_TEST_API_HOST="$ARVADOS_API_HOST" \
253 && export ARVADOS_TEST_API_INSTALLED="$$" \
254 && (env | egrep ^ARVADOS)
257 start_nginx_proxy_services() {
258 echo 'Starting keepproxy, keep-web, arv-git-httpd, and nginx ssl proxy...'
260 && python sdk/python/tests/run_test_server.py start_keep_proxy \
261 && python sdk/python/tests/run_test_server.py start_keep-web \
262 && python sdk/python/tests/run_test_server.py start_arv-git-httpd \
263 && python sdk/python/tests/run_test_server.py start_nginx \
264 && export ARVADOS_TEST_PROXY_SERVICES=1
268 if [[ -n "$ARVADOS_TEST_PROXY_SERVICES" ]]; then
269 unset ARVADOS_TEST_PROXY_SERVICES
271 && python sdk/python/tests/run_test_server.py stop_nginx \
272 && python sdk/python/tests/run_test_server.py stop_arv-git-httpd \
273 && python sdk/python/tests/run_test_server.py stop_keep-web \
274 && python sdk/python/tests/run_test_server.py stop_keep_proxy
276 if [[ -n "$ARVADOS_TEST_API_HOST" ]]; then
277 unset ARVADOS_TEST_API_HOST
279 && python sdk/python/tests/run_test_server.py stop
284 failures+=("($(basename $0) interrupted)")
291 echo "WORKSPACE=$WORKSPACE"
293 if [[ -z "$CONFIGSRC" ]] && [[ -d "$HOME/arvados-api-server" ]]; then
294 # Jenkins expects us to use this by default.
295 CONFIGSRC="$HOME/arvados-api-server"
298 # Clean up .pyc files that may exist in the workspace
300 find -name '*.pyc' -delete
302 if [[ -z "$temp" ]]; then
306 # Set up temporary install dirs (unless existing dirs were supplied)
307 for tmpdir in VENVDIR VENV3DIR GOPATH GEMHOME PERLINSTALLBASE
309 if [[ -z "${!tmpdir}" ]]; then
310 eval "$tmpdir"="$temp/$tmpdir"
312 if ! [[ -d "${!tmpdir}" ]]; then
313 mkdir "${!tmpdir}" || fatal "can't create ${!tmpdir} (does $temp exist?)"
317 setup_ruby_environment() {
318 if [[ -s "$HOME/.rvm/scripts/rvm" ]] ; then
319 source "$HOME/.rvm/scripts/rvm"
321 elif [[ -s "/usr/local/rvm/scripts/rvm" ]] ; then
322 source "/usr/local/rvm/scripts/rvm"
328 if [[ "$using_rvm" == true ]]; then
329 # If rvm is in use, we can't just put separate "dependencies"
330 # and "gems-under-test" paths to GEM_PATH: passenger resets
331 # the environment to the "current gemset", which would lose
332 # our GEM_PATH and prevent our test suites from running ruby
333 # programs (for example, the Workbench test suite could not
334 # boot an API server or run arv). Instead, we have to make an
335 # rvm gemset and use it for everything.
337 [[ `type rvm | head -n1` == "rvm is a function" ]] \
340 # Put rvm's favorite path back in first place (overriding
341 # virtualenv, which just put itself there). Ignore rvm's
342 # complaint about not being in first place already.
343 rvm use @default 2>/dev/null
345 # Create (if needed) and switch to an @arvados-tests
346 # gemset. (Leave the choice of ruby to the caller.)
347 rvm use @arvados-tests --create \
348 || fatal 'rvm gemset setup'
352 # When our "bundle install"s need to install new gems to
353 # satisfy dependencies, we want them to go where "gem install
354 # --user-install" would put them. (However, if the caller has
355 # already set GEM_HOME, we assume that's where dependencies
356 # should be installed, and we should leave it alone.)
358 if [ -z "$GEM_HOME" ]; then
359 user_gempath="$(gem env gempath)"
360 export GEM_HOME="${user_gempath%%:*}"
362 PATH="$(gem env gemdir)/bin:$PATH"
364 # When we build and install our own gems, we install them in our
365 # $GEMHOME tmpdir, and we want them to be at the front of GEM_PATH and
366 # PATH so integration tests prefer them over other versions that
367 # happen to be installed in $user_gempath, system dirs, etc.
369 tmpdir_gem_home="$(env - PATH="$PATH" HOME="$GEMHOME" gem env gempath | cut -f1 -d:)"
370 PATH="$tmpdir_gem_home/bin:$PATH"
371 export GEM_PATH="$tmpdir_gem_home:$(gem env gempath)"
373 echo "Will install dependencies to $(gem env gemdir)"
374 echo "Will install arvados gems to $tmpdir_gem_home"
375 echo "Gem search path is GEM_PATH=$GEM_PATH"
380 if [[ "$using_rvm" == true ]]; then
383 GEM_HOME="$tmpdir_gem_home" GEM_PATH="$tmpdir_gem_home" "$@"
387 gem_uninstall_if_exists() {
388 if gem list "$1\$" | egrep '^\w'; then
389 gem uninstall --force --all --executables "$1"
394 local venvdest="$1"; shift
395 if ! [[ -e "$venvdest/bin/activate" ]] || ! [[ -e "$venvdest/bin/pip" ]]; then
396 virtualenv --setuptools "$@" "$venvdest" || fatal "virtualenv $venvdest failed"
398 if [[ $("$venvdest/bin/python" --version 2>&1) =~ \ 3\.[012]\. ]]; then
399 # pip 8.0.0 dropped support for python 3.2, e.g., debian wheezy
400 "$venvdest/bin/pip" install 'setuptools>=18' 'pip>=7,<8'
402 "$venvdest/bin/pip" install 'setuptools>=18' 'pip>=7'
404 # ubuntu1404 can't seem to install mock via tests_require, but it can do this.
405 "$venvdest/bin/pip" install 'mock>=1.0' 'pbr<1.7.0'
408 export PERLINSTALLBASE
409 export PERLLIB="$PERLINSTALLBASE/lib/perl5:${PERLLIB:+$PERLLIB}"
412 mkdir -p "$GOPATH/src/git.curoverse.com"
413 ln -sfn "$WORKSPACE" "$GOPATH/src/git.curoverse.com/arvados.git" \
414 || fatal "symlink failed"
416 setup_virtualenv "$VENVDIR" --python python2.7
417 . "$VENVDIR/bin/activate"
419 # Needed for run_test_server.py which is used by certain (non-Python) tests.
420 pip freeze 2>/dev/null | egrep ^PyYAML= \
421 || pip install PyYAML >/dev/null \
422 || fatal "pip install PyYAML failed"
424 # Preinstall forked version of libcloud, because nodemanager "pip install"
425 # won't pick it up by default.
426 pip freeze 2>/dev/null | egrep ^apache-libcloud==$LIBCLOUD_PIN \
427 || pip install --pre --ignore-installed https://github.com/curoverse/libcloud/archive/apache-libcloud-$LIBCLOUD_PIN.zip >/dev/null \
428 || fatal "pip install apache-libcloud failed"
430 # This will help people who reuse --temp dirs when we upgrade to llfuse 0.42
431 if egrep -q 'llfuse.*>= *0\.42' "$WORKSPACE/services/fuse/setup.py"; then
432 # Uninstall old llfuse, because services/fuse "pip install" won't
433 # upgrade it by default.
434 if pip freeze | egrep '^llfuse==0\.41\.'; then
435 yes | pip uninstall 'llfuse<0.42'
439 # Deactivate Python 2 virtualenv
442 # If Python 3 is available, set up its virtualenv in $VENV3DIR.
443 # Otherwise, skip dependent tests.
444 PYTHON3=$(which python3)
445 if [ "0" = "$?" ]; then
446 setup_virtualenv "$VENV3DIR" --python python3
449 skip[services/dockercleaner]=1
452 Warning: python3 could not be found
453 services/dockercleaner install and tests will be skipped
458 # Reactivate Python 2 virtualenv
459 . "$VENVDIR/bin/activate"
461 # Note: this must be the last time we change PATH, otherwise rvm will
463 setup_ruby_environment
467 if ! which bundler >/dev/null
469 gem install --user-install bundler || fatal 'Could not install bundler'
473 while ! ${@} && [[ "$retry" == 1 ]]
475 read -p 'Try again? [Y/n] ' x
476 if [[ "$x" != "y" ]] && [[ "$x" != "" ]]
484 retry do_test_once ${@}
489 if [[ -z "${skip[$1]}" ]] && ( [[ -z "$only" ]] || [[ "$only" == "$1" ]] )
491 title "Running $1 tests"
493 if [[ "$2" == "go" ]]
495 covername="coverage-$(echo "$1" | sed -e 's/\//_/g')"
496 coverflags=("-covermode=count" "-coverprofile=$WORKSPACE/tmp/.$covername.tmp")
497 # We do "go get -t" here to catch compilation errors
498 # before trying "go test". Otherwise, coverage-reporting
499 # mode makes Go show the wrong line numbers when reporting
500 # compilation errors.
501 go get -t "git.curoverse.com/arvados.git/$1" || return 1
502 if [[ -n "${testargs[$1]}" ]]
504 # "go test -check.vv giturl" doesn't work, but this
506 cd "$WORKSPACE/$1" && go test ${short:+-short} ${testargs[$1]}
508 # The above form gets verbose even when testargs is
509 # empty, so use this form in such cases:
510 go test ${short:+-short} ${coverflags[@]} "git.curoverse.com/arvados.git/$1"
513 if [[ -f "$WORKSPACE/tmp/.$covername.tmp" ]]
515 go tool cover -html="$WORKSPACE/tmp/.$covername.tmp" -o "$WORKSPACE/tmp/$covername.html"
516 rm "$WORKSPACE/tmp/.$covername.tmp"
518 elif [[ "$2" == "pip" ]]
520 # $3 can name a path directory for us to use, including trailing
521 # slash; e.g., the bin/ subdirectory of a virtualenv.
523 && "${3}python" setup.py ${short:+--short-tests-only} test ${testargs[$1]}
524 elif [[ "$2" != "" ]]
531 checkexit $result "$1 tests"
532 title "End of $1 tests (`timer`)"
535 title "Skipping $1 tests"
540 retry do_install_once ${@}
544 if [[ -z "$skip_install" || (-n "$only_install" && "$only_install" == "$1") ]]
546 title "Running $1 install"
548 if [[ "$2" == "go" ]]
550 go get -t "git.curoverse.com/arvados.git/$1"
551 elif [[ "$2" == "pip" ]]
553 # $3 can name a path directory for us to use, including trailing
554 # slash; e.g., the bin/ subdirectory of a virtualenv.
556 # Need to change to a different directory after creating
557 # the source dist package to avoid a pip bug.
558 # see https://arvados.org/issues/5766 for details.
560 # Also need to install twice, because if it believes the package is
561 # already installed, pip it won't install it. So the first "pip
562 # install" ensures that the dependencies are met, the second "pip
563 # install" ensures that we've actually installed the local package
566 && "${3}python" setup.py sdist rotate --keep=1 --match .tar.gz \
568 && "${3}pip" install --quiet "$WORKSPACE/$1/dist"/*.tar.gz \
569 && "${3}pip" install --quiet --no-deps --ignore-installed "$WORKSPACE/$1/dist"/*.tar.gz
570 elif [[ "$2" != "" ]]
577 checkexit $result "$1 install"
578 title "End of $1 install (`timer`)"
581 title "Skipping $1 install"
585 bundle_install_trylocal() {
588 echo "(Running bundle install --local. 'could not find package' messages are OK.)"
589 if ! bundle install --local --no-deployment; then
590 echo "(Running bundle install again, without --local.)"
591 bundle install --no-deployment
598 cd "$WORKSPACE/doc" \
599 && bundle_install_trylocal \
607 with_test_gemset gem_uninstall_if_exists "$gemname" \
608 && cd "$WORKSPACE/$srcpath" \
609 && bundle_install_trylocal \
610 && gem build "$gemname.gemspec" \
611 && with_test_gemset gem install --no-ri --no-rdoc $(ls -t "$gemname"-*.gem|head -n1)
615 install_gem arvados sdk/ruby
617 do_install sdk/ruby ruby_sdk
620 cd "$WORKSPACE/sdk/perl" \
621 && perl Makefile.PL INSTALL_BASE="$PERLINSTALLBASE" \
622 && make install INSTALLDIRS=perl
624 do_install sdk/perl perl_sdk
627 install_gem arvados-cli sdk/cli
629 do_install sdk/cli cli
631 install_login-sync() {
632 install_gem arvados-login-sync services/login-sync
634 do_install services/login-sync login-sync
636 # Install the Python SDK early. Various other test suites (like
637 # keepproxy) bring up run_test_server.py, which imports the arvados
638 # module. We can't actually *test* the Python SDK yet though, because
639 # its own test suite brings up some of those other programs (like
641 declare -a pythonstuff
648 tools/crunchstat-summary
650 for p in "${pythonstuff[@]}"
654 if [ -n "$PYTHON3" ]; then
655 do_install services/dockercleaner pip "$VENV3DIR/bin/"
658 install_apiserver() {
659 cd "$WORKSPACE/services/api" \
660 && RAILS_ENV=test bundle_install_trylocal
662 rm -f config/environments/test.rb
663 cp config/environments/test.rb.example config/environments/test.rb
665 if [ -n "$CONFIGSRC" ]
667 for f in database.yml application.yml
669 cp "$CONFIGSRC/$f" config/ || fatal "$f"
673 # Fill in a random secret_token and blob_signing_key for testing
674 SECRET_TOKEN=`echo 'puts rand(2**512).to_s(36)' |ruby`
675 BLOB_SIGNING_KEY=`echo 'puts rand(2**512).to_s(36)' |ruby`
677 sed -i'' -e "s:SECRET_TOKEN:$SECRET_TOKEN:" config/application.yml
678 sed -i'' -e "s:BLOB_SIGNING_KEY:$BLOB_SIGNING_KEY:" config/application.yml
680 # Set up empty git repo (for git tests)
682 sed -i'' -e "s:/var/cache/git:$GITDIR:" config/application.default.yml
685 mkdir -p $GITDIR/test
688 && git config user.email "jenkins@ci.curoverse.com" \
689 && git config user.name "Jenkins, CI" \
692 && git commit -m 'initial commit'
694 # Clear out any lingering postgresql connections to the test
695 # database, so that we can drop it. This assumes the current user
696 # is a postgresql superuser.
697 cd "$WORKSPACE/services/api" \
698 && test_database=$(python -c "import yaml; print yaml.load(file('config/database.yml'))['test']['database']") \
699 && psql "$test_database" -c "SELECT pg_terminate_backend (pg_stat_activity.procpid::int) FROM pg_stat_activity WHERE pg_stat_activity.datname = '$test_database';" 2>/dev/null
701 cd "$WORKSPACE/services/api" \
702 && RAILS_ENV=test bundle exec rake db:drop \
703 && RAILS_ENV=test bundle exec rake db:setup \
704 && RAILS_ENV=test bundle exec rake db:fixtures:load
706 do_install services/api apiserver
718 services/arv-git-httpd
723 services/keep-balance
725 services/datamanager/summary
726 services/datamanager/collection
727 services/datamanager/keep
729 services/crunch-dispatch-local
730 services/crunch-dispatch-slurm
733 tools/keep-block-check
735 for g in "${gostuff[@]}"
740 install_workbench() {
741 cd "$WORKSPACE/apps/workbench" \
742 && mkdir -p tmp/cache \
743 && RAILS_ENV=test bundle_install_trylocal
745 do_install apps/workbench workbench
747 test_doclinkchecker() {
751 ARVADOS_API_HOST=qr1hi.arvadosapi.com
752 # Make sure python-epydoc is installed or the next line won't
754 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
757 do_test doc doclinkchecker
762 rm -f "$WORKSPACE/services/api/git-commit.version"
763 cd "$WORKSPACE/services/api" \
764 && env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} bundle exec rake test TESTOPTS=-v ${testargs[services/api]}
766 do_test services/api apiserver
768 # Shortcut for when we're only running apiserver tests. This saves a bit of time,
769 # because we don't need to start up the api server for subsequent tests.
770 if [ ! -z "$only" ] && [ "$only" == "services/api" ]; then
771 rotate_logfile "$WORKSPACE/services/api/log/" "test.log"
778 cd "$WORKSPACE/sdk/ruby" \
779 && bundle exec rake test TESTOPTS=-v ${testargs[sdk/ruby]}
781 do_test sdk/ruby ruby_sdk
784 cd "$WORKSPACE/sdk/cli" \
785 && mkdir -p /tmp/keep \
786 && KEEP_LOCAL_STORE=/tmp/keep bundle exec rake test TESTOPTS=-v ${testargs[sdk/cli]}
791 cd "$WORKSPACE/services/login-sync" \
792 && bundle exec rake test TESTOPTS=-v ${testargs[services/login-sync]}
794 do_test services/login-sync login-sync
796 for p in "${pythonstuff[@]}"
800 do_test services/dockercleaner pip "$VENV3DIR/bin/"
802 for g in "${gostuff[@]}"
808 start_nginx_proxy_services \
809 && cd "$WORKSPACE/apps/workbench" \
810 && env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} bundle exec rake test TESTOPTS=-v ${testargs[apps/workbench]}
812 do_test apps/workbench workbench
814 test_workbench_benchmark() {
815 start_nginx_proxy_services \
816 && cd "$WORKSPACE/apps/workbench" \
817 && env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} bundle exec rake test:benchmark ${testargs[apps/workbench_benchmark]}
819 do_test apps/workbench_benchmark workbench_benchmark
821 test_workbench_profile() {
822 start_nginx_proxy_services \
823 && cd "$WORKSPACE/apps/workbench" \
824 && env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} bundle exec rake test:profile ${testargs[apps/workbench_profile]}
826 do_test apps/workbench_profile workbench_profile