Configuring Test Suites

Overview

The CI tests are organized as test suites (i.e. <name>-tests.yml, not <name>-test.yml) in the following folder:

• https://github.com/dogtagpki/pki/tree/master/.github/workflows

Sometimes it is necessary to limit the test suites that will run in the CI in order to conserve time and resources.

The list of test suites can be specified in a GitHub Action variable TESTS. The variable can be specified directly in GitHub project settings or using GitHub CLI. See also the gh package in Fedora.

The variable should contain a space-delimited names of the test suites (e.g. ca kra ocsp). Test suites that are not listed in this variable will be canceled automatically. However, sometimes the test suite will continue to run despite being canceled.

If the variable is not defined or empty all test suites will run by default.

Displaying List of Test Suites

To display the list using GitHub CLI:

$ gh variable get TESTS -R <owner>/<project>

Configuring List of Test Suites

To configure the list using GitHub CLI:

$ gh variable set TESTS -b <test suites> -R <owner>/<project>

For example, to run CA, CA Clone, KRA, and KRA Clone test suites only:

$ gh variable set TESTS -b "ca ca-clone kra kra-clone" -R edewata/pki

Removing List of Test Suites

To remove the list using GitHub CLI:

$ gh variable delete TESTS -R <owner>/<project>