Skip to main content

Contributor Guide

Local Development​

Build the image locally from the sc-images root:

docker build -t benchmark-passmark:local images/benchmark-passmark

CICI: Continuous IntegrationThe practice of building and testing code automatically on every change, usually on a hosted service such as GitHub Actions, so problems show up before the change is merged.WikipediaGlossary builds the image for amd64 and arm64, the default platforms, because the image has no PLATFORMS file. It copies the resource-trackerresource-trackerAn open-source Spare Cores tool that runs a command and samples resource usage while it runs, such as CPU, memory, disk, network, GPU, and GPU memory use. It can optionally stream the samples to the Spare Cores Sentinel platform, so that a run can be checked to see its aggregated and detailed resource utilization, e.g., whether it used all CPU or GPU cores as intended while running a Navigator benchmark workload.resource-tracker on GitHubGlossary binary from the image set by the RESOURCE_TRACKER_IMAGE build argument: the Dockerfile defaults to ghcr.io/sparecores/resource-tracker:main, and CI sets ghcr.io/sparecores/resource-tracker:main-${ARCH} in BUILD_ARGS.

PassMark Download​

The build downloads PassMarkPassMarkThe PerformanceTest benchmark suite of PassMark Software, for Windows, Linux, macOS, and mobile devices. It runs fixed CPU, memory, disk, and graphics tests, such as math workloads involving compression, encryption, and physics simulations, and combines the results into an overall PassMark Rating.PerformanceTestGlossary PerformanceTest for Linux from passmark.com, with browser-like request headers, and installs the binary as /usr/local/bin/pt_linux. The following build arguments set the download URLsURL: Uniform Resource LocatorThe address of a resource on the web or a network, such as https://sparecores.com/, made of a scheme, a host, and a path.Glossary:

  • INTEL_URL (amd64): https://www.passmark.com/downloads/PerformanceTest_Linux_x86-64.zip
  • ARM64_URL (arm64): https://www.passmark.com/downloads/PerformanceTest_Linux_ARM64.zip

These URLs always serve the latest release, so the PassMark build is not pinned, and a rebuild can change it. PassMark publishes no versioned download URLs, so pinning a build would mean keeping a copy of its archive in the sc-images repository. See PassMark Version for how this affects results.

Terminal Libraries​

The image installs the legacy libtinfo5 and libncurses5 terminal libraries for PassMark from .deb files in pkgs/, because they might be deleted from the package mirrors:

  • amd64: version 6.4-2
  • arm64: version 6.2-0ubuntu2.1