aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/dev/contrib/cqkeywords.md
blob: a8b7ad453d97827ada7bd5fe37e4b54579af517c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
Commit Queue Keywords
=====================

COMMIT
------

If you want to test your CL through the commit queue but are not ready to commit 
the changes yet, you can add the following line to the CL description:

    COMMIT=false

The CQ will run through its list of verifiers (reviewer check, trybots, tree check, 
presubmit check), and will close the issue instead of committing it.

    CQ_INCLUDE_TRYBOTS

Allows you to add arbitrary trybots to the CQ's list of default trybots. 
The CQ will block till these tryjobs pass just like the default list of tryjobs.

This is the format of the values of this keyword:

    CQ_INCLUDE_TRYBOTS=master1:bot1,bot2;master2:bot3,bot4

Here are some real world examples:

    CQ_INCLUDE_TRYBOTS=tryserver.chromium:linux_layout_rel

    CQ_INCLUDE_TRYBOTS=tryserver.skia:Build-Mac10.9-Clang-x86_64-Debug

    CQ_EXCLUDE_TRYBOTS

Allows you to remove trybots from the CQ's list of default trybots. Should only be 
used when particular builders are failing for reasons unrelated to your code changes.

This is the format of the values of this keyword:

    CQ_EXCLUDE_TRYBOTS=master1:bot1,bot2;master2:bot3,bot4

Here are some real world examples:

    CQ_EXCLUDE_TRYBOTS=tryserver.chromium:win_chromium_compile_dbg

    CQ_EXCLUDE_TRYBOTS=tryserver.skia:Build-Win7-VS2010-x86-Debug-Trybot

    CQ_TRYBOTS

Allows you to list every trybot that you want to run for your CL.

This is the format of the values of this keyword:

    CQ_TRYBOTS=master1:bot1,bot2;master2:bot3,bot4

Here are some real world examples:

    CQ_TRYBOTS=tryserver.chromium:linux_chromium_gn_rel,linux_chromium_chromeos_rel,
      android_dbg_triggered_tests,android_dbg,mac_chromium_rel,win_chromium_x64_rel

    CQ_TRYBOTS=tryserver.skia:Build-Win7-VS2010-x86-Debug-Trybot,
      Test-Ubuntu13.10-ShuttleA-NoGPU-x86_64-Debug-Trybot,
      Build-Ubuntu13.10-GCC4.8-x86_64-Release-Trybot,
      Build-Ubuntu13.10-Clang-x86_64-Debug-Trybot,Build-Mac10.8-Clang-x86_64-Release-Trybot 

TBR
---

If you are a Skia committer and cannot wait for a review, 
then you can include the TBR keyword in your CL's description.

Example:

    TBR=rmistry@google.com

    NOTREECHECKS

If you want to skip the tree status checks, to make the CQ commit a CL even if the tree is closed, 
you can add the following line to the CL description:

    NOTREECHECKS=true

This is discouraged, since the tree is closed for a reason. However, in rare cases this is acceptable, 
primarily to fix build breakages (i.e., your CL will help in reopening the tree).

    NOPRESUBMIT

If you want to skip the presubmit checks, add the following line to the CL description:

    NOPRESUBMIT=true

NOTRY
-----

If you cannot wait for the try job results, you can add the following line to the CL description:

    NOTRY=true

The CQ will then not run any try jobs for your change and will commit the CL as soon as the tree is open, assuming the presubmit check passes.