This document provides a brief overview of how Chrome changes get committed and tested on ChromeOS.
For details on non-Chrome ChromeOS changes, see Life of a ChromeOS commit.
Once a change is completed and tested locally, upload it to [codereview]:
git cl upload
The Chrome commit queue has a very large pool of builders that will apply individual changes to the master, build them, and test them.
A developer can click on ‘Choose trybots’ to select specific builders to run (there are a lot of them).
Alternately they can click ‘CQ dry run’ to run all of the builders that the CQ will run in advance, without scheduling a commit.
Once a change has been reviewed and approved, the developer can apply the CQ+2 label, which marks the change ready for the CQ.
The cros trybots include:
target_os = "chromeos"that runs
unit_testsfor Chrome on ChromeOS.
If the CQ builders succeed then the change will be committed to the master. Otherwise the ‘CQ+2’ label will need to be reapplied once the failure is fixed or determined to be unrelated to the change.
Once a change is committed on the master, it is picked up by the chromium waterfall. This includes a very large number of builders that will thoroughly test the commit, including a number of public ChromeOS builders and a few private builders. Their tests can run on linux-chromeos, ChromeOS VMs, and ChromeOS DUTs (Device Under Test).
Note: Due to lab limitations not every builder in the waterfall is included in the Commit Queue. For ChromeOS there are a few Debug and device testers that only exist on the waterfall. Failures there are infrequent but possible, so keep an eye out!
Once a Chrome change lands in the master, it needs to be landed via PUpr uprev before it will be picked up by ChromeOS. PUpr watches chrome tags as they are created each day and cuts a CL to the current gardener to land. Changes are included in ChromeOS builds once the uprev CL makes it through the ChromeOS CQ. There is a PUpr Dashboard that shows the current status of the uprev CLs as well as the age of the current chrome version on ChromeOS.