Expand the README a bit, fix some syntax errors, add instructions for
[arvados.git] / build / run-library.sh
1 #!/bin/bash
2 # Copyright (C) The Arvados Authors. All rights reserved.
3 #
4 # SPDX-License-Identifier: AGPL-3.0
5
6 # A library of functions shared by the various scripts in this directory.
7
8 # This is the timestamp about when we merged changed to include licenses
9 # with Arvados packages.  We use it as a heuristic to add revisions for
10 # older packages.
11 LICENSE_PACKAGE_TS=20151208015500
12
13 if [[ -z "$ARVADOS_BUILDING_VERSION" ]]; then
14     RAILS_PACKAGE_ITERATION=8
15 else
16     RAILS_PACKAGE_ITERATION="$ARVADOS_BUILDING_ITERATION"
17 fi
18
19 debug_echo () {
20     echo "$@" >"$STDOUT_IF_DEBUG"
21 }
22
23 find_easy_install() {
24     for version_suffix in "$@"; do
25         if "easy_install$version_suffix" --version >/dev/null 2>&1; then
26             echo "easy_install$version_suffix"
27             return 0
28         fi
29     done
30     cat >&2 <<EOF
31 $helpmessage
32
33 Error: easy_install$1 (from Python setuptools module) not found
34
35 EOF
36     exit 1
37 }
38
39 format_last_commit_here() {
40     local format="$1"; shift
41     TZ=UTC git log -n1 --first-parent "--format=format:$format" .
42 }
43
44 version_from_git() {
45     # Output the version being built, or if we're building a
46     # dev/prerelease, output a version number based on the git log for
47     # the current working directory.
48     if [[ -n "$ARVADOS_BUILDING_VERSION" ]]; then
49         echo "$ARVADOS_BUILDING_VERSION"
50         return
51     fi
52
53     local git_ts git_hash prefix
54     if [[ -n "$1" ]] ; then
55         prefix="$1"
56     else
57         prefix="0.1"
58     fi
59
60     declare $(format_last_commit_here "git_ts=%ct git_hash=%h")
61     echo "${prefix}.$(date -ud "@$git_ts" +%Y%m%d%H%M%S).$git_hash"
62 }
63
64 nohash_version_from_git() {
65     if [[ -n "$ARVADOS_BUILDING_VERSION" ]]; then
66         echo "$ARVADOS_BUILDING_VERSION"
67         return
68     fi
69     version_from_git $1 | cut -d. -f1-3
70 }
71
72 timestamp_from_git() {
73     format_last_commit_here "%ct"
74 }
75
76 handle_python_package () {
77   # This function assumes the current working directory is the python package directory
78   if [ -n "$(find dist -name "*-$(nohash_version_from_git).tar.gz" -print -quit)" ]; then
79     # This package doesn't need rebuilding.
80     return
81   fi
82   # Make sure only to use sdist - that's the only format pip can deal with (sigh)
83   python setup.py $DASHQ_UNLESS_DEBUG sdist
84 }
85
86 handle_ruby_gem() {
87     local gem_name="$1"; shift
88     local gem_version="$(nohash_version_from_git)"
89     local gem_src_dir="$(pwd)"
90
91     if [[ -n "$ONLY_BUILD" ]] && [[ "$gem_name" != "$ONLY_BUILD" ]] ; then
92         return 0
93     fi
94
95     if ! [[ -e "${gem_name}-${gem_version}.gem" ]]; then
96         find -maxdepth 1 -name "${gem_name}-*.gem" -delete
97
98         # -q appears to be broken in gem version 2.2.2
99         $GEM build "$gem_name.gemspec" $DASHQ_UNLESS_DEBUG >"$STDOUT_IF_DEBUG" 2>"$STDERR_IF_DEBUG"
100     fi
101 }
102
103 # Usage: package_go_binary services/foo arvados-foo "Compute foo to arbitrary precision"
104 package_go_binary() {
105     local src_path="$1"; shift
106     local prog="$1"; shift
107     local description="$1"; shift
108     local license_file="${1:-agpl-3.0.txt}"; shift
109
110     if [[ -n "$ONLY_BUILD" ]] && [[ "$prog" != "$ONLY_BUILD" ]] ; then
111         return 0
112     fi
113
114     debug_echo "package_go_binary $src_path as $prog"
115
116     local basename="${src_path##*/}"
117
118     mkdir -p "$GOPATH/src/git.curoverse.com"
119     ln -sfn "$WORKSPACE" "$GOPATH/src/git.curoverse.com/arvados.git"
120     (cd "$GOPATH/src/git.curoverse.com/arvados.git" && "$GOPATH/bin/govendor" sync -v)
121
122     cd "$GOPATH/src/git.curoverse.com/arvados.git/$src_path"
123     local version="$(version_from_git)"
124     local timestamp="$(timestamp_from_git)"
125
126     # Update the version number and build a new package if the vendor
127     # bundle has changed, or the command imports anything from the
128     # Arvados SDK and the SDK has changed.
129     declare -a checkdirs=(vendor)
130     if grep -qr git.curoverse.com/arvados .; then
131         checkdirs+=(sdk/go)
132     fi
133     for dir in ${checkdirs[@]}; do
134         cd "$GOPATH/src/git.curoverse.com/arvados.git/$dir"
135         ts="$(timestamp_from_git)"
136         if [[ "$ts" -gt "$timestamp" ]]; then
137             version=$(version_from_git)
138             timestamp="$ts"
139         fi
140     done
141
142     cd $WORKSPACE/packages/$TARGET
143     test_package_presence $prog $version go
144
145     if [[ "$?" != "0" ]]; then
146       return 1
147     fi
148
149     go get -ldflags "-X main.version=${version}" "git.curoverse.com/arvados.git/$src_path"
150
151     local -a switches=()
152     systemd_unit="$WORKSPACE/${src_path}/${prog}.service"
153     if [[ -e "${systemd_unit}" ]]; then
154         switches+=(
155             --after-install "${WORKSPACE}/build/go-python-package-scripts/postinst"
156             --before-remove "${WORKSPACE}/build/go-python-package-scripts/prerm"
157             "${systemd_unit}=/lib/systemd/system/${prog}.service")
158     fi
159     switches+=("$WORKSPACE/${license_file}=/usr/share/doc/$prog/${license_file}")
160
161     fpm_build "$GOPATH/bin/${basename}=/usr/bin/${prog}" "${prog}" 'Curoverse, Inc.' dir "${version}" "--url=https://arvados.org" "--license=GNU Affero General Public License, version 3.0" "--description=${description}" "${switches[@]}"
162 }
163
164 default_iteration() {
165     if [[ -n "$ARVADOS_BUILDING_VERSION" ]]; then
166         echo "$ARVADOS_BUILDING_ITERATION"
167         return
168     fi
169     local package_name="$1"; shift
170     local package_version="$1"; shift
171     local package_type="$1"; shift
172     local iteration=1
173     if [[ $package_version =~ ^0\.1\.([0-9]{14})(\.|$) ]] && \
174            [[ ${BASH_REMATCH[1]} -le $LICENSE_PACKAGE_TS ]]; then
175         iteration=2
176     fi
177     if [[ $package_type =~ ^python ]]; then
178       # Fix --iteration for #9242.
179       iteration=2
180     fi
181     echo $iteration
182 }
183
184 _build_rails_package_scripts() {
185     local pkgname="$1"; shift
186     local destdir="$1"; shift
187     local srcdir="$RUN_BUILD_PACKAGES_PATH/rails-package-scripts"
188     for scriptname in postinst prerm postrm; do
189         cat "$srcdir/$pkgname.sh" "$srcdir/step2.sh" "$srcdir/$scriptname.sh" \
190             >"$destdir/$scriptname" || return $?
191     done
192 }
193
194 test_rails_package_presence() {
195   local pkgname="$1"; shift
196   local srcdir="$1"; shift
197
198   if [[ -n "$ONLY_BUILD" ]] && [[ "$pkgname" != "$ONLY_BUILD" ]] ; then
199     return 1
200   fi
201
202   tmppwd=`pwd`
203
204   cd $srcdir
205
206   local version="$(version_from_git)"
207
208   cd $tmppwd
209
210   test_package_presence $pkgname $version rails "$RAILS_PACKAGE_ITERATION"
211 }
212
213 test_package_presence() {
214     local pkgname="$1"; shift
215     local version="$1"; shift
216     local pkgtype="$1"; shift
217     local iteration="$1"; shift
218     local arch="$1"; shift
219
220     if [[ -n "$ONLY_BUILD" ]] && [[ "$pkgname" != "$ONLY_BUILD" ]] ; then
221         return 1
222     fi
223
224     if [[ "$iteration" == "" ]]; then
225         iteration="$(default_iteration "$pkgname" "$version" "$pkgtype")"
226     fi
227
228     if [[ "$arch" == "" ]]; then
229       rpm_architecture="x86_64"
230       deb_architecture="amd64"
231
232       if [[ "$pkgtype" =~ ^(python|python3)$ ]]; then
233         rpm_architecture="noarch"
234         deb_architecture="all"
235       fi
236
237       if [[ "$pkgtype" =~ ^(src)$ ]]; then
238         rpm_architecture="noarch"
239         deb_architecture="all"
240       fi
241
242       # These python packages have binary components
243       if [[ "$pkgname" =~ (ruamel|ciso|pycrypto|pyyaml) ]]; then
244         rpm_architecture="x86_64"
245         deb_architecture="amd64"
246       fi
247     else
248       rpm_architecture=$arch
249       deb_architecture=$arch
250     fi
251
252     if [[ "$FORMAT" == "deb" ]]; then
253         local complete_pkgname="${pkgname}_$version${iteration:+-$iteration}_$deb_architecture.deb"
254     else
255         # rpm packages get iteration 1 if we don't supply one
256         iteration=${iteration:-1}
257         local complete_pkgname="$pkgname-$version-${iteration}.$rpm_architecture.rpm"
258     fi
259
260     # See if we can skip building the package, only if it already exists in the
261     # processed/ directory. If so, move it back to the packages directory to make
262     # sure it gets picked up by the test and/or upload steps.
263     if [[ -e "processed/$complete_pkgname" ]]; then
264       echo "Package $complete_pkgname exists, not rebuilding!"
265       mv processed/$complete_pkgname .
266       return 1
267     else
268       echo "Package $complete_pkgname not found, building"
269       return 0
270     fi
271 }
272
273 handle_rails_package() {
274     local pkgname="$1"; shift
275
276     if [[ -n "$ONLY_BUILD" ]] && [[ "$pkgname" != "$ONLY_BUILD" ]] ; then
277         return 0
278     fi
279     local srcdir="$1"; shift
280     cd "$srcdir"
281     local license_path="$1"; shift
282     local version="$(version_from_git)"
283     local scripts_dir="$(mktemp --tmpdir -d "$pkgname-XXXXXXXX.scripts")" && \
284     (
285         set -e
286         _build_rails_package_scripts "$pkgname" "$scripts_dir"
287         cd "$srcdir"
288         mkdir -p tmp
289         git rev-parse HEAD >git-commit.version
290         bundle package --all
291     )
292     if [[ 0 != "$?" ]] || ! cd "$WORKSPACE/packages/$TARGET"; then
293         echo "ERROR: $pkgname package prep failed" >&2
294         rm -rf "$scripts_dir"
295         EXITCODE=1
296         return 1
297     fi
298     local railsdir="/var/www/${pkgname%-server}/current"
299     local -a pos_args=("$srcdir/=$railsdir" "$pkgname" "Curoverse, Inc." dir "$version")
300     local license_arg="$license_path=$railsdir/$(basename "$license_path")"
301     local -a switches=(--after-install "$scripts_dir/postinst"
302                        --before-remove "$scripts_dir/prerm"
303                        --after-remove "$scripts_dir/postrm")
304     if [[ -z "$ARVADOS_BUILDING_VERSION" ]]; then
305         switches+=(--iteration $RAILS_PACKAGE_ITERATION)
306     fi
307     # For some reason fpm excludes need to not start with /.
308     local exclude_root="${railsdir#/}"
309     # .git and packages are for the SSO server, which is built from its
310     # repository root.
311     local -a exclude_list=(.git packages tmp log coverage Capfile\* \
312                            config/deploy\* config/application.yml)
313     # for arvados-workbench, we need to have the (dummy) config/database.yml in the package
314     if  [[ "$pkgname" != "arvados-workbench" ]]; then
315       exclude_list+=('config/database.yml')
316     fi
317     for exclude in ${exclude_list[@]}; do
318         switches+=(-x "$exclude_root/$exclude")
319     done
320     fpm_build "${pos_args[@]}" "${switches[@]}" \
321               -x "$exclude_root/vendor/cache-*" \
322               -x "$exclude_root/vendor/bundle" "$@" "$license_arg"
323     rm -rf "$scripts_dir"
324 }
325
326 # Build packages for everything
327 fpm_build () {
328   # The package source.  Depending on the source type, this can be a
329   # path, or the name of the package in an upstream repository (e.g.,
330   # pip).
331   PACKAGE=$1
332   shift
333   # The name of the package to build.
334   PACKAGE_NAME=$1
335   shift
336   # Optional: the vendor of the package.  Should be "Curoverse, Inc." for
337   # packages of our own software.  Passed to fpm --vendor.
338   VENDOR=$1
339   shift
340   # The type of source package.  Passed to fpm -s.  Default "python".
341   PACKAGE_TYPE=${1:-python}
342   shift
343   # Optional: the package version number.  Passed to fpm -v.
344   VERSION=$1
345   shift
346
347   if [[ -n "$ONLY_BUILD" ]] && [[ "$PACKAGE_NAME" != "$ONLY_BUILD" ]] && [[ "$PACKAGE" != "$ONLY_BUILD" ]] ; then
348       return 0
349   fi
350
351   local default_iteration_value="$(default_iteration "$PACKAGE" "$VERSION" "$PACKAGE_TYPE")"
352
353   case "$PACKAGE_TYPE" in
354       python)
355           # All Arvados Python2 packages depend on Python 2.7.
356           # Make sure we build with that for consistency.
357           set -- "$@" --python-bin python2.7 \
358               --python-easyinstall "$EASY_INSTALL2" \
359               --python-package-name-prefix "$PYTHON2_PKG_PREFIX" \
360               --prefix "$PYTHON2_PREFIX" \
361               --python-install-lib "$PYTHON2_INSTALL_LIB" \
362               --python-install-data . \
363               --exclude "${PYTHON2_INSTALL_LIB#/}/tests" \
364               --depends "$PYTHON2_PACKAGE"
365           ;;
366       python3)
367           # fpm does not actually support a python3 package type.  Instead
368           # we recognize it as a convenience shortcut to add several
369           # necessary arguments to fpm's command line later, after we're
370           # done handling positional arguments.
371           PACKAGE_TYPE=python
372           set -- "$@" --python-bin python3 \
373               --python-easyinstall "$EASY_INSTALL3" \
374               --python-package-name-prefix "$PYTHON3_PKG_PREFIX" \
375               --prefix "$PYTHON3_PREFIX" \
376               --python-install-lib "$PYTHON3_INSTALL_LIB" \
377               --python-install-data . \
378               --exclude "${PYTHON3_INSTALL_LIB#/}/tests" \
379               --depends "$PYTHON3_PACKAGE"
380           ;;
381   esac
382
383   declare -a COMMAND_ARR=("fpm" "--maintainer=Ward Vandewege <ward@curoverse.com>" "-s" "$PACKAGE_TYPE" "-t" "$FORMAT")
384   if [ python = "$PACKAGE_TYPE" ] && [ deb = "$FORMAT" ]; then
385       # Dependencies are built from setup.py.  Since setup.py will never
386       # refer to Debian package iterations, it doesn't make sense to
387       # enforce those in the .deb dependencies.
388       COMMAND_ARR+=(--deb-ignore-iteration-in-dependencies)
389   fi
390
391   # 12271 - As FPM-generated packages don't include scripts by default, the
392   # packages cleanup on upgrade depends on files being listed on the %files
393   # section in the generated SPEC files. To remove DIRECTORIES, they need to
394   # be listed in that sectiontoo, so we need to add this parameter to properly
395   # remove lingering dirs.
396   if [[ rpm = "$FORMAT" ]]; then
397     COMMAND_ARR+=('--rpm-auto-add-directories')
398   fi
399
400   if [[ "${DEBUG:-0}" != "0" ]]; then
401     COMMAND_ARR+=('--verbose' '--log' 'info')
402   fi
403
404   if [[ -n "$PACKAGE_NAME" ]]; then
405     COMMAND_ARR+=('-n' "$PACKAGE_NAME")
406   fi
407
408   if [[ "$VENDOR" != "" ]]; then
409     COMMAND_ARR+=('--vendor' "$VENDOR")
410   fi
411
412   if [[ "$VERSION" != "" ]]; then
413     COMMAND_ARR+=('-v' "$VERSION")
414   fi
415   if [[ -n "$default_iteration_value" ]]; then
416       # We can always add an --iteration here.  If another one is specified in $@,
417       # that will take precedence, as desired.
418       COMMAND_ARR+=(--iteration "$default_iteration_value")
419   fi
420
421   if [[ python = "$PACKAGE_TYPE" ]] && [[ -e "${PACKAGE}/${PACKAGE_NAME}.service" ]]
422   then
423       COMMAND_ARR+=(
424           --after-install "${WORKSPACE}/build/go-python-package-scripts/postinst"
425           --before-remove "${WORKSPACE}/build/go-python-package-scripts/prerm"
426       )
427   fi
428
429   # Append --depends X and other arguments specified by fpm-info.sh in
430   # the package source dir. These are added last so they can override
431   # the arguments added by this script.
432   declare -a fpm_args=()
433   declare -a build_depends=()
434   declare -a fpm_depends=()
435   declare -a fpm_exclude=()
436   declare -a fpm_dirs=(
437       # source dir part of 'dir' package ("/source=/dest" => "/source"):
438       "${PACKAGE%%=/*}"
439       # backports ("llfuse>=1.0" => "backports/python-llfuse")
440       "${WORKSPACE}/backports/${PACKAGE_TYPE}-${PACKAGE%%[<=>]*}")
441   if [[ -n "$PACKAGE_NAME" ]]; then
442       fpm_dirs+=("${WORKSPACE}/backports/${PACKAGE_NAME}")
443   fi
444   for pkgdir in "${fpm_dirs[@]}"; do
445       fpminfo="$pkgdir/fpm-info.sh"
446       if [[ -e "$fpminfo" ]]; then
447           debug_echo "Loading fpm overrides from $fpminfo"
448           source "$fpminfo"
449           break
450       fi
451   done
452   for pkg in "${build_depends[@]}"; do
453       if [[ $TARGET =~ debian|ubuntu ]]; then
454           pkg_deb=$(ls "$WORKSPACE/packages/$TARGET/$pkg_"*.deb | sort -rg | awk 'NR==1')
455           if [[ -e $pkg_deb ]]; then
456               echo "Installing build_dep $pkg from $pkg_deb"
457               dpkg -i "$pkg_deb"
458           else
459               echo "Attemping to install build_dep $pkg using apt-get"
460               apt-get install -y "$pkg"
461           fi
462           apt-get -y -f install
463       else
464           pkg_rpm=$(ls "$WORKSPACE/packages/$TARGET/$pkg"-[0-9]*.rpm | sort -rg | awk 'NR==1')
465           if [[ -e $pkg_rpm ]]; then
466               echo "Installing build_dep $pkg from $pkg_rpm"
467               rpm -i "$pkg_rpm"
468           else
469               echo "Attemping to install build_dep $pkg"
470               rpm -i "$pkg"
471           fi
472       fi
473   done
474   for i in "${fpm_depends[@]}"; do
475     COMMAND_ARR+=('--depends' "$i")
476   done
477   for i in "${fpm_exclude[@]}"; do
478     COMMAND_ARR+=('--exclude' "$i")
479   done
480
481   # Append remaining function arguments directly to fpm's command line.
482   for i; do
483     COMMAND_ARR+=("$i")
484   done
485
486   COMMAND_ARR+=("${fpm_args[@]}")
487
488   COMMAND_ARR+=("$PACKAGE")
489
490   debug_echo -e "\n${COMMAND_ARR[@]}\n"
491
492   FPM_RESULTS=$("${COMMAND_ARR[@]}")
493   FPM_EXIT_CODE=$?
494
495   fpm_verify $FPM_EXIT_CODE $FPM_RESULTS
496
497   # if something went wrong and debug is off, print out the fpm command that errored
498   if [[ 0 -ne $? ]] && [[ "$STDOUT_IF_DEBUG" == "/dev/null" ]]; then
499     echo -e "\n${COMMAND_ARR[@]}\n"
500   fi
501 }
502
503 # verify build results
504 fpm_verify () {
505   FPM_EXIT_CODE=$1
506   shift
507   FPM_RESULTS=$@
508
509   FPM_PACKAGE_NAME=''
510   if [[ $FPM_RESULTS =~ ([A-Za-z0-9_\.-]*\.)(deb|rpm) ]]; then
511     FPM_PACKAGE_NAME=${BASH_REMATCH[1]}${BASH_REMATCH[2]}
512   fi
513
514   if [[ "$FPM_PACKAGE_NAME" == "" ]]; then
515     EXITCODE=1
516     echo
517     echo "Error: $PACKAGE: Unable to figure out package name from fpm results:"
518     echo
519     echo $FPM_RESULTS
520     echo
521     return 1
522   elif [[ "$FPM_RESULTS" =~ "File already exists" ]]; then
523     echo "Package $FPM_PACKAGE_NAME exists, not rebuilding"
524     return 0
525   elif [[ 0 -ne "$FPM_EXIT_CODE" ]]; then
526     EXITCODE=1
527     echo "Error building package for $1:\n $FPM_RESULTS"
528     return 1
529   fi
530 }
531
532 install_package() {
533   PACKAGES=$@
534   if [[ "$FORMAT" == "deb" ]]; then
535     $SUDO apt-get install $PACKAGES --yes
536   elif [[ "$FORMAT" == "rpm" ]]; then
537     $SUDO yum -q -y install $PACKAGES
538   fi
539 }
540
541 title () {
542     txt="********** $1 **********"
543     printf "\n%*s%s\n\n" $((($COLUMNS-${#txt})/2)) "" "$txt"
544 }
545
546 checkexit() {
547     if [[ "$1" != "0" ]]; then
548         title "!!!!!! $2 FAILED !!!!!!"
549         failures+=("$2 (`timer`)")
550     else
551         successes+=("$2 (`timer`)")
552     fi
553 }
554
555 timer_reset() {
556     t0=$SECONDS
557 }
558
559 timer() {
560     echo -n "$(($SECONDS - $t0))s"
561 }
562
563 report_outcomes() {
564     for x in "${successes[@]}"
565     do
566         echo "Pass: $x"
567     done
568
569     if [[ ${#failures[@]} == 0 ]]
570     then
571         echo "All test suites passed."
572     else
573         echo "Failures (${#failures[@]}):"
574         for x in "${failures[@]}"
575         do
576             echo "Fail: $x"
577         done
578     fi
579 }