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