Configuring Test Matrix - dogtagpki/pki GitHub Wiki

Overview

By default the CI will perform tests using latest Fedora version. Sometimes it’s necessary to test against different Fedora versions. This can be done by creating a GitHub secret called BASE64_MATRIX to store the base64-encoded value of the test matrix. To reset the test matrix simply remove the secret.

Note
Since PKI 11.4 the BASE64_MATRIX parameter has been replaced with BASE64_OS.

Configuring Test Matrix

For example, to test against Fedora 34 and 35, prepare the test matrix as follows:

{
    "os": ["34", "35"]
}

Convert the value into a single line, escape the double quotes, then base64-encode the value:

$ echo "{\"os\": [\"34\", \"35\"]}" | base64
eyJvcyI6IFsiMzQiLCAiMzUiXX0K

Then create the secret:

  • Go to SettingsSecrets.

  • Click New repository secret.

  • Enter BASE64_MATRIX as the secret name.

  • Enter the base64-encoded value as the secret value.

  • Click Add secret

Before Testing

It is a good idea to delete any caches that may exist in your repo before starting:

  • Go to Actions → Click Caches in the left menu.

  • Delete caches as appropriate.

Resetting Test Matrix

To reset the test matrix, remove the secret:

  • Go to SettingsSecrets.

  • Click Remove next to BASE64_MATRIX.

  • Click Yes, remove this secret.

⚠️ **GitHub.com Fallback** ⚠️