1 # CI configuration file for CI utilizing cirrus-ci.org
3 # For instructions on how to enable the CI integration in a repository and
4 # further details, see src/tools/ci/README
8 # Source of images / containers
9 GCP_PROJECT: pg-ci-images
10 IMAGE_PROJECT: $GCP_PROJECT
11 CONTAINER_REPO: us-docker.pkg.dev/${GCP_PROJECT}/ci
13 # The lower depth accelerates git clone. Use a bit of depth so that
14 # concurrent tasks and retrying older jobs has a chance of working.
15 CIRRUS_CLONE_DEPTH: 500
16 # Useful to be able to analyse what in a script takes long
17 CIRRUS_LOG_TIMESTAMP: true
19 CCACHE_MAXSIZE: "250M"
21 # target to test, for all but windows
22 CHECK: check-world PROVE_FLAGS=$PROVE_FLAGS
25 MTEST_ARGS: --print-errorlogs --no-rebuild -C build
26 PGCTLTIMEOUT: 120 # avoids spurious failures during parallel tests
27 TEMP_CONFIG: ${CIRRUS_WORKING_DIR}/src/tools/ci/pg_ci_base.conf
28 PG_TEST_EXTRA: kerberos ldap ssl
31 # What files to preserve in case tests fail
32 on_failure_ac: &on_failure_ac
40 on_failure_meson: &on_failure_meson
43 - "build*/testrun/**/*.log"
44 - "build*/testrun/**/*.diffs"
45 - "build*/testrun/**/regress_log_*"
48 # In theory it'd be nice to upload the junit files meson generates, so that
49 # cirrus will nicely annotate the commit. Unfortunately the files don't
50 # contain identifieable file + line numbers right now, so the annotations
51 # don't end up useful. We could probably improve on that with a some custom
52 # conversion script, but ...
54 path: "build*/meson-logs/*.txt"
58 # To avoid unnecessarily spinning up a lot of VMs / containers for entirely
59 # broken commits, have a minimal task that all others depend on.
63 # If a specific OS is requested, don't run the sanity check. This shortens
64 # push-wait-for-ci cycle time a bit when debugging operating system specific
65 # failures. Uses skip instead of only_if, as cirrus otherwise warns about
66 # only_if conditions not matching.
67 skip: $CIRRUS_CHANGE_MESSAGE =~ '.*\nci-os-only:.*'
73 CCACHE_DIR: ${CIRRUS_WORKING_DIR}/ccache_dir
74 # no options enabled, should be small
75 CCACHE_MAXSIZE: "150M"
77 # Container starts up quickly, but is slower at runtime, particularly for
78 # tests. Good for the briefly running sanity check.
80 image: $CONTAINER_REPO/linux_debian_bullseye_ci:latest
88 chown -R postgres:postgres .
89 mkdir -p ${CCACHE_DIR}
90 chown -R postgres:postgres ${CCACHE_DIR}
91 echo '* - memlock 134217728' > /etc/security/limits.d/postgres.conf
92 su postgres -c "ulimit -l -H && ulimit -l -S"
93 # Can't change container's kernel.core_pattern. Postgres user can't write
94 # to / normally. Change that.
102 --auto-features=disabled \
103 -Dtap_tests=enabled \
108 ninja -C build -j${BUILD_JOBS}
110 upload_caches: ccache
112 # Run a minimal set of tests. The main regression tests take too long for
113 # this purpose. For now this is a random quick pg_regress style test, and a
114 # tap test that exercises both a frontend binary and the backend.
115 test_minimal_script: |
118 meson test $MTEST_ARGS --num-processes ${TEST_JOBS} \
119 tmp_install cube/regress pg_ctl/001_start_stop
123 <<: *on_failure_meson
125 mkdir -m 770 /tmp/cores
126 find / -maxdepth 1 -type f -name 'core*' -exec mv '{}' /tmp/cores/ \;
127 src/tools/ci/cores_backtrace.sh linux /tmp/cores
131 name: FreeBSD - 13 - Meson
134 # FreeBSD on GCP is slow when running with larger number of CPUS /
135 # jobs. Using one more job than cpus seems to work best.
140 CCACHE_DIR: /tmp/ccache_dir
141 CPPFLAGS: -DRELCACHE_FORCE_RELEASE -DCOPY_PARSE_PLAN_TREES -DWRITE_READ_PARSE_PLAN_TREES -DRAW_EXPRESSION_COVERAGE_TEST
144 depends_on: SanityCheck
145 only_if: $CIRRUS_CHANGE_MESSAGE !=~ '.*\nci-os-only:.*' || $CIRRUS_CHANGE_MESSAGE =~ '.*\nci-os-only:[^\n]*freebsd.*'
147 compute_engine_instance:
148 image_project: $IMAGE_PROJECT
149 image: family/pg-ci-freebsd-13
158 ulimit -a -H && ulimit -a -S
163 # Workaround around performance issues due to 32KB block size
164 repartition_script: src/tools/ci/gcp_freebsd_repartition.sh
165 create_user_script: |
167 chown -R postgres:postgres .
168 mkdir -p ${CCACHE_DIR}
169 chown -R postgres:postgres ${CCACHE_DIR}
170 setup_core_files_script: |
171 mkdir -m 770 /tmp/cores
172 chown root:postgres /tmp/cores
173 sysctl kern.corefile='/tmp/cores/%N.%P.core'
174 setup_additional_packages_script: |
177 # NB: Intentionally build without -Dllvm. The freebsd image size is already
178 # large enough to make VM startup slow, and even without llvm freebsd
179 # already takes longer than other platforms except for windows.
184 -Dcassert=true -Dssl=openssl -Duuid=bsd -Dtcl_version=tcl86 -Ddtrace=auto \
185 -DPG_TEST_EXTRA="$PG_TEST_EXTRA" \
186 -Dextra_lib_dirs=/usr/local/lib -Dextra_include_dirs=/usr/local/include/ \
189 build_script: su postgres -c 'ninja -C build -j${BUILD_JOBS}'
190 upload_caches: ccache
195 meson test $MTEST_ARGS --num-processes ${TEST_JOBS}
198 # test runningcheck, freebsd chosen because it's currently fast enough
199 test_running_script: |
203 meson test $MTEST_ARGS --quiet --suite setup
204 export LD_LIBRARY_PATH="$(pwd)/build/tmp_install/usr/local/pgsql/lib/:$LD_LIBRARY_PATH"
205 mkdir -p build/testrun
206 build/tmp_install/usr/local/pgsql/bin/initdb -N build/runningcheck --no-instructions -A trust
207 echo "include '$(pwd)/src/tools/ci/pg_ci_base.conf'" >> build/runningcheck/postgresql.conf
208 build/tmp_install/usr/local/pgsql/bin/pg_ctl -c -o '-c fsync=off' -D build/runningcheck -l build/testrun/runningcheck.log start
209 meson test $MTEST_ARGS --num-processes ${TEST_JOBS} --setup running
210 build/tmp_install/usr/local/pgsql/bin/pg_ctl -D build/runningcheck stop
214 <<: *on_failure_meson
215 cores_script: src/tools/ci/cores_backtrace.sh freebsd /tmp/cores
218 # configure feature flags, shared between the task running the linux tests and
219 # the CompilerWarnings task
220 LINUX_CONFIGURE_FEATURES: &LINUX_CONFIGURE_FEATURES >-
234 --with-tcl --with-tclconfig=/usr/lib/tcl8.6/
238 LINUX_MESON_FEATURES: &LINUX_MESON_FEATURES >-
248 TEST_JOBS: 8 # experimentally derived to be a decent choice
250 CCACHE_DIR: /tmp/ccache_dir
251 DEBUGINFOD_URLS: "https://debuginfod.debian.net"
253 # Enable a reasonable set of sanitizers. Use the linux task for that, as
254 # it one of the fastest tasks (without sanitizers). Also several of the
255 # sanitizers work best on linux.
257 # The overhead of alignment sanitizer is low, undefined behaviour has
258 # moderate overhead. Test alignment sanitizer in the meson task, as it
259 # does both 32 and 64 bit builds and is thus more likely to expose
262 # Address sanitizer in contrast is somewhat expensive. Enable it in the
263 # autoconf task, as the meson task tests both 32 and 64bit.
265 # disable_coredump=0, abort_on_error=1: for useful backtraces in case of crashes
266 # print_stacktraces=1,verbosity=2, duh
267 # detect_leaks=0: too many uninteresting leak errors in short-lived binaries
268 UBSAN_OPTIONS: print_stacktrace=1:disable_coredump=0:abort_on_error=1:verbosity=2
269 ASAN_OPTIONS: print_stacktrace=1:disable_coredump=0:abort_on_error=1:detect_leaks=0
271 # SANITIZER_FLAGS is set in the tasks below
272 CFLAGS: -Og -ggdb -fno-sanitize-recover=all $SANITIZER_FLAGS
274 LDFLAGS: $SANITIZER_FLAGS
278 LINUX_CONFIGURE_FEATURES: *LINUX_CONFIGURE_FEATURES
279 LINUX_MESON_FEATURES: *LINUX_MESON_FEATURES
281 depends_on: SanityCheck
282 only_if: $CIRRUS_CHANGE_MESSAGE !=~ '.*\nci-os-only:.*' || $CIRRUS_CHANGE_MESSAGE =~ '.*\nci-os-only:[^\n]*linux.*'
284 compute_engine_instance:
285 image_project: $IMAGE_PROJECT
286 image: family/pg-ci-bullseye
292 folder: ${CCACHE_DIR}
298 ulimit -a -H && ulimit -a -S
300 create_user_script: |
302 chown -R postgres:postgres .
303 mkdir -p ${CCACHE_DIR}
304 chown -R postgres:postgres ${CCACHE_DIR}
305 echo '* - memlock 134217728' > /etc/security/limits.d/postgres.conf
306 su postgres -c "ulimit -l -H && ulimit -l -S"
307 setup_core_files_script: |
308 mkdir -m 770 /tmp/cores
309 chown root:postgres /tmp/cores
310 sysctl kernel.core_pattern='/tmp/cores/%e-%s-%p.core'
311 setup_additional_packages_script: |
313 #DEBIAN_FRONTEND=noninteractive apt-get -y install ...
316 - name: Linux - Debian Bullseye - Autoconf
319 SANITIZER_FLAGS: -fsanitize=address
324 --enable-cassert --enable-debug --enable-tap-tests \
326 --with-segsize-blocks=8 \
328 ${LINUX_CONFIGURE_FEATURES} \
332 build_script: su postgres -c "make -s -j${BUILD_JOBS} world-bin"
333 upload_caches: ccache
337 ulimit -c unlimited # default is 0
338 make -s ${CHECK} ${CHECKFLAGS} -j${TEST_JOBS}
344 - name: Linux - Debian Bullseye - Meson
347 CCACHE_MAXSIZE: "400M" # tests two different builds
348 SANITIZER_FLAGS: -fsanitize=alignment,undefined
355 ${LINUX_MESON_FEATURES} \
356 -DPG_TEST_EXTRA="$PG_TEST_EXTRA" \
360 # Also build & test in a 32bit build - it's gotten rare to test that
362 configure_32_script: |
364 export CC='ccache gcc -m32'
368 ${LINUX_MESON_FEATURES} \
370 --pkg-config-path /usr/lib/i386-linux-gnu/pkgconfig/ \
371 -DPERL=perl5.32-i386-linux-gnu \
372 -DPG_TEST_EXTRA="$PG_TEST_EXTRA" \
376 build_script: su postgres -c 'ninja -C build -j${BUILD_JOBS}'
377 build_32_script: su postgres -c 'ninja -C build-32 -j${BUILD_JOBS}'
379 upload_caches: ccache
384 meson test $MTEST_ARGS --num-processes ${TEST_JOBS}
386 # so that we don't upload 64bit logs if 32bit fails
389 # There's currently no coverage of icu with LANG=C in the buildfarm. We
390 # can easily provide some here by running one of the sets of tests that
391 # way. Newer versions of python insist on changing the LC_CTYPE away
392 # from C, prevent that with PYTHONCOERCECLOCALE.
393 test_world_32_script: |
396 PYTHONCOERCECLOCALE=0 LANG=C meson test $MTEST_ARGS -C build-32 --num-processes ${TEST_JOBS}
400 <<: *on_failure_meson
403 cores_script: src/tools/ci/cores_backtrace.sh linux /tmp/cores
407 name: macOS - Monterey - Meson
410 CPUS: 12 # always get that much for cirrusci macOS instances
412 # Test performance regresses noticably when using all cores. 8 seems to
414 # https://postgr.es/m/20220927040208.l3shfcidovpzqxfh%40awork3.anarazel.de
417 CIRRUS_WORKING_DIR: ${HOME}/pgsql/
418 CCACHE_DIR: ${HOME}/ccache
419 HOMEBREW_CACHE: ${HOME}/homebrew-cache
420 PERL5LIB: ${HOME}/perl5/lib/perl5
424 CPPFLAGS: -DRANDOMIZE_ALLOCATED_MEMORY
428 depends_on: SanityCheck
429 only_if: $CIRRUS_CHANGE_MESSAGE !=~ '.*\nci-os-only:.*' || $CIRRUS_CHANGE_MESSAGE =~ '.*\nci-os-only:[^\n]*(macos|darwin|osx).*'
437 ulimit -a -H && ulimit -a -S
440 setup_core_files_script:
441 - mkdir ${HOME}/cores
442 - sudo sysctl kern.corefile="${HOME}/cores/core.%P"
447 - perl -mIPC::Run -e 1 || cpan -T IPC::Run
448 - perl -mIO::Pty -e 1 || cpan -T IO::Pty
452 # XXX: Could we instead install homebrew into a cached directory? The
453 # homebrew installation takes a good bit of time every time, even if the
454 # packages do not need to be downloaded.
456 folder: $HOMEBREW_CACHE
457 setup_additional_packages_script: |
472 brew cleanup -s # to reduce cache size
473 upload_caches: homebrew
478 brewpath="/usr/local"
479 PKG_CONFIG_PATH="${brewpath}/lib/pkgconfig:${PKG_CONFIG_PATH}"
481 for pkg in icu4c krb5 openldap openssl zstd ; do
482 pkgpath="${brewpath}/opt/${pkg}"
483 PKG_CONFIG_PATH="${pkgpath}/lib/pkgconfig:${PKG_CONFIG_PATH}"
484 PATH="${pkgpath}/bin:${pkgpath}/sbin:$PATH"
487 export PKG_CONFIG_PATH PATH
491 -Dextra_include_dirs=${brewpath}/include \
492 -Dextra_lib_dirs=${brewpath}/lib \
494 -Dssl=openssl -Duuid=e2fs -Ddtrace=auto \
496 -DPG_TEST_EXTRA="$PG_TEST_EXTRA" \
499 build_script: ninja -C build -j${BUILD_JOBS}
500 upload_caches: ccache
503 ulimit -c unlimited # default is 0
504 ulimit -n 1024 # default is 256, pretty low
505 meson test $MTEST_ARGS --num-processes ${TEST_JOBS}
508 <<: *on_failure_meson
509 cores_script: src/tools/ci/cores_backtrace.sh macos "${HOME}/cores"
512 WINDOWS_ENVIRONMENT_BASE: &WINDOWS_ENVIRONMENT_BASE
514 # Half the allowed per-user CPU cores
517 # The default cirrus working dir is in a directory msbuild complains about
518 CIRRUS_WORKING_DIR: "c:/cirrus"
519 # git's tar doesn't deal with drive letters, see
520 # https://postgr.es/m/b6782dc3-a7b0-ed56-175f-f8f54cb08d67%40dunslane.net
521 TAR: "c:/windows/system32/tar.exe"
522 # Avoids port conflicts between concurrent tap test runs
523 PG_TEST_USE_UNIX_SOCKETS: 1
524 PG_REGRESS_SOCK_DIR: "c:/cirrus/"
529 powershell -Command get-psdrive -psprovider filesystem
534 name: Windows - Server 2019, VS 2019 - Meson & ninja
535 << : *WINDOWS_ENVIRONMENT_BASE
538 TEST_JOBS: 8 # wild guess, data based value welcome
540 # Cirrus defaults to SetErrorMode(SEM_NOGPFAULTERRORBOX | ...). That
541 # prevents crash reporting from working unless binaries do SetErrorMode()
542 # themselves. Furthermore, it appears that either python or, more likely,
543 # the C runtime has a bug where SEM_NOGPFAULTERRORBOX can very
544 # occasionally *trigger* a crash on process exit - which is hard to debug,
545 # given that it explicitly prevents crash dumps from working...
546 # 0x8001 is SEM_FAILCRITICALERRORS | SEM_NOOPENFILEERRORBOX
547 CIRRUS_WINDOWS_ERROR_MODE: 0x8001
549 depends_on: SanityCheck
550 only_if: $CIRRUS_CHANGE_MESSAGE !=~ '.*\nci-os-only:.*' || $CIRRUS_CHANGE_MESSAGE =~ '.*\nci-os-only:[^\n]*windows.*'
553 image: $CONTAINER_REPO/windows_ci_vs_2019:latest
557 setup_additional_packages_script: |
558 REM choco install -y --no-progress ...
560 # Use /DEBUG:FASTLINK to avoid high memory usage during linking
563 meson setup --backend ninja --buildtype debug -Dc_link_args=/DEBUG:FASTLINK -Dcassert=true -Db_pch=true -Dssl=openssl -Dextra_lib_dirs=c:\openssl\1.1\lib -Dextra_include_dirs=c:\openssl\1.1\include -DTAR=%TAR% -DPG_TEST_EXTRA="%PG_TEST_EXTRA%" build
569 check_world_script: |
571 meson test %MTEST_ARGS% --num-processes %TEST_JOBS%
574 <<: *on_failure_meson
576 path: "crashlog-*.txt"
581 << : *WINDOWS_ENVIRONMENT_BASE
582 name: Windows - Server 2019, MinGW64 - Meson
584 # due to resource constraints we don't run this task by default for now
586 # worth using only_if despite being manual, otherwise this task will show up
587 # when e.g. ci-os-only: linux is used.
588 only_if: $CIRRUS_CHANGE_MESSAGE !=~ '.*\nci-os-only:.*' || $CIRRUS_CHANGE_MESSAGE =~ '.*\nci-os-only:[^\n]*mingw.*'
589 # otherwise it'll be sorted before other tasks
590 depends_on: SanityCheck
593 image: $CONTAINER_REPO/windows_ci_mingw64:latest
598 TEST_JOBS: 4 # higher concurrency causes occasional failures
599 CCACHE_DIR: C:/msys64/ccache
600 CCACHE_MAXSIZE: "500M"
601 CCACHE_SLOPPINESS: pch_defines,time_macros
603 # for some reason mingw plpython cannot find it's installation without this
604 PYTHONHOME: C:/msys64/ucrt64
605 # prevents MSYS bash from resetting error mode
607 # Start bash in current working directory
609 BASH: C:\msys64\usr\bin\bash.exe -l
612 folder: ${CCACHE_DIR}
614 setup_additional_packages_script: |
615 REM C:\msys64\usr\bin\pacman.exe -S --noconfirm ...
618 %BASH% -c "where gcc"
619 %BASH% -c "gcc --version"
620 %BASH% -c "where perl"
621 %BASH% -c "perl --version"
623 # disable -Dnls as the number of files it creates cause a noticable slowdown
625 %BASH% -c "meson setup -Ddebug=true -Doptimization=g -Dcassert=true -Db_pch=true -Dnls=disabled -DTAR=%TAR% build"
628 %BASH% -c "ninja -C build"
630 upload_caches: ccache
633 %BASH% -c "meson test %MTEST_ARGS% --num-processes %TEST_JOBS%"
636 <<: *on_failure_meson
638 path: "crashlog-*.txt"
643 name: CompilerWarnings
645 # To limit unnecessary work only run this once the SanityCheck
646 # succeeds. This is particularly important for this task as we intentionally
647 # use always: to continue after failures. Task that did not run count as a
648 # success, so we need to recheck SanityChecks's condition here ...
649 depends_on: SanityCheck
650 only_if: $CIRRUS_CHANGE_MESSAGE !=~ '.*\nci-os-only:.*'
656 # Use larger ccache cache, as this task compiles with multiple compilers /
658 CCACHE_MAXSIZE: "1GB"
659 CCACHE_DIR: "/tmp/ccache_dir"
661 LINUX_CONFIGURE_FEATURES: *LINUX_CONFIGURE_FEATURES
662 LINUX_MESON_FEATURES: *LINUX_MESON_FEATURES
665 image: $CONTAINER_REPO/linux_debian_bullseye_ci:latest
672 ulimit -a -H && ulimit -a -S
680 setup_additional_packages_script: |
682 #DEBIAN_FRONTEND=noninteractive apt-get -y install ...
685 # Test that code can be built with gcc/clang without warnings
688 setup_script: echo "COPT=-Werror" > src/Makefile.custom
690 # Trace probes have a history of getting accidentally broken. Use the
691 # different compilers to build with different combinations of dtrace on/off
692 # and cassert on/off.
694 # gcc, cassert off, dtrace on
696 gcc_warning_script: |
700 ${LINUX_CONFIGURE_FEATURES} \
701 CC="ccache gcc" CXX="ccache g++" CLANG="ccache clang"
702 make -s -j${BUILD_JOBS} clean
703 time make -s -j${BUILD_JOBS} world-bin
705 # gcc, cassert on, dtrace off
707 gcc_a_warning_script: |
711 ${LINUX_CONFIGURE_FEATURES} \
712 CC="ccache gcc" CXX="ccache g++" CLANG="ccache clang"
713 make -s -j${BUILD_JOBS} clean
714 time make -s -j${BUILD_JOBS} world-bin
716 # clang, cassert off, dtrace off
718 clang_warning_script: |
720 --cache clang.cache \
721 ${LINUX_CONFIGURE_FEATURES} \
722 CC="ccache clang" CXX="ccache clang++" CLANG="ccache clang"
723 make -s -j${BUILD_JOBS} clean
724 time make -s -j${BUILD_JOBS} world-bin
726 # clang, cassert on, dtrace on
728 clang_a_warning_script: |
730 --cache clang.cache \
733 ${LINUX_CONFIGURE_FEATURES} \
734 CC="ccache clang" CXX="ccache clang++" CLANG="ccache clang"
735 make -s -j${BUILD_JOBS} clean
736 time make -s -j${BUILD_JOBS} world-bin
738 # cross-compile to windows
740 mingw_cross_warning_script: |
742 --host=x86_64-w64-mingw32 \
744 CC="ccache x86_64-w64-mingw32-gcc" \
745 CXX="ccache x86_64-w64-mingw32-g++"
746 make -s -j${BUILD_JOBS} clean
747 time make -s -j${BUILD_JOBS} world-bin
750 # Verify docs can be built
752 # XXX: Only do this if there have been changes in doc/ since last build
760 make -s -j${BUILD_JOBS} clean
761 time make -s -j${BUILD_JOBS} -C doc
764 # Verify headerscheck / cpluspluscheck succeed
766 # - Don't use ccache, the files are uncacheable, polluting ccache's
768 # - Use -fmax-errors, as particularly cpluspluscheck can be very verbose
769 # - XXX have to disable ICU to avoid errors:
770 # https://postgr.es/m/20220323002024.f2g6tivduzrktgfa%40alap3.anarazel.de
773 headers_headerscheck_script: |
775 ${LINUX_CONFIGURE_FEATURES} \
778 CC="gcc" CXX"=g++" CLANG="clang"
779 make -s -j${BUILD_JOBS} clean
780 time make -s headerscheck EXTRAFLAGS='-fmax-errors=10'
781 headers_cpluspluscheck_script: |
782 time make -s cpluspluscheck EXTRAFLAGS='-fmax-errors=10'
785 upload_caches: ccache