This documentation was last rebuild on Jan 20, 2021 and is intended for version 0.9.2.
Please refer to https://buildtest.readthedocs.io/en/latest/ for documentation on latest release. If you are working off devel branch then please to devel docs at https://buildtest.readthedocs.io/en/devel/.
Cori @ NERSC: https://github.com/buildtesters/buildtest-cori
Stampede2 @ TACC: https://github.com/buildtesters/buildtest-stampede2
buildtest is a HPC testing framework to help sites perform acceptance & regression testing of an HPC system. buildtest utilizes json schema to define structure of test written in YAML called a Buildspec File. The schema docs is a resource that hosts buildtest schemas and documents all field attributes for each schema, this will be useful when you are writting buildspecs.
A spin-off project called lmodule is a Python API for Lmod. The buildtest module features were deprecated and moved to lmodule with the main objective is to automate module load testing. For more details on lmodule see https://github.com/buildtesters/lmodule
- Installing buildtest
- Getting Started
- Configuring buildtest
- Default Configuration
- What is an executor?
- Executor Declaration
- buildtest configuration for Cori @ NERSC
- buildspec roots
- Configuring Module Tool
- before_script and after_script for executors
- Compiler Declaration
- Detect Compilers (Experimental Feature)
- buildtest configuration for Ascent @ OLCF
- buildtest configuration for JLSE @ ANL
- CLI to buildtest configuration
- Example Configurations
- Writing buildspecs
- Build and Test Process
- Scripting in buildtest
- Conference and Publications