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