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.zipARM64_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