OpenShift Builds E2E Integration Tests

The e2e-openshift-builds pipeline (pipelines/konflux-e2e-complete-pipeline.yaml) provisions an ephemeral Hypershift cluster, deploys the OpenShift Builds operator from a Konflux snapshot, and runs the full e2e test suite.

Pipeline Parameters

Parameter	Default	Description
SNAPSHOT	test app JSON	Konflux snapshot JSON containing component names and container images. Provided automatically by Konflux integration tests.
VERSION	""	Version suffix for image content source mirrors (e.g. -1-6). Used to construct the ICSP entries that map registry.redhat.io images to Konflux-built mirrors.
TASKS_REPO_URL	https://github.com/redhat-openshift-builds/release.git	Git repository URL containing the e2e task definitions. Override this to test tasks from a fork.
TASKS_REPO_REVISION	main	Git revision (branch, tag, or commit SHA) for the e2e task definitions. Override this alongside TASKS_REPO_URL when testing task changes before merging.
DEBUG	false	Set to true to dump cluster credentials (kubeadmin password, login command) and keep the cluster alive for 10 minutes after pipeline completion for manual investigation.
BUILDS_SAMPLES_REPO	https://github.com/redhat-openshift-builds/samples.git	Repository containing sample Build and BuildRun manifests used for smoke testing before the full e2e suite.
BUILDS_SAMPLES_BRANCH	main	Branch to clone from the builds samples repository.
SHIPWRIGHT_BUILD_REPO	https://github.com/shipwright-io/build.git	Shipwright Build repository containing the ginkgo e2e test suite and sample build strategies.
SHIPWRIGHT_BUILD_BRANCH	main	Branch to clone from the Shipwright build repository.
IMAGE_EXPIRY_HOURS	1	Hours until test images pushed to quay.io/redhat-openshift-builds/e2e-test expire and are auto-deleted by Quay.

Execution Flow

graph LR
    A[provision-eaas-space] --> C[provision-cluster]
    B[validate-snapshot] --> C
    C --> D[verify-fips]
    C --> E[install-openshift-pipelines]
    D --> F[deploy-operator]
    E --> F
    F --> G[verify-images]
    G --> H[run-e2e-tests\n3h timeout]

Loading

• validate-snapshot runs immediately and fails fast if snapshot images are missing or the bundle was built with stale component digests.
• verify-fips and install-openshift-pipelines run in parallel after cluster provisioning.
• deploy-operator waits for both to complete before deploying the operator bundle.

Task Definitions

All e2e task definitions are stored under tasks/ and referenced via git resolver:

Task File	Description
tasks/e2e-validate-snapshot.yaml	Pre-cluster validation of snapshot images and bundle relatedImages
tasks/e2e-provision-cluster.yaml	Provisions an ephemeral Hypershift cluster with FIPS and ICSP configuration
tasks/e2e-verify-fips.yaml	Verifies FIPS is enabled on all cluster worker nodes
tasks/e2e-install-openshift-pipelines.yaml	Installs OpenShift Pipelines operator via OLM subscription
tasks/e2e-deploy-operator.yaml	Deploys the operator bundle, verifies operands and CR status
tasks/e2e-verify-images.yaml	Verifies running operand images match the snapshot
tasks/e2e-run-tests.yaml	Runs sample BuildRuns and the Shipwright ginkgo e2e test suite

Testing with a Fork

To test task changes before merging to the release repository, override the task source parameters:

params:
  - name: TASKS_REPO_URL
    value: "https://github.com/<your-fork>/release.git"
  - name: TASKS_REPO_REVISION
    value: "your-feature-branch"