xref: /petsc/.gitlab-ci.yml (revision f61fa1bf5c611e7ec88fe6b5dab8a7d00ec7cf33) 
1#
2# stage-1 take only a few minutes; they do not run the full test suite or external packages.
3#
4# stage-2 runs on MCS systems and may take 10 to 15 minutes. They run the full test suite but with limited mixture of external packages
5#
6# stage-3 runs on MCS systems and may take an hour or more. They run the full test suite and heavily test external packages, utilize valgrind etc
7#
8# The stage-(n) tests are only started if all of the stage-(n-1) tests run without error
9#   You can limit the testing by using the variable STAGE with value 1 or 2
10#
11
12stages:
13  - stage-1
14  - stage-2
15  - stage-3
16  - stage-4
17variables:
18  GIT_STRATEGY: fetch
19  GIT_CLEAN_FLAGS: -ffdxq
20  TIMEOUT: 450
21  BASE_EXTRA_OPTIONS: -nox -nox_warning -malloc_dump
22  UCX_LOG_LEVEL: error
23
24#
25# The most basic template that most tests will expand upon
26#
27
28.test-basic:
29  interruptible: true
30  only:
31    refs:
32      #     Set with CI/CD Shedules - New Schedule
33      - schedules
34      - api
35      #     Set with CI/CD Pipelines - Run Pipeline
36      - web
37      - merge_requests
38  dependencies: []
39
40.test:
41  extends: .test-basic
42  except:
43    variables:
44      # Skip if the docs-only label is attached to a merge request
45      - $CI_MERGE_REQUEST_LABELS =~ /(^|,)docs-only($|,)/
46      - $PETSC_CI_SCHEDULED =~ /yes/
47
48check-ci-settings:
49  extends: .test-basic
50  stage: .pre
51  tags:
52    - gce-stage1
53  script:
54    - lib/petsc/bin/maint/check-ci-settings.sh
55
56#
57#  This provides the basic order of operations and options template for cloud based stage 1 tests.
58#  Not all test-short need to follow this template but most will.
59#
60
61.stage-1:
62  extends: .test
63  stage: stage-1
64  tags:
65    - gce-u22-stage1
66  before_script:
67    - date
68    - hostname
69    - grep PRETTY_NAME /etc/os-release
70    - nproc
71    - lscpu
72    - ccache --zero-stats
73  script:
74    - if [ ! -z ${LOAD_MODULES+x} ]; then module --trace load ${LOAD_MODULES}; module list; fi
75    - if [ ! -z ${INIT_SCRIPT+x} ]; then echo "sourcing ${INIT_SCRIPT}"; if [ -f ${HOME}/${INIT_SCRIPT} ]; then source ${HOME}/${INIT_SCRIPT}; else source ${INIT_SCRIPT}; fi; fi
76    - printf "PATH:$PATH\n"
77    - printf "PYTHONPATH:$PYTHONPATH\n"
78    - printf "python:${PYTHON}\n"
79    - ${PYTHON} -m pip list --user
80    - printf "CONFIG_OPTS:${CONFIG_OPTS}\n"
81    - printf "EXTRA_OPTIONS_INITIAL:$EXTRA_OPTIONS_INITIAL $BASE_EXTRA_OPTIONS\n"
82    - printf "MODULEPATH:$MODULEPATH\n"
83    - if [ ! -z ${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME+x} ]; then printf "CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME\n" ;fi
84    - ${PYTHON} ./configure --with-debugging=0 COPTFLAGS='-O3 -march=native' CXXOPTFLAGS='-O3 -march=native' FOPTFLAGS='-O3 -march=native' ${CONFIG_OPTS}
85    - make CFLAGS="${MAKE_CFLAGS}" CXXFLAGS="${MAKE_CXXFLAGS}" FFLAGS="${MAKE_FFLAGS}" CUDAFLAGS="${MAKE_CUDAFLAGS}"
86    - if [ ! -z ${ENABLE_CHECK+x} ]; then make CFLAGS="${MAKE_CFLAGS}" CXXFLAGS="${MAKE_CXXFLAGS}" FFLAGS="${MAKE_FFLAGS}" CUDAFLAGS="${MAKE_CUDAFLAGS}" EXTRA_OPTIONS_INITIAL="${EXTRA_OPTIONS_INITIAL} ${BASE_EXTRA_OPTIONS}" check; fi
87    - make CFLAGS="${MAKE_TEST_CFLAGS}" CXXFLAGS="${MAKE_TEST_CXXFLAGS}" FFLAGS="${MAKE_TEST_FFLAGS}" CUDAFLAGS="${MAKE_CUDAFLAGS}" EXTRA_OPTIONS_INITIAL="${EXTRA_OPTIONS_INITIAL} ${BASE_EXTRA_OPTIONS}" allgtests-tap gmakesearch="${TEST_SEARCH}" TIMEOUT=${TIMEOUT}
88    - if [ ! -z ${ENABLE_COMPILETESTS+x} ]; then make -j 16 CFLAGS="${MAKE_TEST_CFLAGS}" CXXFLAGS="${MAKE_TEST_CXXFLAGS}" FFLAGS="${MAKE_TEST_FFLAGS}" EXTRA_OPTIONS_INITIAL="${EXTRA_OPTIONS_INITIAL} ${BASE_EXTRA_OPTIONS}" test PRINTONLY=1; fi
89  variables:
90    PYTHON: python3
91    MAKE_CFLAGS: -Werror -Wmissing-field-initializers
92    MAKE_CXXFLAGS: -Werror -Wzero-as-null-pointer-constant
93    MAKE_FFLAGS: -Werror -fimplicit-none
94    MAKE_TEST_CFLAGS: -Werror
95    MAKE_TEST_CXXFLAGS: -Werror
96    MAKE_TEST_FFLAGS: -Werror
97  after_script:
98    - date
99    - ccache --show-stats
100  artifacts:
101    reports:
102      junit: arch-*/tests/testresults.xml
103    name: "$CI_JOB_NAME"
104    when: always
105    paths:
106      - arch-*/lib/petsc/conf/*.log
107      - arch-*/lib/pkgconfig/petsc.pc
108      - arch-*/tests/testresults.xml
109      - arch-*/tests/test_*_tap.log
110      - arch-*/tests/test_*_err.log
111    expire_in: 4 days
112
113#
114# The following tests run on the cloud as part of stage-1.
115#
116
117ompi-cuda:
118  extends: .stage-1
119  tags:
120    - cuda-stage1
121  variables:
122    CONFIG_OPTS: --with-mpi-dir=/nfs/gce/software/custom/linux-ubuntu22.04-x86_64/spack/opt/spack/linux-ubuntu22.04-x86_64/gcc-11.3.0/openmpi-4.1.3-qrpnszy --with-cuda=1 --with-cuda-arch=all-major --CUDAPPFLAGS=-Wno-deprecated-gpu-targets --with-fc=0
123    TEST_SEARCH: snes_tutorials-ex19_cuda%
124    ENABLE_CHECK: 1
125    MAKE_CXXFLAGS: -Werror
126    MAKE_CUDAFLAGS: -Xcompiler -Wall -Xcompiler -Werror
127
128mpich-cxx-py3:
129  extends: .stage-1
130  variables:
131    CONFIG_OPTS: --with-clanguage=cxx --with-fc=0 CXXFLAGS=-std=c++11 --with-strict-petscerrorcode
132    TEST_SEARCH: snes_tutorials-ex48%
133    LOAD_MODULES: gcc/12.1.0 mpich/4.1-gcc-12.1.0
134
135mpich-cxx-mlib:
136  extends: .stage-1
137  variables:
138    CONFIG_OPTS: --with-clanguage=cxx --with-single-library=0 --with-log=0 --with-info=0 --with-ctable=0 --with-is-color-value-type=short CXXFLAGS=-std=c++14
139    TEST_SEARCH: snes_tutorials-ex48%
140    LOAD_MODULES: gcc/12.1.0 mpich/4.1-gcc-12.1.0
141
142uni-complex-float-int64:
143  extends: .stage-1
144  variables:
145    CONFIG_OPTS: --with-mpi=0 --with-scalar-type=complex --with-precision=single --with-64-bit-indices
146    TEST_SEARCH: ts_tutorials-ex11_adv_2d_quad_%
147    LOAD_MODULES: gcc/12.1.0
148
149c99-mlib-static-py:
150  extends: .stage-1
151  variables:
152    CONFIG_OPTS: --with-single-library=0 --with-shared-libraries=0 --with-strict-petscerrorcode CFLAGS=-std=c99 FFLAGS=="-ffree-line-length-none -ffree-line-length-0" CXXFLAGS=
153    ENABLE_CHECK: 1
154    TEST_SEARCH: snes_tutorials-ex19% snes_tutorials-ex5f90t%
155    MAKE_TEST_FFLAGS: -Werror -std=f2008
156    LOAD_MODULES: gcc/12.1.0 mpich/4.1-gcc-12.1.0
157
158clang-uni:
159  extends: .stage-1
160  variables:
161    CONFIG_OPTS: --with-cc=clang --with-cxx=clang++ --with-mpi=0 --with-strict-petscerrorcode FPPFLAGS=-fsecond-underscore
162    MAKE_CFLAGS: -Werror -Wmissing-field-initializers -Wundef -Wextra-semi-stmt
163    MAKE_CXXFLAGS: -Werror -Wzero-as-null-pointer-constant -Wundef -Wextra-semi-stmt -Wextra-semi
164    MAKE_TEST_CFLAGS: -Werror -Wmissing-field-initializers -Wundef -Wextra-semi-stmt
165    MAKE_TEST_CXXFLAGS: -Werror -Wzero-as-null-pointer-constant -Wundef -Wextra-semi-stmt -Wextra-semi
166    TEST_SEARCH: snes_tutorials-ex48% snes_tutorials-ex5f%
167    ENABLE_COMPILETESTS: 1
168
169gcc-lto:
170  extends: .stage-1
171  variables:
172    CONFIG_OPTS: CFLAGS= CXXFLAGS= FFLAGS="-ffree-line-length-none -ffree-line-length-0"
173    MAKE_CFLAGS: -Werror -flto=4 -Werror=odr -Werror=lto-type-mismatch
174    MAKE_CXXFLAGS: -Werror -Wextra-semi -flto=4 -Werror=odr -Werror=lto-type-mismatch
175    MAKE_FFLAGS: -Werror -flto=4 -Werror=odr -Werror=lto-type-mismatch
176    TEST_SEARCH: snes_tutorials-ex19% snes_tutorials-ex5f%
177    LOAD_MODULES: gcc/12.1.0 mpich/4.1-gcc-12.1.0
178
179petsc4py-install:
180  extends: .stage-2
181  tags:
182    - gce-u22-stage1
183  variables:
184    PYTHON: python3
185    T_PREFIX: petsc-install
186    T_DESTDIR: petsc-destdir
187    T_PETSC4PY: src/binding/petsc4py
188    T_VALIDATE_CMD: lib/petsc/bin/maint/validate-petsc4py.sh
189  script:
190    - printf "PATH:$PATH\n"
191    - mkdir hide
192    - if [ ! -z ${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME+x} ]; then printf "CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME\n" ;fi
193    - ${PYTHON} ./configure --prefix="${PWD}/${T_PREFIX}" --with-petsc4py=1 --with-debugging=0
194    - make CFLAGS=-Werror CXXFLAGS="-Werror -Wzero-as-null-pointer-constant" FFLAGS=-Werror
195    - printf "====== Test A. Install into staging directory then into prefix directory (mimics distro package recipe) =====\n"
196    - make install DESTDIR="${PWD}/${T_DESTDIR}"
197    - test "$(find ${PWD}/${T_PREFIX} -mindepth 1 | wc -l)" -eq 0
198    - test "$(find ${PWD}/${T_DESTDIR} -mindepth 1 | wc -l)" -gt 0
199    - (cd "${PWD}/${T_DESTDIR}" && find * -exec install -v -D "{}" "/{}" \; )
200    - mv arch-* hide/ && PETSC_DIR="${PWD}/${T_PREFIX}" ${T_VALIDATE_CMD} && mv hide/arch-* ./
201    - rm -r "${PWD}/${T_PREFIX}" "${PWD}/${T_DESTDIR}" && mkdir "${PWD}/${T_PREFIX}"
202    - printf "====== Test B. Install directly into prefix directory =====\n"
203    - make install
204    - test "$(find ${PWD}/${T_PREFIX} -mindepth 1 | wc -l)" -gt 0
205    - mv arch-* hide/ && PETSC_DIR="${PWD}/${T_PREFIX}" ${T_VALIDATE_CMD} && mv hide/arch-* ./
206    - rm -r "${PWD}/${T_PREFIX}"/*/petsc4py*
207    - printf "====== Test C. Install manually with setuptools =====\n"
208    - export PETSC_DIR="${PWD}/${T_PREFIX}" && (cd "${T_PETSC4PY}" && ${PYTHON} setup.py build)
209    - export PETSC_DIR="${PWD}/${T_PREFIX}" P="${PWD}" && (cd "${T_PETSC4PY}" && ${PYTHON} setup.py install --install-lib="${P}/${T_PREFIX}/lib")
210    - mv arch-* hide/ && PETSC_DIR="${PWD}/${T_PREFIX}" ${T_VALIDATE_CMD} && mv hide/arch-* ./
211    - rm -r "${PWD}/${T_PREFIX}"/*/petsc4py*
212    - printf "====== Test D. Install manually with setuptools with staging =====\n"
213    - export PETSC_DIR="${PWD}/${T_PREFIX}" P="${PWD}" && (cd "${T_PETSC4PY}" && ${PYTHON} setup.py install --root="${P}/${T_DESTDIR}" --install-lib="${P}/${T_PREFIX}/lib")
214    - (cd "${PWD}/${T_DESTDIR}" && find * -exec install -v -D "{}" "/{}" \; )
215    - mv arch-* hide/ && PETSC_DIR="${PWD}/${T_PREFIX}" ${T_VALIDATE_CMD} && mv hide/arch-* ./
216
217petsc4py-pip:
218  extends: .stage-2
219  tags:
220    - gce-u22-stage1
221  variables:
222    PETSC_CONFIGURE_OPTIONS: --with-mpi=0 --with-fc=0
223    CFLAGS: -O0
224  script:
225    - python3 -m venv pip-builds
226    - source pip-builds/bin/activate
227    - python -m pip install --upgrade pip
228    - unset PETSC_DIR PETSC_ARCH
229    - export PIP_WHEEL_DIR="${PWD}/wheelhouse"
230    - export PIP_FIND_LINKS="${PIP_WHEEL_DIR}"
231    - mkdir -p "${PIP_WHEEL_DIR}"
232    - python -m pip wheel .
233    - python -m pip wheel src/binding/petsc4py
234    - python -m pip install --pre --no-index --no-cache-dir petsc4py
235    - python -m pip list
236    - python -m petsc --prefix
237    - python -m petsc4py
238
239checksource:
240  extends: .test-basic
241  stage: .pre
242  tags:
243    - gce-u22-stage1
244  script:
245    - python3 ./configure --with-mpi=0 --with-fc=0 --with-cxx=0 --with-x=0 --with-bison=0 --with-cmake=0 --with-pthread=0 --with-regex=0
246    - vermin --version
247    - make vermin
248    - PATH=/nfs/gce/projects/petsc/soft/u22.04/spack-2025-08-26-llvm/opt/spack/linux-x86_64/llvm-21.1.0-yu5atp22wbrkzn6ia3vqu5lsaw57ejnn/bin:$PATH make checkclangformat SHELL=bash
249    - make checkbadSource SHELL=bash
250    - make checkbadFileChange SHELL=bash
251    - make -f gmakefile check_output SHELL=bash
252    - make check_petsc4py_rst
253    - make -C src/binding/petsc4py lint
254  artifacts:
255    name: "$CI_JOB_NAME"
256    when: always
257    paths:
258      - arch-*/lib/petsc/conf/*.patch
259      - arch-*/lib/petsc/conf/*.log
260    expire_in: 4 days
261
262pause-for-approval:
263  extends: .test
264  stage: .pre
265  tags:
266    - gce-stage1
267  only:
268    refs:
269      - merge_requests
270    variables:
271      - $CI_MERGE_REQUEST_EVENT_TYPE == "merged_result"
272      - $CI_MERGE_REQUEST_EVENT_TYPE == "detached"
273  script:
274    - echo "pause-for-approval has no script to run"
275  variables:
276    GIT_STRATEGY: none
277  when: manual
278  allow_failure: false
279
280#
281# Basic template for code coverage generation. Tests should additionally inherit from the more
282# specialized OS-specific versions instead of this one.
283#
284
285.coverage-generate:
286  variables:
287    RUN_GCOV: 1
288    RUN_GCOV_OPTIONS: --decisions
289
290.coverage-disable:
291  variables:
292    RUN_GCOV: 0
293
294#
295# This provides the basic order of operations and options template for stage-2,3 tests.
296# Not all stage-2,3 need to follow this template, but most will.
297#
298.stage-23:
299  extends:
300    - .test
301    - .coverage-generate
302  script:
303    - if [ ! -z ${LOAD_MODULES+x} ]; then module --trace load ${LOAD_MODULES}; module list; fi
304    - if [ ! -z ${GCOV_MODULES+x} ]; then module --trace load ${GCOV_MODULES}; module list; fi
305    - if [ ! -z ${INIT_SCRIPT+x} ]; then echo "sourcing ${INIT_SCRIPT}"; if [ -f ${HOME}/${INIT_SCRIPT} ]; then source ${HOME}/${INIT_SCRIPT}; else source ${INIT_SCRIPT}; fi; fi
306    - if [ "${RUN_GCOV}" == 1 ]; then
307      printf "RUN_GCOV_OPTIONS:$RUN_GCOV_OPTIONS\n";
308      gcovr --version;
309      fi
310    - if [ -d ${HOME}/petsc-hash-pkgs/ ]; then find ${HOME}/petsc-hash-pkgs/ -maxdepth 1 -mindepth 1 -type d -mtime +25 -exec touch {} \; -exec rm -rf {} \; ; fi
311    - printf "PATH:$PATH\n"
312    - printf "PYTHONPATH:$PYTHONPATH\n"
313    - printf "EXTRA_OPTIONS_INITIAL:$EXTRA_OPTIONS_INITIAL $BASE_EXTRA_OPTIONS\n"
314    - if [ ! -z ${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME+x} ]; then printf "CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME\n" ;fi
315    - printf "./config/examples/${TEST_ARCH}.py\n"
316    - cat ./config/examples/${TEST_ARCH}.py
317    - ./config/examples/${TEST_ARCH}.py || if [ -f naglicenseproblem ]; then exit 126; else exit 1; fi
318    - make CFLAGS="${MAKE_CFLAGS}" CXXFLAGS="${MAKE_CXXFLAGS}" FFLAGS="${MAKE_FFLAGS}" CUDAFLAGS="${MAKE_CUDAFLAGS}" || if [ -f naglicenseproblem ]; then exit 126; else exit 1; fi
319    - export ASAN_OPTIONS="log_path=stdout:detect_leaks=false" UBSAN_OPTIONS="suppressions=${PWD}/share/petsc/suppressions/ubsan" # only needed for -fsanitize=undefined (but harmless otherwise)
320    - make CFLAGS="${MAKE_CFLAGS}" CXXFLAGS="${MAKE_CXXFLAGS}" FFLAGS="${MAKE_FFLAGS}" CUDAFLAGS="${MAKE_CUDAFLAGS}" EXTRA_OPTIONS_INITIAL="${EXTRA_OPTIONS_INITIAL} ${BASE_EXTRA_OPTIONS}" check || if [ -f naglicenseproblem ]; then exit 126; else exit 1; fi
321    - make updatedatafiles
322    - if [ -z ${DISABLE_PETSC4PY_TESTS+x} ]; then if [ -z ${ENABLE_PETSC4PY_LDPRELOAD+x} ]; then echo "NOT using LD_PRELOAD"; make EXTRA_OPTIONS_INITIAL="${EXTRA_OPTIONS_INITIAL} ${BASE_EXTRA_OPTIONS}" petsc4pytest; else echo "using LD_PRELOAD"; LD_PRELOAD=${PWD}/${TEST_ARCH}/lib/libpetsc.so make EXTRA_OPTIONS_INITIAL="${EXTRA_OPTIONS_INITIAL} ${BASE_EXTRA_OPTIONS}" petsc4pytest; fi; fi
323    - if [ -z ${DISABLE_TESTS+x} ]; then make cleantest && make CFLAGS="${MAKE_CFLAGS}" CXXFLAGS="${MAKE_CXXFLAGS}" FFLAGS="${MAKE_FFLAGS}" CUDAFLAGS="${MAKE_CUDAFLAGS}"  EXTRA_OPTIONS_INITIAL="${EXTRA_OPTIONS_INITIAL} ${BASE_EXTRA_OPTIONS}" allgtests-tap TIMEOUT=${TIMEOUT} ${TEST_OPTS} || if [ -f naglicenseproblem ]; then exit 126; else exit 1; fi; fi
324    - if [ "${RUN_GCOV}" == 1 ]; then make gcov PETSC_GCOV_OPTIONS="${RUN_GCOV_OPTIONS}"; fi
325  artifacts:
326    reports:
327      junit: arch-*/tests/testresults.xml
328    name: "$CI_JOB_NAME"
329    when: always
330    paths:
331      - arch-*/lib/petsc/conf/*.log
332      - arch-*/lib/pkgconfig/petsc.pc
333      - arch-*/tests/testresults.xml
334      - arch-*/tests/test_arch-*_tap.log
335      - arch-*/tests/test_arch-*_err.log
336      - arch-*/arch-*-gcovr-report.json.tar.bz2
337    expire_in: 4 days
338  variables:
339    OPENBLAS_NUM_THREADS: 1
340
341.stage-2:
342  extends: .stage-23
343  stage: stage-2
344
345.stage-3:
346  extends: .stage-23
347  stage: stage-3
348
349#
350# The following provide templates for various OSes for pre/post info
351#
352
353.linux_test_noflags:
354  before_script:
355    - date
356    - hostname
357    - grep PRETTY_NAME /etc/os-release
358    - nproc
359    - lscpu
360    - ccache --zero-stats
361  after_script:
362    - date
363    - ccache --show-stats
364
365.linux_test_nofflags:
366  extends: .linux_test_noflags
367  variables:
368    MAKE_CFLAGS: -Werror
369    MAKE_CXXFLAGS: -Werror
370
371.linux_test:
372  extends: .linux_test_noflags
373  variables:
374    MAKE_CFLAGS: -Werror
375    MAKE_CXXFLAGS: -Werror
376    MAKE_FFLAGS: -Werror
377
378.freebsd_test:
379  extends:
380    - .coverage-disable
381  variables:
382    MAKE_CFLAGS: -Werror
383    MAKE_CXXFLAGS: -Werror
384    MAKE_FFLAGS: -Werror
385  before_script:
386    - date
387    - hostname
388    - freebsd-version
389    - echo $(sysctl -n hw.ncpu)
390    - ccache --zero-stats
391  after_script:
392    - date
393    - ccache --show-stats
394
395.macos_test:
396  variables:
397    MAKE_CFLAGS: -Werror
398    MAKE_CXXFLAGS: -Werror
399    MAKE_FFLAGS: -Werror
400  before_script:
401    - date
402    - hostname
403    - sw_vers -productVersion
404    - echo $(sysctl -n hw.ncpu)
405    - ccache --zero-stats
406  after_script:
407    - date
408    - ccache --show-stats
409
410.mswin_test:
411  extends:
412    - .coverage-disable
413  before_script:
414    - date
415    - hostname
416    - uname -a
417    - nproc
418  after_script:
419    - date
420
421#
422# The following tests run as part of stage-2.
423#
424# The tags variable used in the tests below connects the particular test with the runners
425# listed on the left hand side of https://gitlab.com/petsc/petsc/-/settings/ci_cd.
426# For example the test 'linux-sycl-double' any runner that has the tags 'gce-u22-stage3, linux-fast'
427# (in a blue box beneath it)
428#
429
430macos-arm:
431  extends:
432    - .stage-3
433    - .macos_test
434    - .coverage-disable
435  tags:
436    - os:macos-arm
437  variables:
438    TEST_ARCH: arch-ci-macos-arm
439    EXTRA_OPTIONS_INITIAL: -check_pointer_intensity 0 -error_output_stdout
440    INIT_SCRIPT: .zprofile
441
442freebsd-cxx-cmplx-64idx-dbg:
443  extends:
444    - .stage-2
445    - .freebsd_test
446  tags:
447    - os:fbsd
448  variables:
449    TEST_ARCH: arch-ci-freebsd-cxx-cmplx-64idx-dbg
450
451freebsd-c-single-opt:
452  extends:
453    - .stage-2
454    - .freebsd_test
455  tags:
456    - os:fbsd
457  variables:
458    TEST_ARCH: arch-ci-freebsd-c-single-opt
459
460mswin-opt-impi:
461  extends:
462    - .stage-3
463    - .mswin_test
464  tags:
465    - mswin-stage3
466  variables:
467    TEST_ARCH: arch-ci-mswin-opt-impi
468    TEST_OPTS: search='ksp_ksp_tests*'
469
470linux-gcc-quad-64idx-dbg:
471  extends:
472    - .stage-2
473    - .linux_test
474  tags:
475    - gce-u24-stage2, linux-gcov
476  variables:
477    TEST_ARCH: arch-ci-linux-gcc-quad-64idx-dbg
478
479linux-gcc-pkgs-opt:
480  extends:
481    - .stage-2
482    - .linux_test
483  tags:
484    - gce-u24-stage2, linux-gcov
485  variables:
486    TEST_ARCH: arch-ci-linux-gcc-pkgs-opt
487  except:
488    variables:
489      - $PETSC_CI_SCHEDULED =~ /yes/
490
491linux-gcc-complex-opt-32bit:
492  extends:
493    - .stage-2
494    - .linux_test
495  tags:
496    - gce-u24-stage2, linux-gcov
497  variables:
498    TEST_ARCH: arch-ci-linux-gcc-complex-opt-32bit
499
500linux-emcc:
501  extends:
502    - .stage-2
503    - .linux_test
504    - .coverage-disable
505  tags:
506    - gce-u24-stage2
507  variables:
508    TEST_ARCH: arch-ci-linux-emcc
509    INIT_SCRIPT: /nfs/gce/projects/petsc/soft/u22.04/emsdk/emsdk_env.sh
510    DISABLE_TESTS: 1
511
512#
513# The following tests run as part of stage-3.
514#
515
516freebsd-cxx-cmplx-pkgs-dbg:
517  extends:
518    - .stage-3
519    - .freebsd_test
520  tags:
521    - os:fbsd
522  variables:
523    TEST_ARCH: arch-ci-freebsd-cxx-cmplx-pkgs-dbg
524
525freebsd-cxx-pkgs-opt:
526  extends:
527    - .stage-3
528    - .freebsd_test
529  tags:
530    - os:fbsd
531  variables:
532    EXTRA_OPTIONS_INITIAL: -vecscatter_mpi1 false -options_left false
533    TEST_ARCH: arch-ci-freebsd-cxx-pkgs-opt
534
535freebsd-pkgs-opt:
536  extends:
537    - .stage-3
538    - .freebsd_test
539  tags:
540    - os:fbsd
541  variables:
542    TEST_ARCH: arch-ci-freebsd-pkgs-opt
543    MAKE_CFLAGS: -DPETSC_SKIP_COMPLEX -Werror
544
545linux-hip-double:
546  extends:
547    - .stage-3
548    - .linux_test_noflags
549    - .coverage-disable
550  tags:
551    - gpu:amd, os:linux
552  variables:
553    TEST_ARCH: arch-ci-linux-hip-double
554
555linux-hip-cmplx:
556  extends:
557    - .stage-3
558    - .linux_test_noflags
559    - .coverage-disable
560  tags:
561    - gpu:amd, os:linux
562  variables:
563    TEST_ARCH: arch-ci-linux-hip-cmplx
564
565linux-sycl-double:
566  extends:
567    - .stage-3
568    - .linux_test_nofflags
569    - .coverage-disable
570  tags:
571    - gce-u22-stage3, linux-fast
572  variables:
573    MODULEPATH: /nfs/gce/projects/petsc/soft/oneapi/2025.2.0/modulefiles
574    TEST_ARCH: arch-ci-linux-sycl-double
575    LOAD_MODULES: tbb/latest compiler-rt/latest umf/latest compiler/latest mpi/latest
576    TEST_OPTS: query=requires queryval=kokkos_kernels
577    MAKE_CFLAGS: -Wno-expected-file-type -Werror
578
579linux-cuda-pkgs:
580  extends:
581    - .stage-3
582    - .linux_test
583  tags:
584    - cuda-stage3
585  variables:
586    TEST_ARCH: arch-ci-linux-cuda-pkgs
587    # run all tests that:
588    # 1. require cuda, OR
589    # 2. require device, OR
590    # 3. require hypre, OR
591    # 4. require kokkos[_kernels], AND lives in the vec subdirectory
592    #
593    # need to use the alternate OR spelling since '|' is interpreted as a pipe by the
594    # shell, and I could not manage to escape it enough times...
595    TEST_OPTS: -j3 queryval='cuda,device,hypre,kokkos*,vec*' query='requires,requires,requires,requires%OR%name'
596    MAKE_CUDAFLAGS: --compiler-options -Wall,-Werror
597    OMP_PROC_BIND: false
598
599linux-cuda112-omp:
600  extends:
601    - .stage-3
602    - .linux_test
603    - .coverage-disable
604  tags:
605    - cuda-stage3
606  variables:
607    TEST_ARCH: arch-ci-linux-cuda112-omp
608    TEST_OPTS: -j4 query=requires queryval=kokkos_kernels
609    LOAD_MODULES: cuda/11.2.2 u-gcc-9/9.4.0
610    OMP_PROC_BIND: "false"
611    OMP_NUM_THREADS: 1
612    MAKE_CUDAFLAGS: --compiler-options -Wall,-Werror
613
614linux-cuda-cmplx:
615  extends:
616    - .stage-3
617    - .linux_test
618  tags:
619    - cuda-stage3
620  variables:
621    TEST_ARCH: arch-ci-linux-cuda-cmplx
622    MAKE_CUDAFLAGS: --compiler-options -Wall,-Werror
623
624linux-cuda-double-64idx:
625  extends:
626    - .stage-3
627    - .linux_test
628  tags:
629    - cuda12
630  variables:
631    TEST_ARCH: arch-ci-linux-cuda-double-64idx
632    TEST_OPTS: -j3 query=requires queryval=cuda
633    MAKE_CUDAFLAGS: --compiler-options -Wall,-Werror
634
635linux-cuda-latest:
636  extends:
637    - .stage-3
638    - .linux_test
639  tags:
640    - cuda12
641  variables:
642    TEST_ARCH: arch-ci-linux-cuda-latest
643    TEST_OPTS: -j3 query=requires queryval=cuda
644    MAKE_CUDAFLAGS: --compiler-options -Wall,-Werror
645
646linux-cuda-single-cxx:
647  extends:
648    - .stage-3
649    - .linux_test_noflags
650    - .coverage-disable
651  tags:
652    - cuda-stage3
653  variables:
654    TEST_ARCH: arch-ci-linux-cuda-single-cxx
655    MODULEPATH: /nfs/gce/projects/petsc/soft/u22.04/spack-2023-02-02/share/spack/modules/linux-ubuntu22.04-ivybridge
656    LOAD_MODULES: nvhpc-22.11-gcc-11.3.0-vmvmbrx
657    TEST_OPTS: -j15 query=requires queryval=cuda
658
659linux-cuda-uni-pkgs:
660  extends:
661    - .stage-3
662    - .linux_test
663  tags:
664    - cuda-stage3
665  variables:
666    TEST_ARCH: arch-ci-linux-cuda-uni-pkgs
667    TEST_OPTS: -j20 query=requires queryval=cuda
668    MAKE_CUDAFLAGS: --compiler-options -Wall,-Werror
669
670linux-clang-cuda:
671  extends:
672    - .stage-3
673    - .linux_test
674    - .coverage-disable
675  tags:
676    - cuda-stage3
677  variables:
678    TEST_ARCH: arch-ci-linux-clang-cuda
679    TEST_OPTS: -j 1 queryval='cuda*,snes*' query='requires%OR%name'
680    MODULEPATH: /nfs/gce/projects/petsc/soft/u22.04/spack-2023-02-02/share/spack/modules/linux-ubuntu22.04-ivybridge
681    LOAD_MODULES: llvm-15.0.7-gcc-11.3.0-pjldtxf cuda-11.5.2-gcc-11.3.0-jkoottx gcc-11.3.0-gcc-11.3.0-pgrvke5
682    MAKE_CUDAFLAGS: -Wno-pass-failed -Werror
683
684linux-viennacl:
685  extends:
686    - .stage-3
687    - .linux_test
688  tags:
689    - cuda-stage3
690  variables:
691    TEST_ARCH: arch-ci-linux-viennacl
692    MAKE_CXXFLAGS: -Werror -Wno-ignored-attributes
693    TEST_OPTS: -j20 query=requires queryval=viennacl
694
695linux-without-fc:
696  extends:
697    - .stage-3
698    - .linux_test
699  tags:
700    - gce-u22-stage3
701  variables:
702    TEST_ARCH: arch-ci-linux-without-fc
703
704linux-flang-arm:
705  extends:
706    - .stage-3
707    - .linux_test_noflags
708    # gcovr does not work on arm/linux
709    - .coverage-disable
710  tags:
711    - arch:arm, os:linux
712  variables:
713    TEST_ARCH: arch-ci-linux-flang-arm
714
715linux-cmplx-single-arm:
716  extends:
717    - .stage-3
718    - .linux_test
719    # gcovr does not work on arm/linux
720    - .coverage-disable
721  tags:
722    - arch:arm, os:linux
723  variables:
724    FLEXIBLAS: netlib
725    TEST_ARCH: arch-ci-linux-cmplx-single-arm
726
727linux-gcc-cxx-avx2:
728  extends:
729    - .stage-3
730    - .linux_test
731  tags:
732    - name:petsc-knl-01
733  variables:
734    TEST_ARCH: arch-ci-linux-gcc-cxx-avx2
735
736linux-clang-avx:
737  extends:
738    - .stage-3
739    - .linux_test
740  tags:
741    - name:petsc-knl-01
742  variables:
743    TEST_ARCH: arch-ci-linux-clang-avx
744
745linux-knl:
746  extends:
747    - .stage-3
748    - .linux_test
749    - .coverage-disable
750  tags:
751    - name:petsc-knl-01
752  variables:
753    MAKE_FFLAGS: -warn errors
754    TEST_ARCH: arch-ci-linux-knl
755    LOAD_MODULES: intel-oneapi-compilers/2022.0.2 intel-oneapi-mkl/2022.0.2 intel-oneapi-mpi/2021.5.1
756
757linux-intel-mkl-single:
758  extends:
759    - .stage-3
760    - .linux_test_nofflags
761    - .coverage-disable
762  tags:
763    - name:petsc-knl-01
764  variables:
765    TEST_ARCH: arch-ci-linux-intel-mkl-single
766    LOAD_MODULES: intel-oneapi-compilers/2022.0.2 intel-oneapi-mkl/2022.0.2 intel-oneapi-mpi/2021.5.1
767
768linux-cxx-cmplx-pkgs-64idx:
769  extends:
770    - .stage-3
771    - .linux_test
772  tags:
773    - gce-u22-stage3
774  variables:
775    TEST_ARCH: arch-ci-linux-cxx-cmplx-pkgs-64idx
776    EXTRA_OPTIONS_INITIAL: -fp_trap
777    MODULEPATH: /nfs/gce/projects/petsc/soft/u22.04/spack-2024-08-30/modules/linux-ubuntu22.04-x86_64/Core
778    LOAD_MODULES: python/3.13.0rc1-rayc5m7 py-setuptools/69.2.0-6yku3zk python-venv/1.0-bnbfk2n py-pip/23.1.2-o7dlzno
779
780# Set env vars for 'Kokkos + OpenMP' tests, so that they won't give warnings
781linux-pkgs-dbg-ftn-interfaces:
782  extends:
783    - .stage-3
784    - .linux_test
785    - .coverage-disable
786  tags:
787    - gce-u22-stage3
788  variables:
789    TEST_ARCH: arch-ci-linux-pkgs-dbg-ftn-interfaces
790    OMP_PROC_BIND: "false"
791    OMP_NUM_THREADS: 4
792    EXTRA_OPTIONS_INITIAL: -fp_trap
793
794linux-pkgs-cxx-mlib:
795  extends:
796    - .stage-3
797    - .linux_test
798  tags:
799    - gce-u22-stage3
800  variables:
801    TEST_ARCH: arch-ci-linux-pkgs-cxx-mlib
802    EXTRA_OPTIONS_INITIAL: -fp_trap
803    LOAD_MODULES: python/3.8.13
804
805linux-pkgs-valgrind:
806  extends:
807    - .stage-3
808    - .linux_test
809  tags:
810    - gce-valgrind
811  variables:
812    TEST_ARCH: arch-ci-linux-pkgs-valgrind
813    TIMEOUT: 1200
814    UCX_SYSV_HUGETLB_MODE: n
815
816linux-pkgs-opt:
817  extends:
818    - .stage-3
819    - .linux_test
820  tags:
821    - gce-u22-stage3, linux-fast
822  variables:
823    TEST_ARCH: arch-ci-linux-pkgs-opt
824    LOAD_MODULES: gcc/12.1.0
825    MAKE_CXXFLAGS: -Wno-deprecated-declarations -Werror
826
827linux-pkgs-dbg:
828  extends:
829    - .stage-3
830    - .linux_test
831  tags:
832    - gce-u22-stage3, linux-gcov
833  variables:
834    TEST_ARCH: arch-ci-linux-pkgs-dbg
835    EXTRA_OPTIONS_INITIAL: -fp_trap
836
837linux-matlab-ilp64:
838  extends:
839    - .stage-3
840    - .linux_test
841  tags:
842    - gce-u22-stage3, linux-gcov
843  variables:
844    TEST_ARCH: arch-ci-linux-matlab-ilp64
845    LOAD_MODULES: gcc/9.4.0 matlab/R2022a
846  allow_failure: true
847
848linux-intel-cmplx:
849  extends:
850    - .stage-3
851    - .linux_test_nofflags
852    - .coverage-disable
853  tags:
854    - gce-u22-stage3
855  variables:
856    TEST_ARCH: arch-ci-linux-intel-cmplx
857    LOAD_MODULES: intel-oneapi-compilers/2023.0.0 intel-oneapi-mkl/2022.0.2
858
859linux-misc-dbg:
860  extends:
861    - .stage-3
862    - .linux_test
863  tags:
864    - gce-u22-stage3
865  variables:
866    TEST_ARCH: arch-ci-linux-misc-dbg
867    LOAD_MODULES: gcc/12.1.0
868
869check-each-commit:
870  extends:
871    - .stage-2
872    - .linux_test
873    - .coverage-disable
874  tags:
875    - gce-u22-stage2
876  script:
877    - export PATH=/nfs/gce/projects/petsc/soft/u22.04/spack-2025-08-26-llvm/opt/spack/linux-x86_64/llvm-21.1.0-yu5atp22wbrkzn6ia3vqu5lsaw57ejnn/bin:$PATH
878    - lib/petsc/bin/maint/check-each-commit.sh
879  except:
880    variables:
881      - $PETSC_CI_SCHEDULED =~ /yes/
882  allow_failure: true
883
884linux-analyzer:
885  extends:
886    - .stage-2
887    - .linux_test
888    - .coverage-disable
889  tags:
890    - gce-u22-stage2
891  script:
892    - printf "PATH:$PATH\n"
893    - printf "PYTHONPATH:$PYTHONPATH\n"
894    - python3 --version
895    - git --version
896    - mypy --version
897    - vermin --version
898    - printf "EXTRA_OPTIONS_INITIAL:$EXTRA_OPTIONS_INITIAL $BASE_EXTRA_OPTIONS\n"
899    - if [ ! -z ${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME+x} ]; then printf "CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME\n" ;fi
900    - printf "./config/examples/${TEST_ARCH}.py\n"
901    - cat ./config/examples/${TEST_ARCH}.py
902    - ./config/examples/${TEST_ARCH}.py
903    - make LINTER_OPTIONS="${LINTER_OPTIONS}" test-lint
904    - make V=3 LINTER_OPTIONS="${LINTER_OPTIONS} -- ./src" lint
905  variables:
906    TEST_ARCH: arch-ci-linux-analyzer
907    LINTER_OPTIONS: "--PETSC_ARCH=${TEST_ARCH} --clang_lib=`llvm-config-14 --libdir`/libclang.so.1 --werror 1"
908  artifacts:
909    paths:
910      - arch-*/lib/petsc/conf/*.log
911      - ./petscLintPatches/*.patch
912    expire_in: 4 days
913  except:
914    variables:
915      - $PETSC_CI_SCHEDULED =~ /yes/
916
917linux-intel:
918  extends:
919    - .stage-3
920    - .linux_test_nofflags
921    - .coverage-disable
922  tags:
923    - gce-u22-stage3
924  variables:
925    TEST_ARCH: arch-ci-linux-intel
926    LOAD_MODULES: intel-oneapi-compilers/2023.0.0 intel-oneapi-mkl/2022.0.2
927
928linux-clang-ubsan:
929  extends:
930    - .stage-2
931    - .linux_test
932    - .coverage-disable
933  tags:
934    - gce-u22-stage2
935  variables:
936    TEST_ARCH: arch-ci-linux-clang-ubsan
937    LOAD_MODULES: llvm/17.0.4
938
939linux-opt-arm:
940  extends:
941    - .stage-3
942    - .linux_test
943    # gcovr does not work on arm/linux
944    - .coverage-disable
945  tags:
946    - arch:arm, os:linux
947  variables:
948    TEST_ARCH: arch-ci-linux-opt-arm
949
950linux-pkgs-64idx:
951  extends:
952    - .stage-3
953    - .linux_test
954  tags:
955    - gce-u22-stage3, linux-mcpu
956  variables:
957    TEST_ARCH: arch-ci-linux-pkgs-64idx
958    LOAD_MODULES: intel-oneapi-mkl/2022.0.2
959
960linux-64idx-i8:
961  extends:
962    - .stage-3
963    - .linux_test
964  tags:
965    - gce-u22-stage3, linux-mcpu
966  variables:
967    TEST_ARCH: arch-ci-linux-64idx-i8
968
969linux-gcc-ifc-cmplx:
970  extends:
971    - .stage-3
972    - .linux_test_nofflags
973  tags:
974    - gce-u22-stage3
975  variables:
976    TEST_ARCH: arch-ci-linux-gcc-ifc-cmplx
977    LOAD_MODULES: intel-oneapi-compilers/2022.2.1
978
979linux-opt-cxx-quad:
980  extends:
981    - .stage-3
982    - .linux_test
983  tags:
984    - gce-u22-stage3
985  variables:
986    TEST_ARCH: arch-ci-linux-opt-cxx-quad
987    MODULEPATH: /nfs/gce/projects/petsc/soft/u22.04/spack-2024-08-30/modules/linux-ubuntu22.04-x86_64/Core
988    LOAD_MODULES: python/3.13.0rc1-rayc5m7
989
990linux-ILP64:
991  extends:
992    - .stage-3
993    - .linux_test
994  tags:
995    - gce-u22-stage3
996  variables:
997    TEST_ARCH: arch-ci-linux-ILP64
998    LOAD_MODULES: gcc/8.5.0 mpich/2-1.5-gcc-8.5.0
999    MAKE_CFLAGS: -Wno-discarded-qualifiers -Werror
1000
1001linux-64idx-i8-uni:
1002  extends:
1003    - .stage-3
1004    - .linux_test
1005  tags:
1006    - gce-u22-stage3, linux-mcpu
1007  variables:
1008    TEST_ARCH: arch-ci-linux-64idx-i8-uni
1009
1010linux-misc-32bit:
1011  extends:
1012    - .stage-3
1013    - .linux_test
1014  tags:
1015    - gce-u22-stage3
1016  variables:
1017    TEST_ARCH: arch-ci-linux-misc-32bit
1018
1019mswin-intel-cxx-cmplx:
1020  extends:
1021    - .stage-3
1022    - .mswin_test
1023  tags:
1024    - mswin-stage3
1025  variables:
1026    TEST_ARCH: arch-ci-mswin-intel-cxx-cmplx
1027    TIMEOUT: 150
1028
1029mswin-uni:
1030  extends:
1031    - .stage-3
1032    - .mswin_test
1033  tags:
1034    - mswin-stage3
1035  variables:
1036    EXTRA_OPTIONS_INITIAL: -check_pointer_intensity 0 -error_output_stdout
1037    TEST_ARCH: arch-ci-mswin-uni
1038
1039mswin-gnu:
1040  extends:
1041    - .stage-3
1042    - .mswin_test
1043  tags:
1044    - mswin-stage3
1045  variables:
1046    TEST_ARCH: arch-ci-mswin-gnu
1047    MAKE_CFLAGS: -Werror
1048    MAKE_CXXFLAGS: -Werror
1049    MAKE_FFLAGS: -Werror
1050    DISABLE_TESTS: 1
1051
1052#mswin-intel:
1053#  extends:
1054#    - .stage-3
1055#    - .mswin_test
1056#  tags:
1057#    - os:win
1058#  variables:
1059#    TEST_ARCH: arch-ci-mswin-intel
1060
1061macos-cxx-cmplx-pkgs-dbg-arm:
1062  extends:
1063    - .stage-3
1064    - .macos_test
1065    - .coverage-disable
1066  tags:
1067    - os:macos-arm
1068  variables:
1069    TEST_ARCH: arch-ci-macos-cxx-cmplx-pkgs-dbg-arm
1070    INIT_SCRIPT: .zprofile
1071
1072macos-cxx-pkgs-opt-arm:
1073  extends:
1074    - .stage-3
1075    - .macos_test
1076    - .coverage-disable
1077  tags:
1078    - os:macos-arm
1079  variables:
1080    EXTRA_OPTIONS_INITIAL: -vecscatter_mpi1 false -options_left false
1081    TEST_ARCH: arch-ci-macos-cxx-pkgs-opt-arm
1082    MAKE_CXXFLAGS: -Werror -Wno-pass-failed
1083    INIT_SCRIPT: .zprofile
1084
1085macos-dbg:
1086  extends:
1087    - .stage-3
1088    - .macos_test
1089    - .coverage-disable
1090  tags:
1091    - os:macos-x64
1092  variables:
1093    TEST_ARCH: arch-ci-macos-dbg
1094    ASAN_OPTIONS: log_path=stdout
1095    INIT_SCRIPT: .zprofile
1096
1097macos-opt-arm:
1098  extends:
1099    - .stage-3
1100    - .macos_test
1101    - .coverage-disable
1102  tags:
1103    - os:macos-arm
1104  variables:
1105    TEST_ARCH: arch-ci-macos-opt-arm
1106    INIT_SCRIPT: .zprofile
1107
1108# job for analyzing the coverage results and generating the various reports
1109coverage-analyze:
1110  extends: .test
1111  stage: stage-4
1112  tags:
1113    - gce-u22-short
1114  dependencies:
1115    # stage-2
1116    - linux-gcc-quad-64idx-dbg
1117    - linux-gcc-pkgs-opt
1118    - linux-gcc-complex-opt-32bit
1119    # stage-3
1120    - linux-pkgs-dbg
1121    - linux-matlab-ilp64
1122    - linux-cuda-pkgs
1123    - linux-cxx-cmplx-pkgs-64idx
1124    - linux-cuda-cmplx
1125    - linux-cuda-double-64idx
1126    - linux-cuda-uni-pkgs
1127    - linux-viennacl
1128    - linux-without-fc
1129    - linux-gcc-cxx-avx2
1130    - linux-clang-avx
1131    - linux-pkgs-cxx-mlib
1132    - linux-pkgs-valgrind
1133    - linux-misc-dbg
1134    - linux-pkgs-64idx
1135    - linux-pkgs-opt
1136    - linux-64idx-i8
1137    - linux-gcc-ifc-cmplx
1138    - linux-opt-cxx-quad
1139    - linux-ILP64
1140    - linux-64idx-i8-uni
1141  variables:
1142    PYTHON: python3
1143    PETSC_ARCH: arch-ci-analyze-pipeline
1144  before_script:
1145    - date
1146    - hostname
1147  script:
1148    - if [ ! -z ${LOAD_MODULES+x} ]; then module --trace load ${LOAD_MODULES}; module list; fi
1149    - ${PYTHON} --version
1150    - gcovr --version
1151    - printf "PATH:$PATH\n"
1152    - printf "PYTHONPATH:$PYTHONPATH\n"
1153    - if [ ! -z ${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME+x} ]; then printf "CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME\n" ;fi
1154    - ${PYTHON} ./configure --with-mpi=0 --with-cxx=0 --download-sowing --with-fortran-bindings
1155    - make mergegcov PETSC_GCOV_OPTIONS='--ci-mode --verbose'
1156  coverage: /^\s*lines:\s*\d+.\d+\%/
1157  artifacts:
1158    name: "$CI_JOB_NAME"
1159    when: always
1160    paths:
1161      - arch-ci-analyze-pipeline/gcovr/*
1162      - arch-ci-analyze-pipeline/lib/petsc/conf/*.log
1163    expire_in: 4 days
1164    reports:
1165      coverage_report:
1166        coverage_format: cobertura
1167        path: arch-ci-analyze-pipeline/gcovr/xml/*.xml
1168
1169# template for the coverage review jobs, these must be separate jobs as you cannot deploy multiple
1170# environments from one job...
1171.coverage-review:
1172  extends: .test
1173  stage: .post
1174  tags:
1175    - gce-u22-short
1176  dependencies:
1177    - coverage-analyze
1178  script:
1179    - date
1180    - hostname
1181  artifacts:
1182    name: "$CI_JOB_NAME"
1183    when: always
1184    paths:
1185      - arch-ci-analyze-pipeline/gcovr/*
1186      - arch-ci-analyze-pipeline/lib/petsc/conf/*.log
1187    expire_in: 4 days
1188
1189coverage-total-review:
1190  extends: .coverage-review
1191  environment:
1192    name: coverage/all/$CI_COMMIT_REF_SLUG
1193    url: https://$CI_PROJECT_NAMESPACE.gitlab.io/-/$CI_PROJECT_NAME/-/jobs/$CI_JOB_ID/artifacts/arch-ci-analyze-pipeline/gcovr/html/report.html
1194    auto_stop_in: one week
1195    deployment_tier: testing
1196
1197coverage-untested-review:
1198  extends: .coverage-review
1199  environment:
1200    name: coverage/untested/$CI_COMMIT_REF_SLUG
1201    url: https://$CI_PROJECT_NAMESPACE.gitlab.io/-/$CI_PROJECT_NAME/-/jobs/$CI_JOB_ID/artifacts/arch-ci-analyze-pipeline/gcovr/html_untested/report_untested.html
1202    auto_stop_in: one week
1203    deployment_tier: testing
1204
1205analyze-pipeline:
1206  extends: .coverage-review
1207  script:
1208    - date
1209    - hostname
1210    # This file is created by lib/petsc/bin/maint/gcov.py. If it exists then the CI
1211    # pipeline should fail
1212    - if [ -f ./arch-ci-analyze-pipeline/gcovr/.CI_FAIL ]; then
1213      cat ./arch-ci-analyze-pipeline/gcovr/merge_gcov_errors.log;
1214      exit 1;
1215      fi
1216  allow_failure: true
1217
1218#
1219# Base job for a documentation build (runs in venv to allow installing additional packages without root)
1220#
1221.docs:
1222  stage: stage-2
1223  tags:
1224    - gce-u24-docs
1225  before_script:
1226    - git fetch --unshallow --tags origin +release:remotes/origin/release +main:remotes/origin/main
1227    - printf "PATH:$PATH\n"
1228    - printf "PYTHONPATH:$PYTHONPATH\n"
1229    - VENV=venv-petsc-docs &&
1230      python3 -m venv $VENV &&
1231      . $VENV/bin/activate &&
1232      cd doc &&
1233      python -m pip install -r requirements.txt
1234
1235#
1236# Build documentation and make available for review using GitLab pages
1237#
1238docs-review:
1239  extends:
1240    - .docs
1241    - .test-basic
1242  script:
1243    - printf "PATH:$PATH\n"
1244    - printf "PYTHONPATH:$PYTHONPATH\n"
1245    #- printf "python:${PYTHON}\n"
1246    #- ${PYTHON} -m pip list --user
1247    - printf "CONFIG_OPTS:${CONFIG_OPTS}\n"
1248    - printf "EXTRA_OPTIONS_INITIAL:$EXTRA_OPTIONS_INITIAL $BASE_EXTRA_OPTIONS\n"
1249    - if [ ! -z ${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME+x} ]; then printf "CI_MERGE_REQUEST_SOURCE_BRANCH_NAME:$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME\n" ;fi
1250    - (time make html BUILDDIR="../public" SPHINXOPTS="-T -E -W --keep-going -j 2") || (printf "Sphinx build failed (warnings count as errors)\n" && false)
1251    - (time make latexpdf SPHINXOPTS="-T -E -W --keep-going -j 2") || (printf "Sphinx build failed (warnings count as errors)\n" && false)
1252    - cp _build/latex/manual.pdf ../public/html/manual/
1253  environment:
1254    name: review/$CI_COMMIT_REF_NAME
1255    url: https://$CI_PROJECT_NAMESPACE.gitlab.io/-/$CI_PROJECT_NAME/-/jobs/$CI_JOB_ID/artifacts/public/html/index.html
1256    auto_stop_in: one week
1257    deployment_tier: development
1258  artifacts:
1259    paths:
1260      - public
1261    expire_in: 4 days
1262  except:
1263    variables:
1264      - $PETSC_CI_SCHEDULED =~ /yes/
1265
1266#
1267# Deploy documentation using GitLab pages
1268#
1269pages: # this job name has special meaning to GitLab
1270  extends: .docs
1271  interruptible: true
1272  script:
1273    - mkdir -p ../public/ && cp public/* ../public/
1274    - (git checkout origin/main && pip install -r requirements.txt && make website-deploy SPHINXOPTS="-j 1" BUILDDIR="../public/main" && make latexpdf && mkdir -p ../public/main/manual && cp _build/latex/manual.pdf ../public/main/manual/) || (printf "Sphinx build failed (warnings count as errors)\n" && false)
1275    - cd .. && git clean -fdxq -e public -e venv-petsc-docs && cd doc && rm -rf images
1276    - (git checkout origin/release && pip install -r requirements.txt && make website-deploy SPHINXOPTS="-j 1" BUILDDIR="../public/release" && make latexpdf && mkdir -p ../public/release/manual && cp _build/latex/manual.pdf ../public/release/manual/) || (printf "Sphinx build failed (warnings count as errors)\n" && false)
1277    - rm -rf ../public/*/.doctrees
1278  only:
1279    variables:
1280      - $PETSC_CI_SCHEDULED == "yes"
1281  artifacts:
1282    paths:
1283      - public
1284    expire_in: 4 days
1285
1286#
1287#
1288# The following tests are experimental; more tests by users at other sites may be added below this. Experimental test
1289# that fail produce a warning, but do not block execution of a pipeline.
1290#
1291
1292.test-experimental:
1293  extends: .test
1294  allow_failure: true
1295