Submit a test job

Once you have a YAML or JSON file with your job definition, you can submit the job to the main Testflinger server using the CLI:

$ testflinger-cli submit example-job.yaml

If you want to submit the jobs to a Testflinger server other than the default one, see Connect to a different server.

If the job is successful submitted, you will see a job_id returned by Testflinger:

Job submitted successfully!
job_id: 2bac1457-0000-0000-0000-15f23f69fd39

You can use the job_id to further monitor and manage the submitted job.

You can also store the job_id in an environment variable, to be able to use it in the following commands:

$ JOB_ID="$(testflinger-cli submit -q example-job.yaml)"
$ testflinger-cli poll "${JOB_ID}"

If you will only need the job_id for the polling command, you can use:

$ testflinger-cli submit --poll example-job.yaml

This will submit and start polling right away.