When uploading changes to Fuchsia's Gerrit instance, there are various options that can change the behavior of presubmit. These options are represented by special strings added to the commit message of a change.
This page documents the options that can be used for Fuchsia presubmit.
Buganizer issue options
These options control associated bugs in Buganizer.
Bug
Bug: # adds a comment on the given Buganizer issue
when a change is submitted.
For example:
Bug: 372314445
The above line resulted in this comment.
Fixed
Fixed: # adds a comment, and marks as "Fixed", the given
Buganizer issue when a change is submitted.
For example:
Fixed: 297456438
The above line resulted in this comment and status change on the issue.
Dependent changes options
Depends-on
Depends-on: <other-change-id> marks the change as depending on another change,
possibly in a separate repository.
The change with the Depends-on footer will
not be submittable until all dependencies have been submitted, and any
dependencies will also be patched in during presubmit testing.
For example:
Depends-on: Idc82d1483b4be8480aaa87bb48af8d03cfa45858
Test options
These options control how tests are executed.
Multiply
Multiply: <test name> will run the given test multiple times.
This is helpful to confirm that specific tests are not flaky.
For example:
Multiply: socket-integration
The above line reruns the "socket-integration" test multiple times.
Run-All-Tests
Run-All-Tests: true runs all tests, even if static analysis
marks them as unaffected by a change. This option is helpful when
making changes that can implicitly affect the entire system, such
as changes to the Zircon kernel, Component Framework, Test Manager,
or Diagnostics.
Cq-Include-Trybots
Cq-Include-Trybots <list> runs the given builders as part of presubmit
for the change, in addition to the default set of presubmit builders.
For example:
Cq-Include-Trybots: luci.fuchsia.try:fuchsia-coverage-absolute
The above line forces execution of fuchsia-coverage-absolute
along with the other jobs for presubmit.
Use the Choose Tryjobs dropdown in Gerrit to see the full set of available builders.