Configuring Test OS - dogtagpki/pki GitHub Wiki

Overview

By default the CI will perform tests using latest Fedora version. Sometimes it’s necessary to test against a different Fedora version (e.g. Rawhide) for development.

In PKI 11.5 or later the test OS can be configured by creating a variable called BASE_IMAGE to store the base image (e.g. registry.fedoraproject.org/fedora:rawhide) of the test container. To reset the test OS simply remove the variable.

Prior to PKI 11.5 the test OS can be configured by creating a GitHub secret called BASE64_OS to store the base64-encoded value of the Fedora version (e.g. rawhide). To reset the test OS simply remove the secret.

Deleting Old Caches

When changing the OS configuration, be sure to delete old GitHub caches such that the tests will run with the correct OS:

  • Go to Actions β†’ Click Caches in the left menu.

  • Delete caches as appropriate.

Configuring Test OS

Configuring test OS for PKI 11.5 or newer

To test against Fedora Rawhide on GitHub, create an Action variable:

  • Go to Settings β†’ Secrets and variables β†’ Actions β†’ Variables.

  • Click New repository variable.

  • Enter BASE_IMAGE as the variable name.

  • Enter registry.fedoraproject.org/fedora:rawhide as the variable value.

  • Click Add variable.

To test against Fedora Rawhide on Azure DevOps, create a Pipeline variable:

  • Go to the project Pipelines.

  • Open a recently run pipeline.

  • Click Edit.

  • Click Variables.

  • Click +.

  • Enter BASE_IMAGE as the variable name.

  • Enter registry.fedoraproject.org/fedora:rawhide as the variable value.

  • Click OK.

Configuring test OS for older PKI versions

To test against Fedora Rawhide on GitHub, base-64 encode the Fedora version with the following command:

$ echo "rawhide" | base64
cmF3aGlkZQo=

Then create the secret:

  • Go to Settings β†’ Secrets.

  • Click New repository secret.

  • Enter BASE64_OS as the secret name.

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

  • Click Add secret

Resetting Test OS

Resetting test OS for PKI 11.5 or newer

To reset the test OS on GitHub, remove the variable:

  • Go to Settings β†’ Secrets and variables β†’ Actions β†’ Variables.

  • Click Remove next to BASE_IMAGE.

  • Click Yes, remove this variable.

To reset the test OS in Azure DevOps, remove the variable:

  • Go to the project Pipelines.

  • Open a recently run pipeline.

  • Click Edit.

  • Click Variables.

  • Click the trash icon next to BASE_IMAGE.

  • Click Save.

Resetting test OS for older PKI versions

To reset the test OS prior on GitHub, remove the secret:

  • Go to Settings β†’ Secrets.

  • Click Remove next to BASE64_OS.

  • Click Yes, remove this secret.

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