NewbieGuide
Differences between revisions 9 and 22 (spanning 13 versions)
Size: 4819
Comment:
|
← Revision 22 as of 2015-09-02 04:12:32 ⇥
Size: 59
Comment:
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
= Newbie guide = What you need to know if you are new to the citrain landing team: == What do do == * read this document * join #ubuntu-ci-eng * join #ubuntu-ci-choo-choo and highlight on "trainguards" (the bot "CI-SNCF" has a bunch of commands (like where unity8)) * wait for new rows in the spreedsheet (the CI-SNCF bot will notify you) and perform the "steps for a landing" described below * wait for stuff to be ready for publishing (the bot will tell you about it) and perform the "steps for publishing" below * the expectation is to do up to 50% of your work time on landings == What is it == The citrain is a tool to coordinate landing of new features. This includes building/testing and publishing. * 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 1 slio free for emergency landings * The spreedsheet has multiple page (sheets), the main one is "pending", but there is also "Archive" that contains *all* of the history and pages for each landing slio. * Merge propoosal to land (row F) is important, order of the branches is important. Branches are 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 via "landing team tools/assign silo" menu item (more see below) == What steps for a landing == * landing for a request: * check if it has a testplan * check if the package is locked already (via hoover over column F) * 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" == Steps for publishing == * when a landing is build the ci-train bot will say so in the #ubuntu-ci-train-choo-choo channel * check what landing number it is (e.g. landing-017) and go to the spreedsheet page (sheet) of that number * click on "publish" there, that links to a jenkins page * click on "build" * if there are packaging changes the circle on the left will turn yellow and you need to review the build artifcat with the packaging diff (e.g. packaging_changes_nuntium_0.1+14.10.20140702.2-0ubuntu1.diff), then click on "Build with Parameters" on the left and select ACK_PACKAGING_CHANGES * the status should be "blue" (successful), you can close the jenkins tab now * now the lander needs to cleanup the silo, the bot will notify him/her == What about CI-Airline == * will replace 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 * CI Train Sherrif is the guy/gal currently doing landings == 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/ * Who is who: https://wiki.ubuntu.com/citrain/LandingTeam * https://wiki.ubuntu.com/citrain/FAQ |
#REFRESH 0 https://wiki.ubuntu.com/citrain/LandingProcess |
citrain/NewbieGuide (last edited 2015-09-02 04:12:32 by 1)