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)

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