- # Operation: This job template checks out and builds each patch provided in job parameters, creates a distribution
- # containing these patches, and triggers the distribution test job which includes most (if not all) available
- # CSIT jobs
- # TODO: Move the following to appropriate readthedocs document.
- # Recommended Sandbox usage:
- # 0. Create this job and a CSIT job you want to run on the new .zip in Sandbox (disable timed triggers).
- # 1. Copy the csit job name to clipboard.
- # 2. Navigate to Sandbox page of this job.
- # 3. Click "Configure".
- # 4. Locate "Trigger/call builds on other projects" (under "Post Steps" tab).
- # 5. Delete the long value of "Projects to build" field and paste the job name from clipboard (ctrl+a, ctrl+v).
- # 6. Click "Save" button.
- # 7. Click "Build with Parameters".
- # yamllint disable-line rule:line-length
- # 8. Start the job with your parameters, see https://wiki.opendaylight.org/view/Integration/Test/Running_System_Tests#Running_System_Tests_Using_Custom_Distribution_Built_From_Multiple_Patches
- # 9. The multipatch job waits for the csit job to finish, so abort csit if you see something went wrong.
- # 10. Navigate to Sandbox page of the csit job, click the run triggered from multipatch.
- # 11. Click Parameters and copy the long value of BUNDLE_URL field to clipboard.
- # 12. Run the same csit job woth different patchset or test options, or other csit jobs, with this BUNDLE_URL value
- # so you do not have to wait for multipatch build. Repeat step 12.
- # 13. Currently, the .zip lasts 24 hours (?) so you may need to jump to step 2 (or 0) after some time.
+ # Operation: This job template checks out and builds in order each patch provided in job parameters, finally
+ # it creates a distribution containing all patches and triggers the distribution test job which includes most
+ # (if not all) available CSIT jobs.