Introduction to Test Runner

FixturFab Test Runner is the factory-floor application for executing pytest-f3ts test plans on FixturFab test fixtures. It provides an easy to use, touch-friendly interface for running and managing tests, capturing results, and guiding operators through the test process on the manufacturing line.

The Test Runner runs inside Balena or Docker containers on the test fixture hardware. For day-to-day operation, see the Users Guide.

Source Code

The Test Runner application (codename Opal) is developed in the following repository:

• Repository: gitlab.com/fixturfab/software/opal

Container Registry

Pre-built Test Runner container images are published to both Google Artifact Registry and the GitLab Container Registry. The Test Runner is composed of the following container images:

Container	Description
backend	Test Runner backend service
browser	Kiosk browser displaying the Test Runner UI
pytest-f3ts-api	API for executing and managing pytest-f3ts test plans
pytest-f3ts-worker	Worker that runs test plans and manages hardware installation and dependencies
runner-frontend	Test Runner web frontend

• Google Artifact Registry:

  us-west1-docker.pkg.dev/test-runner-404519/fixturfab-test-runner/backend
  us-west1-docker.pkg.dev/test-runner-404519/fixturfab-test-runner/browser
  us-west1-docker.pkg.dev/test-runner-404519/fixturfab-test-runner/pytest-f3ts-api
  us-west1-docker.pkg.dev/test-runner-404519/fixturfab-test-runner/pytest-f3ts-worker
  us-west1-docker.pkg.dev/test-runner-404519/fixturfab-test-runner/runner-frontend

• GitLab Container Registry: opal/container_registry

  registry.gitlab.com/fixturfab/software/opal/backend
  registry.gitlab.com/fixturfab/software/opal/browser
  registry.gitlab.com/fixturfab/software/opal/pytest-f3ts-api
  registry.gitlab.com/fixturfab/software/opal/pytest-f3ts-worker
  registry.gitlab.com/fixturfab/software/opal/runner-frontend