2.4 KiB
How do the workflows work?
-
When there is a push to the private repo's 'dev' branch (private/dev),
regressworkflow runs the regression tests. -
If
regressworkflow fails on 'private/dev',syncworkflow gets triggered and it pushes the latest changes to the public repo's 'dev' branch (public/dev). After this push,regressworkflow will also run on 'public/dev'. -
If
regressworkflow successfully passes on 'private/dev',versionworkflow gets triggered. It creates a new version commit and tag, and pushes to 'private/dev', 'public/dev', 'public/stable'. -
When there is a push with new version to the 'public/stable' branch,
deployworkflow runs. It deploys the PyPI package of OpenRAM. -
If there is a pull request on either repo,
regressworkflow runs on that pull request. -
If there is a push to 'public/dev',
regressworkflow runs (it also happens when pull requests are merged). -
If
regressworkflow successfully passes on 'public/dev',versionworkflow gets triggered. It creates a new version commit and tag, and pushes to 'private/dev', 'public/dev', and 'public/stable'.
Important Notes
-
Workflows understand that the latest commit has a new version with the following commit message syntax.
Bump version: <any message>Automatically generated version commit have the following syntax:
Bump version: a.b.c -> a.b.d -
versionworkflow only increments the right-most version digit. Other digits in the version number must be updated manually following the syntax above. -
regressworkflow doesn't run if the push has a new version. We assume that this commit was automatically generated after a previous commit passedregressworkflow or was manually generated with caution. -
regressworkflow doesn't run on branches named 'stable'. -
deployworkflow only runs on branches named 'stable'. -
versionworkflow is only triggered from branches named 'dev' if they passregressworkflow. -
syncworkflow only runs on the private repo. -
Pull requests merged on to 'public/dev' will also trigger
regressand it can create a new version. -
Merging pull requests that don't pass
regressworkflow on the public repo should be avoided since it won't update the private repo automatically. To prevent merging by mistake, the dev branch can be protected in the GitHub settings. -
Merging pull requests on the private repo should be safe in any case.