Skip to content

36. Use upload_runs to upload a test suite

If you have executed the test suite with FRun, in the test suite directory (<work-dir>/sessions/<timestamp>/<timestamp>), there is a collect_runs.sh file that invokes the upload_runs utility to upload the test suite results to the Foretify Manager server.

Note

Every test suite needs to be uploaded into a specific project, given by its ID (--project_id) or name (--project).

If you did not specify a work directory, look for the sessions directory in $HOME/foretify. The directory containing the runs should be provided by --runs_top_dir.

You can override the env variable settings for host and port using the corresponding switches on upload_runs. See upload_runs for more information.

Note

The test suite results (TSR) containing your runs will be named with your username followed by a timestamp. You can optionally provide a name for the new test suite by using --run_group_name.

Note

Foretify Manager will only have access to the runs' debugging data (Visualizer, trace data, etc.) if it has file-access to the directory they were uploaded from (which is recorded in the runDir attribute of each run).

To upload the test suite data to Foretify Manager:

Execute the following command:

Shell command: upload_runs
$ upload_runs --user "mylogin" \
  --host 169.23.41.523 --port 8080 \
  --runs_top_dir myworkdir/sessions/20221123_150125_10395_4B60/20221123_150125_25680_WD19/foretify_runs/batch \
  --project "My Team's Project"

In addition to uploading runs from the local file-system, Foretify Manager supports retrieving runs from Amazon's Simple Storage Service (S3). This can be done by passing --s3_url instead of --runs_top_dir, pointing to an S3 bucket with some prefix, to fetch the test runs from.

Example:

Shell command: upload_runs
$ upload_runs --user "mylogin"" \
  --host 169.23.41.523 --port 8080 \
  --s3_url http://s3-eu-central-1.amazonaws.com/some_bucket/some/prefix/to/my/runs \
  --project "My Team's Project"

See Integrate Foretify Manager with S3 for details about how to configure the Foretify Manager server.