The OpenLab CI is built based on
Zuul tools of the OpenStack infrastructure. The CI jobs definition uses Ansible playbooks. Learn more about the tools first:
Zuul documentation is hosted on Zuul
NodePool documentation is hosted on NodePool
Ansible documentation is hosted on Ansible Docs
The accepted test requests can be found in TODO list, developers can get start with following steps:
Pick one test request you wish to work on, move it to IN PROGRESS list, edit it to add the development plan into comments
Fork your own copy of the CI job repository openlab-zuul-jobs to your account, develop the test job and submit a PR(Pull Request) to openlab-zuul-jobs. In order to manage the test request well, please add change details and link the test request number in PR's commit message, the format like:
OpenLab development team @theopenlab/dev will review the PR and give some suggestion, development core team @theopenlab/dev-core have permission to merge it if there is no issue, at the meanwhile, you should contact @theopenlab/dev-core to add the target project into main.yaml in zuul node if it is not in project list of zuul
When your PR is merged into master of openlab-zuul-jobs, trigger to test the integration job by trigger comments, see the build status, click result
FAILURE enter the build web page and then click the
log url to get the log details if the job fail. Maybe you can find some problems of job, feel free to submit new pull request to openlab-zuul-jobs to fix job issue, link the issue number of related test request in PR's commit message as we do on step3
In Progress test request by yourself when the work completely, notify @theopenlab/governance and @theopenlab/docs to update website and documents in RP comments.
If your test request need some physical machines, please contact @theopenlab/governance members in IRC channel or send them an email, they will help you to get OpenLab dedicated resources to launch testing
When you can access the physical machines, move your test request to IN PROGRESS list, edit it to add the development plan into comments
When the work is completely, close the
In Progress test request by yourself, please commit the test result into comments of test request related issue. A blog also is a good choice to show more details of testing. Notify @theopenlab/governance and @theopenlab/docs to update website and documents in RP comments.
Bug reports for OpenLab are tracked in bug list
Perhaps the merged CI job will fail due to some reasons after it has been running for some time, or if you find any other problems of OpenLab, welcome to new an issue
The development core team @theopenlab/dev-core will confirm the bugs, add them into TODO list
Submit a PR(Pull Request) to openlab-zuul-jobs to fix bug, please add change details and link the bug number in PR's commit message:
OpenLab development team @theopenlab/dev will review the PR and give some suggestion, development core team @theopenlab/dev-core have permission to merge it if there is no issue. When the PR is merged into openlab-zuul-jobs, you can test jobs by trigger comments
In Progress bug by yourself when the bug is fixed.