Skip to content

feat(benchmarks): make busybox image configurable via BUSYBOX_IMAGE env var#98

Open
k-wall wants to merge 1 commit into
SamBarker:feat/omb-kafka-metricsfrom
k-wall:feat/configurable-busybox-image
Open

feat(benchmarks): make busybox image configurable via BUSYBOX_IMAGE env var#98
k-wall wants to merge 1 commit into
SamBarker:feat/omb-kafka-metricsfrom
k-wall:feat/configurable-busybox-image

Conversation

@k-wall
Copy link
Copy Markdown

@k-wall k-wall commented May 19, 2026

Summary

Makes the busybox image used by result collection pods configurable via the BUSYBOX_IMAGE environment variable, allowing users to avoid Docker Hub rate limits by using alternative registries.

Problem

During testing on OpenShift, result collection failed due to Docker Hub rate limiting:

Failed to pull image "busybox:1.37.0@sha256:...": 
toomanyrequests: You have reached your unauthenticated pull rate limit

The busybox image was hardcoded in two places:

  • run-benchmark.sh - OMB results reader pod (collects result.json from PVC)
  • collect-results.sh - JFR debug pod (collects JFR recordings from PVC)

This blocked test completion even though the actual benchmark ran successfully and metrics were collected.

Solution

Added BUSYBOX_IMAGE environment variable to both scripts with sensible defaults:

BUSYBOX_IMAGE="${BUSYBOX_IMAGE:-busybox:1.37.0@sha256:b3255e7dfbcd10cb367af0d409747d511aeb66dfac98cf30e97e87e4207dd76f}"

Users can now override to use alternative registries:

Quay.io (Red Hat):

BUSYBOX_IMAGE="quay.io/quay/busybox:latest" ./scripts/run-benchmark.sh ...

GHCR (GitHub Container Registry):

BUSYBOX_IMAGE="ghcr.io/dockerhub-mirror/busybox:latest" ./scripts/run-benchmark.sh ...

Benefits

  • Avoids Docker Hub rate limits in CI/testing environments
  • Better for OpenShift/Red Hat environments (quay.io has better connectivity)
  • Air-gapped support - users can point to local mirrors
  • Backward compatible - defaults to existing docker.io image

Documentation

Added to Environment section in both scripts' usage:

BUSYBOX_IMAGE    Busybox image for result collection pods (default: docker.io busybox:1.37.0)

Testing

Verified on OpenShift with:

  • BUSYBOX_IMAGE="quay.io/quay/busybox:latest" - successfully avoided rate limits
  • Default (no override) - maintains existing behavior

🤖 Generated with Claude Code

…nv var

The result collection pods use busybox to mount PVCs and copy files.
Previously the image was hardcoded to docker.io busybox:1.37.0, which
can hit Docker Hub rate limits in CI/testing environments.

Added BUSYBOX_IMAGE environment variable to both scripts:
- run-benchmark.sh: for OMB results collection pod
- collect-results.sh: for JFR debug pod

Default remains docker.io busybox:1.37.0 for backward compatibility.
Users can now override to use alternative registries:
  BUSYBOX_IMAGE="quay.io/quay/busybox:latest" ./scripts/run-benchmark.sh ...

This is particularly useful for:
- OpenShift/Red Hat environments (quay.io has better connectivity)
- CI environments hitting Docker Hub rate limits
- Air-gapped environments with local mirrors

Assisted-by: Claude Sonnet 4.5 <noreply@anthropic.com>
Signed-off-by: Keith Wall <kwall@apache.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant