NewbieGuide
246
Comment:
|
3042
|
Deletions are marked like this. | Additions are marked like this. |
Line 5: | Line 5: |
… | == Introduction == * Its all in one google spreedsheet https://wiki.ubuntu.com/citrain that mostly updates itself automatically (its a frontend to jenkins) * First column in the spreedsheet is important! Keep attention to the number of free silos, try to keep slios free * The spreedsheet has multiple page, the main one is "pending", but there is a important one "Archive" that contains *all* of the history * Merge propoosal to land (row F) is important, order is important too but its not limited to a single project * Additional source packages to land: you need to dput these additional source packages from the archive into the silo PPA * QA sign off needed: only in effect if we are in train-con-zero - and then *only* stuff with QA-sign-off: no can enter the image * Ready? : really important, once its ready, assign to a silo == CI-Airline == * replaces all of CI-Train * no spreedsheet * no jenkins * see http://blueprints.launchpad.net/ubuntu/+spec/core-1311-ci-airline * designed by didrocks, worked on by citeam * will be ready ~July 2014 == Terms == * Silo are PPAs that are used to prepare a landing * Landers are trusted people of the upstream project who can drive landing and do the final testing * TrainCon-Zero: when no new image is generated for 7 buisiness days this "emergency" state is reached and only critical fixes can go in == Tutorial == * landing for a request: * check if it has a testplan * check that its ready * go to the "Landing team tools" menubar and click on "assign silo" * this generates a request-id that is valid for 5min * opens a dialog that you need to check * the jenkins tab opens, click on "proceed" * opens a jenkins job page * check that the speedsheet updates after some time * the details for the landing are in a spreedsheet page N, e.g. "landing-07" * its the job of the lander to click on "BUILD" on this spreedsheet page (which will bring you to a PPA) * once the thing is ready and the lander has executed the test plan he/she sets the status column to testing-done * once that is the case, we go to the landing sheet of the spreedsheet and click on "PUBLISH" * this brings you to jenkins * if there are changes in debian/* it generates a diff and that needs approval first via the "ACK_PACKAGING" box in the build jenkins subpage and press "build" * ??? * lander will click on "merge & clean" |
Line 8: | Line 48: |
* Main landing spreadsheet: https://wiki.ubuntu.com/citrain (refreshes every 5min) * Jenkins that is controlled via the spreedsheet: https://ci-train.ubuntu.com/ * Code for the spreedsheet: lp:cupstream2distro * Testing results: http://ci.ubuntu.com/smokeng/utopic/touch/ * Low-level JSON with the silo status: http://people.canonical.com/~platform/citrain/ * new coolness: http://people.canonical.com/~rbpark/citrain/ |
|
Line 9: | Line 55: |
* Main landing spreadsheet: https://wiki.ubuntu.com/citrain * Testing results: ci.ubuntu.com/smokeng/utopic/touch/ |
Newbie guide
So you want to ride the CI train? Great, here is what you need to know:
Introduction
Its all in one google spreedsheet https://wiki.ubuntu.com/citrain that mostly updates itself automatically (its a frontend to jenkins)
- First column in the spreedsheet is important! Keep attention to the number of free silos, try to keep slios free
- The spreedsheet has multiple page, the main one is "pending", but there is a important one "Archive" that contains *all* of the history
- Merge propoosal to land (row F) is important, order is important too but its not limited to a single project
- Additional source packages to land: you need to dput these additional source packages from the archive into the silo PPA
- QA sign off needed: only in effect if we are in train-con-zero - and then *only* stuff with QA-sign-off: no can enter the image
- Ready? : really important, once its ready, assign to a silo
CI-Airline
- replaces all of CI-Train
- no spreedsheet
- no jenkins
see http://blueprints.launchpad.net/ubuntu/+spec/core-1311-ci-airline
- designed by didrocks, worked on by citeam
- will be ready ~July 2014
Terms
- Silo are PPAs that are used to prepare a landing
- Landers are trusted people of the upstream project who can drive landing and do the final testing
TrainCon-Zero: when no new image is generated for 7 buisiness days this "emergency" state is reached and only critical fixes can go in
Tutorial
- landing for a request:
- check if it has a testplan
- check that its ready
- go to the "Landing team tools" menubar and click on "assign silo"
- this generates a request-id that is valid for 5min
- opens a dialog that you need to check
- the jenkins tab opens, click on "proceed"
- opens a jenkins job page
- check that the speedsheet updates after some time
- the details for the landing are in a spreedsheet page N, e.g. "landing-07"
- its the job of the lander to click on "BUILD" on this spreedsheet page (which will bring you to a PPA)
- once the thing is ready and the lander has executed the test plan he/she sets the status column to testing-done
- once that is the case, we go to the landing sheet of the spreedsheet and click on "PUBLISH"
- this brings you to jenkins
- if there are changes in debian/* it generates a diff and that needs approval first via the "ACK_PACKAGING" box in the build jenkins subpage and press "build"
- ???
lander will click on "merge & clean"
Important links
Main landing spreadsheet: https://wiki.ubuntu.com/citrain (refreshes every 5min)
Jenkins that is controlled via the spreedsheet: https://ci-train.ubuntu.com/
- Code for the spreedsheet: lp:cupstream2distro
Testing results: http://ci.ubuntu.com/smokeng/utopic/touch/
Low-level JSON with the silo status: http://people.canonical.com/~platform/citrain/
new coolness: http://people.canonical.com/~rbpark/citrain/
citrain/NewbieGuide (last edited 2015-09-02 04:12:32 by 1)