buildtest configuration schema Schema

settings.schema.json
Abstract Extensible Status Identifiable Custom Properties Additional Properties Access Restrictions Defined In
Can be instantiated Yes Unknown status No Forbidden Forbidden none settings.schema.json

buildtest configuration schema Type

object (buildtest configuration schema)

buildtest configuration schema Properties

Property Type Required Nullable Defined by
system object Required cannot be null buildtest configuration schema

system

system

system Type

object (Details)

buildtest configuration schema Definitions

Definitions group terse

Reference this group by using

{"$ref":"settings.schema.json#/definitions/terse"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group format

Reference this group by using

{"$ref":"settings.schema.json#/definitions/format"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group count

Reference this group by using

{"$ref":"settings.schema.json#/definitions/count"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group system

Reference this group by using

{"$ref":"settings.schema.json#/definitions/system"}
Property Type Required Nullable Defined by
hostnames array Required cannot be null buildtest configuration schema
description string Optional cannot be null buildtest configuration schema
poolsize integer Optional cannot be null buildtest configuration schema
max_jobs integer Optional cannot be null buildtest configuration schema
testdir string Optional cannot be null buildtest configuration schema
logdir string Optional cannot be null buildtest configuration schema
moduletool string Required cannot be null buildtest configuration schema
timeout integer Optional cannot be null buildtest configuration schema
pager boolean Optional cannot be null buildtest configuration schema
buildspecs object Required cannot be null buildtest configuration schema
report object Required cannot be null buildtest configuration schema
processor object Optional cannot be null buildtest configuration schema
compilers object Required cannot be null buildtest configuration schema
executors object Required cannot be null buildtest configuration schema
cdash object Optional cannot be null buildtest configuration schema
profiles object Optional cannot be null buildtest configuration schema

hostnames

Specify a list of hostnames to check where buildtest can run for the given system record

hostnames

hostnames Type

string[]

description

system description field

description

description Type

string

poolsize

Specify size of Process Pool for parallel processing using multiprocessing.Pool

poolsize

poolsize Type

integer

poolsize Constraints

minimum: the value of this number must greater than or equal to: 1

max_jobs

Maximum number of jobs that can be run at a given time for a particular executor

max_jobs

max_jobs Type

integer

max_jobs Constraints

minimum: the value of this number must greater than or equal to: 1

testdir

Specify full path to test directory where buildtest will write tests.

testdir

testdir Type

string

logdir

Specify location where buildtest will write log files

logdir

logdir Type

string

moduletool

Specify modules tool used for interacting with module command.

moduletool

moduletool Type

string

moduletool Constraints

enum: the value of this property must be equal to one of the following values:

Value Explanation
"environment-modules"  
"lmod"  
"N/A"  

timeout

Specify timeout duration in number of seconds

timeout

timeout Type

integer

timeout Constraints

minimum: the value of this number must greater than or equal to: 1

pager

A boolean to determine whether to enable paging when viewing buildspec cache

pager

pager Type

boolean

buildspecs

Specify configuration for buildtest buildspec command

buildspecs

buildspecs Type

object (Details)

report

report

report Type

object (Details)

processor

Specify processor information

processor

processor Type

object (Details)

compilers

Declare compiler section for defining system compilers that can be referenced in buildspec.

compilers

compilers Type

object (Details)

executors

The executor section is used for declaring your executors that are responsible for running jobs. The executor section can be local, lsf, slurm, cobalt. The executors are referenced in buildspec using executor field.

executors

executors Type

object (Details)

cdash

Specify CDASH configuration used to upload tests via ‘buildtest cdash’ command

cdash

cdash Type

object (Details)

profiles

The profiles section is used for declaring one or more profiles that can be used to run buildtest build that are captured as command options

profiles

profiles Type

object (Details)

Definitions group cc

Reference this group by using

{"$ref":"settings.schema.json#/definitions/cc"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group cxx

Reference this group by using

{"$ref":"settings.schema.json#/definitions/cxx"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group fc

Reference this group by using

{"$ref":"settings.schema.json#/definitions/fc"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group compiler_section

Reference this group by using

{"$ref":"settings.schema.json#/definitions/compiler_section"}
Property Type Required Nullable Defined by
cc string Required cannot be null buildtest configuration schema
cxx string Required cannot be null buildtest configuration schema
fc string Required cannot be null buildtest configuration schema
module object Optional cannot be null buildtest configuration schema

cc

Specify path to C compiler wrapper. You may specify a compiler wrapper such as gcc assuming its in $PATH or you can use modules property to resolve path to compiler wrapper.

cc

cc Type

string

cxx

Specify path to C++ compiler wrapper. You may specify a compiler wrapper such as g++ assuming its in $PATH or you can use modules property to resolve path to compiler wrapper.

cxx

cxx Type

string

fc

Specify path to Fortran compiler wrapper. You may specify a compiler wrapper such as gfortran assuming its in $PATH or you can use modules property to resolve path to compiler wrapper.

fc

fc Type

string

module

module

module Type

object (Details)

Definitions group unique_string_array

Reference this group by using

{"$ref":"settings.schema.json#/definitions/unique_string_array"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group disable

Reference this group by using

{"$ref":"settings.schema.json#/definitions/disable"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group module

Reference this group by using

{"$ref":"settings.schema.json#/definitions/module"}
Property Type Required Nullable Defined by
purge boolean Optional cannot be null buildtest configuration schema
load array Optional cannot be null buildtest configuration schema
swap array Optional cannot be null buildtest configuration schema
restore string Optional cannot be null buildtest configuration schema

purge

Run module purge if purge is set

purge

purge Type

boolean

load

Load one or more modules via module load

load

load Type

string[]

load Constraints

minimum number of items: the minimum number of items for this array is: 1

unique items: all items in this array must be unique. Duplicates are not allowed.

swap

Swap modules using module swap. The swap property expects 2 unique modules.

swap

swap Type

string[]

swap Constraints

maximum number of items: the maximum number of items for this array is: 2

minimum number of items: the minimum number of items for this array is: 2

unique items: all items in this array must be unique. Duplicates are not allowed.

restore

Load a collection name via module restore

restore

restore Type

string

Definitions group script

Reference this group by using

{"$ref":"settings.schema.json#/definitions/script"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group maxpendtime

Reference this group by using

{"$ref":"settings.schema.json#/definitions/maxpendtime"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group account

Reference this group by using

{"$ref":"settings.schema.json#/definitions/account"}

| Property | Type | Required | Nullable | Defined by | | :——- | :— | :——- | :——- | :——— |

Definitions group local

Reference this group by using

{"$ref":"settings.schema.json#/definitions/local"}
Property Type Required Nullable Defined by
description string Optional cannot be null buildtest configuration schema
shell string Required cannot be null buildtest configuration schema
before_script Not specified Optional cannot be null buildtest configuration schema
disable boolean Optional cannot be null buildtest configuration schema
module object Optional cannot be null buildtest configuration schema

description

description field for documenting your executor

description

description Type

string

shell

Specify the shell launcher you want to use when running tests locally

shell

shell Type

string

before_script

before_script

before_script Type

unknown

disable

Disable executor

disable

disable Type

boolean

module

module

module Type

object (Details)

Definitions group slurm

Reference this group by using

{"$ref":"settings.schema.json#/definitions/slurm"}
Property Type Required Nullable Defined by
description string Optional cannot be null buildtest configuration schema
launcher string Optional cannot be null buildtest configuration schema
options array Optional cannot be null buildtest configuration schema
cluster string Optional cannot be null buildtest configuration schema
partition string Optional cannot be null buildtest configuration schema
qos string Optional cannot be null buildtest configuration schema
before_script Not specified Optional cannot be null buildtest configuration schema
maxpendtime integer Optional cannot be null buildtest configuration schema
account string Optional cannot be null buildtest configuration schema
disable boolean Optional cannot be null buildtest configuration schema
module object Optional cannot be null buildtest configuration schema

description

description field for documenting your executor

description

description Type

string

launcher

Specify the slurm batch scheduler to use. This overrides the default launcher field. This must be sbatch.

launcher

launcher Type

string

launcher Constraints

enum: the value of this property must be equal to one of the following values:

Value Explanation
"sbatch"  

options

Specify any other options for sbatch used by this executor for running all jobs.

options

options Type

string[]

cluster

Specify the slurm cluster you want to use -M <cluster>

cluster

cluster Type

string

partition

Specify the slurm partition you want to use -p <partition>

partition

partition Type

string

qos

Specify the slurm qos you want to use -q <qos>

qos

qos Type

string

before_script

The before_script section can be used to specify commands before start of test. The script will be sourced in active shell.

before_script

before_script Type

unknown

maxpendtime

Cancel job if it is still pending in queue beyond maxpendtime

maxpendtime

maxpendtime Type

integer

maxpendtime Constraints

minimum: the value of this number must greater than or equal to: 1

maxpendtime Default Value

The default value is:

86400

account

Specify Job Account for charging resources

account

account Type

string

disable

Disable executor

disable

disable Type

boolean

module

module

module Type

object (Details)

Definitions group lsf

Reference this group by using

{"$ref":"settings.schema.json#/definitions/lsf"}
Property Type Required Nullable Defined by
description string Optional cannot be null buildtest configuration schema
launcher string Optional cannot be null buildtest configuration schema
options array Optional cannot be null buildtest configuration schema
queue string Required cannot be null buildtest configuration schema
before_script Not specified Optional cannot be null buildtest configuration schema
maxpendtime integer Optional cannot be null buildtest configuration schema
account string Optional cannot be null buildtest configuration schema
disable boolean Optional cannot be null buildtest configuration schema
module object Optional cannot be null buildtest configuration schema

description

description field for documenting your executor

description

description Type

string

launcher

Specify the lsf batch scheduler to use. This overrides the default launcher field. It must be bsub.

launcher

launcher Type

string

launcher Constraints

enum: the value of this property must be equal to one of the following values:

Value Explanation
"bsub"  

options

Specify any options for bsub for this executor when running all jobs associated to this executor

options

options Type

string[]

queue

Specify the lsf queue you want to use -q <queue>

queue

queue Type

string

before_script

The before_script section can be used to specify commands before start of test. The script will be sourced in active shell.

before_script

before_script Type

unknown

maxpendtime

Cancel job if it is still pending in queue beyond maxpendtime

maxpendtime

maxpendtime Type

integer

maxpendtime Constraints

minimum: the value of this number must greater than or equal to: 1

maxpendtime Default Value

The default value is:

86400

account

Specify Job Account for charging resources

account

account Type

string

disable

Disable executor

disable

disable Type

boolean

module

module

module Type

object (Details)

Definitions group cobalt

Reference this group by using

{"$ref":"settings.schema.json#/definitions/cobalt"}
Property Type Required Nullable Defined by
description string Optional cannot be null buildtest configuration schema
launcher string Optional cannot be null buildtest configuration schema
options array Optional cannot be null buildtest configuration schema
queue string Required cannot be null buildtest configuration schema
before_script Not specified Optional cannot be null buildtest configuration schema
maxpendtime integer Optional cannot be null buildtest configuration schema
account string Optional cannot be null buildtest configuration schema
disable boolean Optional cannot be null buildtest configuration schema
module object Optional cannot be null buildtest configuration schema

description

description field for documenting your executor

description

description Type

string

launcher

Specify the cobalt batch scheduler to use. This overrides the default launcher field. It must be qsub.

launcher

launcher Type

string

launcher Constraints

enum: the value of this property must be equal to one of the following values:

Value Explanation
"qsub"  

options

Specify any options for qsub for this executor when running all jobs associated to this executor

options

options Type

string[]

queue

Specify the lsf queue you want to use -q <queue>

queue

queue Type

string

before_script

The before_script section can be used to specify commands before start of test. The script will be sourced in active shell.

before_script

before_script Type

unknown

maxpendtime

Cancel job if it is still pending in queue beyond maxpendtime

maxpendtime

maxpendtime Type

integer

maxpendtime Constraints

minimum: the value of this number must greater than or equal to: 1

maxpendtime Default Value

The default value is:

86400

account

Specify Job Account for charging resources

account

account Type

string

disable

Disable executor

disable

disable Type

boolean

module

module

module Type

object (Details)

Definitions group pbs

Reference this group by using

{"$ref":"settings.schema.json#/definitions/pbs"}
Property Type Required Nullable Defined by
description string Optional cannot be null buildtest configuration schema
launcher string Optional cannot be null buildtest configuration schema
options array Optional cannot be null buildtest configuration schema
queue string Required cannot be null buildtest configuration schema
before_script Not specified Optional cannot be null buildtest configuration schema
maxpendtime integer Optional cannot be null buildtest configuration schema
account string Optional cannot be null buildtest configuration schema
disable boolean Optional cannot be null buildtest configuration schema
module object Optional cannot be null buildtest configuration schema

description

description field for documenting your executor

description

description Type

string

launcher

Specify the pbs batch scheduler to use. This overrides the default launcher field. It must be qsub.

launcher

launcher Type

string

launcher Constraints

enum: the value of this property must be equal to one of the following values:

Value Explanation
"qsub"  

options

Specify any options for qsub for this executor when running all jobs associated to this executor

options

options Type

string[]

queue

Specify the lsf queue you want to use -q <queue>

queue

queue Type

string

before_script

The before_script section can be used to specify commands before start of test. The script will be sourced in active shell.

before_script

before_script Type

unknown

maxpendtime

Cancel job if it is still pending in queue beyond maxpendtime

maxpendtime

maxpendtime Type

integer

maxpendtime Constraints

minimum: the value of this number must greater than or equal to: 1

maxpendtime Default Value

The default value is:

86400

account

Specify Job Account for charging resources

account

account Type

string

disable

Disable executor

disable

disable Type

boolean

module

module

module Type

object (Details)

Definitions group profiles

Reference this group by using

{"$ref":"settings.schema.json#/definitions/profiles"}
Property Type Required Nullable Defined by
buildspecs array Optional cannot be null buildtest configuration schema
exclude-buildspecs array Optional cannot be null buildtest configuration schema
tags array Optional cannot be null buildtest configuration schema
exclude-tags array Optional cannot be null buildtest configuration schema
executors array Optional cannot be null buildtest configuration schema
filter object Optional cannot be null buildtest configuration schema
module string Optional cannot be null buildtest configuration schema
unload-modules string Optional cannot be null buildtest configuration schema
module-purge boolean Optional cannot be null buildtest configuration schema
rebuild integer Optional cannot be null buildtest configuration schema
limit integer Optional cannot be null buildtest configuration schema
account string Optional cannot be null buildtest configuration schema
maxpendtime integer Optional cannot be null buildtest configuration schema
pollinterval integer Optional cannot be null buildtest configuration schema
procs array Optional cannot be null buildtest configuration schema
nodes array Optional cannot be null buildtest configuration schema
testdir string Optional cannot be null buildtest configuration schema
timeout integer Optional cannot be null buildtest configuration schema
executor-type string Optional cannot be null buildtest configuration schema
remove-stagedir boolean Optional cannot be null buildtest configuration schema
max-jobs integer Optional cannot be null buildtest configuration schema

buildspecs

buildspecs

buildspecs Type

string[]

buildspecs Constraints

minimum number of items: the minimum number of items for this array is: 1

unique items: all items in this array must be unique. Duplicates are not allowed.

exclude-buildspecs

exclude-buildspecs

exclude-buildspecs Type

string[]

exclude-buildspecs Constraints

minimum number of items: the minimum number of items for this array is: 1

unique items: all items in this array must be unique. Duplicates are not allowed.

tags

tags

tags Type

string[]

tags Constraints

minimum number of items: the minimum number of items for this array is: 1

unique items: all items in this array must be unique. Duplicates are not allowed.

exclude-tags

exclude-tags

exclude-tags Type

string[]

exclude-tags Constraints

minimum number of items: the minimum number of items for this array is: 1

unique items: all items in this array must be unique. Duplicates are not allowed.

executors

executors

executors Type

string[]

executors Constraints

minimum number of items: the minimum number of items for this array is: 1

unique items: all items in this array must be unique. Duplicates are not allowed.

filter

filter

filter Type

object (Details)

module

module

module Type

string

unload-modules

unload-modules

unload-modules Type

string

module-purge

module-purge

module-purge Type

boolean

rebuild

Specify number of tests to rebuild

rebuild

rebuild Type

integer

rebuild Constraints

maximum: the value of this number must smaller than or equal to: 50

minimum: the value of this number must greater than or equal to: 1

limit

Limit number of tests to build

limit

limit Type

integer

limit Constraints

minimum: the value of this number must greater than or equal to: 1

account

account

account Type

string

maxpendtime

Specify maximum pending time in seconds

maxpendtime

maxpendtime Type

integer

maxpendtime Constraints

minimum: the value of this number must greater than or equal to: 1

pollinterval

Specify poll interval in seconds

pollinterval

pollinterval Type

integer

pollinterval Constraints

minimum: the value of this number must greater than or equal to: 1

procs

procs

procs Type

integer[]

procs Constraints

minimum number of items: the minimum number of items for this array is: 1

unique items: all items in this array must be unique. Duplicates are not allowed.

nodes

nodes

nodes Type

integer[]

nodes Constraints

minimum number of items: the minimum number of items for this array is: 1

unique items: all items in this array must be unique. Duplicates are not allowed.

testdir

Specify test directory where buildtest will write tests.

testdir

testdir Type

string

timeout

timeout

timeout Type

integer

timeout Constraints

minimum: the value of this number must greater than or equal to: 1

executor-type

Specify the executor-type field used by --executor-type option which determines if test will run by local or batch executor

executor-type

executor-type Type

string

executor-type Constraints

enum: the value of this property must be equal to one of the following values:

Value Explanation
"local"  
"batch"  

remove-stagedir

Remove stage directory after test completes

remove-stagedir

remove-stagedir Type

boolean

max-jobs

Maximum number of jobs that can be run at a given time for a particular executor

max-jobs

max-jobs Type

integer

max-jobs Constraints

minimum: the value of this number must greater than or equal to: 1