Help/dev/integration-testing.rst
CMake Integration Testing
The following documents how to run integration testing builds.
See documentation on CMake Development_ for more information.
See the CMake Testing Guide_ for running the test suite locally.
.. _CMake Development: README.rst
.. _CMake Testing Guide: testing.rst
The integration testing step of the CMake Review Process_ uses a set of
testing machines that follow an integration branch on their own schedule to
drive testing and submit results to the CMake CDash Page_. Anyone is
welcome to provide testing machines in order to help keep support for their
platforms working.
The CMake Dashboard Scripts Repository_ provides CTest scripts to drive
nightly, continuous, and experimental testing of CMake. Use the following
commands to set up a new integration testing client:
.. code-block:: console
$ mkdir -p ~/Dashboards $ cd ~/Dashboards $ git clone https://gitlab.kitware.com/cmake/dashboard-scripts.git CMakeScripts $ cd CMakeScripts
The cmake_common.cmake_ script contains comments at the top with
instructions to set up a testing client. As it instructs, create a
CTest script with local settings and include cmake_common.cmake.
.. _CMake Review Process: review.rst
.. _CMake CDash Page: https://open.cdash.org/index.php?project=CMake
.. _CMake Dashboard Scripts Repository: https://gitlab.kitware.com/cmake/dashboard-scripts
.. _cmake_common.cmake: https://gitlab.kitware.com/cmake/dashboard-scripts/-/blob/master/cmake_common.cmake
The cmake_common.cmake script expects its includer to be run from a
nightly scheduled task (cron job). Schedule such tasks for sometime after
1:00am UTC, the time at which our nightly testing branches fast-forward.