Change to test suites at git migration

[James Bruten (james-bruten-mo)]

Dear All,

One of the noticeable changes that will happen when we move to github involves changes to the rose-stem suites in the different repositories. While these will continue to keep the same tests, user interaction with them will change. The test suites will now be launched with the syntax,

cylc vip -z group=<GROUP1,GROUP2> -n <NAME_OF_WORKFLOW> ./rose-stem

• -z group= behaves the same way as the old --group=to select which tasks or groups of tasks to run
• Naming your suite with -n is recommended as it will now default to the directory name which is always rose-stem.
• You will need to provide the path to the rose-stem directory (or run from that directory).
• Existing -S options will continue to work, eg. -S USE_EXAB=true

The test suite will now install and play from a single command, unlike before where a separate play command was required. Reloading the workflows should also now work as per normal cylc workflows.

For more information on running a test suite, please see https://metoffice.github.io/simulation-systems/Development/testing.html

The method to specify the sources of linked tickets has also now changed. All repositories will contain a dependencies.yaml file at the top level which lists all feeder repositories and the source used for each. To specify a different source, edit the source variable to point at the desired fork, and the ref variable to set the branch name or commit hash. Please see https://metoffice.github.io/simulation-systems/Development/TestSuites/multi-repo_testing.html for details of how these variables work.

Many thanks,
James