Testflinger

Testflinger is a system for orchestrating time-shared access to a pool of target machines.

Each Testflinger system consists of:

  • a web service (called just Testflinger) that provides an API to request jobs by placing them on a queue

  • per-machine agents that wait for jobs to be placed on queues they can service and then process them

Jobs can be either fully automated scripts that can attempt to complete within the allocated time or interactive shell sessions.

The Testflinger system is particularly useful for sharing finite machine resources between different consumers in a predictable fashion.

Typically this has been used for managing a test lab where CI/CD test runs and also exploratory testing by human operators is desired.

In this documentation

Tutorial

Get started - a hands-on introduction to Testflinger for new users

Get started with Testflinger CLI
How-to guides

Step-by-step guides - covering key operations and common tasks

How-to guides
Reference

Technical information - specifications, APIs, architecture

Reference
Explanation

Discussion and clarification of key concepts

Explanation

Project and community

Testflinger is a member of the Ubuntu family. It is an open source project that warmly welcomes community contributions, suggestions, fixes and constructive feedback.