Test Format

Pipeline-level test discovery, environment variables, parameters, and group snapshot handling.

Test Discovery

The pipeline locates tests-k8s.yml using source.git.context from the Konflux Snapshot. For example, if source.git.context is images/curl, the pipeline looks for images/curl/tests-k8s.yml in the source tree.

When source.git.context is not populated (currently the case for the triggering component in PR-triggered pipelines, tracked as KONFLUX-12674), a heuristic fallback derives the context from the component name: it tries images/<base> and then <base>.

The actual tests-k8s.yml format is opaque to the pipeline — it is passed to the repository’s test runner script, which defines the structure and semantics. See the respective repository documentation for the YAML format.

Environment Variables

The test runner receives these variables from the pipeline:

Variable	Description
`TEST_IMAGE`	Container image under test (with digest)
`TEST_GROUP`	Image group name (e.g., `git`, `postgresql`)
`TEST_VARIANT`	Variant being tested (e.g., `default`, `builder`)
`KUBECONFIG`	Path to kubeconfig for the ephemeral namespace
`TEST_IMAGES`	Bash associative array of all images in the snapshot
`TEST_IMAGES_PATH`	Path to source `TEST_IMAGES` in external scripts
`TEST_RUN_ID`	Unique ID for this test run (for resource naming)
`TEST_RUN_LABEL`	Label selector for cleanup (e.g., `hum-k8s-test=<id>`)
`test_fail`	Shell function — call `test_fail "message"` to fail a test

Pipeline Parameters

Parameter	Description	Default
`SNAPSHOT`	Konflux snapshot JSON or snapshot name (with `snapshot-param-as-name` annotation)	—
`EXTRA_SINGLE_COMPONENT_ARGS`	Additional arguments appended to the test runner for single-component (PR) snapshots	`--include-reverse-deps`

Group Snapshot Handling

For group snapshots (post-merge), the pipeline exports:

IMAGE_NAMES — space-separated list of all component names
IMAGE_URL_<COMPONENT> — image URL for each component (name uppercased, dashes replaced with underscores)

The test runner script is called once with multiple --group-component-name arguments. Test discovery checks all components for tests-k8s.yml. Source is fetched from the first component’s build attestation (shared source tree).