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