OLD | NEW |
1 syntax = "proto2"; | 1 syntax = "proto2"; |
2 | 2 |
3 // This message describes a Commit Queue configuration. The config file cq.cfg | 3 // This message describes a Commit Queue configuration. The config file cq.cfg |
4 // should be stored in the config directory located on the branch that this CQ | 4 // should be stored in the config directory located on the branch that this CQ |
5 // should commit to. | 5 // should commit to. |
6 message Config { | 6 message Config { |
7 // Required. Version of the config format. | 7 // Required. Version of the config format. |
8 optional int32 version = 1; | 8 optional int32 version = 1; |
9 | 9 |
10 // Required. Name of the CQ. May only contain characters [a-zA-Z0-9_]. It is | 10 // Required. Name of the CQ. May only contain characters [a-zA-Z0-9_]. It is |
(...skipping 77 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
88 // repo url provided in `git_repo_url` above, then | 88 // repo url provided in `git_repo_url` above, then |
89 // https://chromium-review.googlesource.com/#/admin/projects/infra/infra should | 89 // https://chromium-review.googlesource.com/#/admin/projects/infra/infra should |
90 // show general properties of your project. | 90 // show general properties of your project. |
91 // | 91 // |
92 // Also, | 92 // Also, |
93 // https://chromium-review.googlesource.com/#/admin/projects/infra/infra,access | 93 // https://chromium-review.googlesource.com/#/admin/projects/infra/infra,access |
94 // should show ACLs for refs in your project, but you may need to be admin to | 94 // should show ACLs for refs in your project, but you may need to be admin to |
95 // see it. This will come handy to enable and customize the CQ-related workflows | 95 // see it. This will come handy to enable and customize the CQ-related workflows |
96 // for your project. | 96 // for your project. |
97 message Gerrit { | 97 message Gerrit { |
98 // If set, tells CQ to set score on a given label to mark result of CQ run. | 98 // Optional. If set, tells CQ vote on a given label to mark result of CQ run. |
99 // Typically, this is Commit-Queue-Verified label. | 99 // The vote is either -1 if failed or 1 on success, and will be given on |
100 // If not set, CQ will just try to hit submit button. | 100 // non-dry runs only. |
| 101 // This vote can then be used in Gerrit's rule for submitting issues, so as to |
| 102 // require CQ run. CQ will attempt to submit issue only after setting this |
| 103 // label. |
101 optional string cq_verified_label = 1; | 104 optional string cq_verified_label = 1; |
102 } | 105 } |
103 | 106 |
104 // Verifiers are various types of checks that a Commit Queue performs on a CL. | 107 // Verifiers are various types of checks that a Commit Queue performs on a CL. |
105 // All verifiers must pass in order for a CL to be landed. Configuration file | 108 // All verifiers must pass in order for a CL to be landed. Configuration file |
106 // describes types of verifiers that should be applied to each CL and their | 109 // describes types of verifiers that should be applied to each CL and their |
107 // parameters. | 110 // parameters. |
108 message Verifiers { | 111 message Verifiers { |
109 // This verifier is used to ensure that an LGTM was posted to the code review | 112 // This verifier is used to ensure that an LGTM was posted to the code review |
110 // site from a valid project committer. | 113 // site from a valid project committer. |
111 // This verifier is not supported with Gerrit. | 114 // This verifier is not supported with Gerrit. |
112 optional ReviewerLgtmVerifier reviewer_lgtm = 1; | 115 optional ReviewerLgtmVerifier reviewer_lgtm = 1; |
113 | 116 |
114 // This verifier is used to check tree status before committing a CL. If the | 117 // This verifier is used to check tree status before committing a CL. If the |
115 // tree is closed, then the verifier will wait until it is reopened. | 118 // tree is closed, then the verifier will wait until it is reopened. |
116 optional TreeStatusLgtmVerifier tree_status = 2; | 119 optional TreeStatusLgtmVerifier tree_status = 2; |
117 | 120 |
118 // This verifier triggers a set of tryjobs that are to be run on builders on | 121 // This verifier triggers a set of tryjobs that are to be run on builders on |
119 // Buildbot. It automatically retries failed try-jobs and only allows CL to | 122 // Buildbot. It automatically retries failed try-jobs and only allows CL to |
120 // land if each builder has succeeded in the latest retry. If a given tryjob | 123 // land if each builder has succeeded in the latest retry. If a given tryjob |
121 // result is too old (>1 day) it is ignored. | 124 // result is too old (>1 day) it is ignored. |
122 optional TryJobVerifier try_job = 3; | 125 optional TryJobVerifier try_job = 3; |
123 | 126 |
124 // This verifier is used to ensure that the author has signed Google's | 127 // This verifier is used to ensure that the author has signed Google's |
125 // Contributor License Agreement. | 128 // Contributor License Agreement. |
126 optional SignCLAVerifier sign_cla = 4; | 129 optional SignCLAVerifier sign_cla = 4; |
127 | 130 |
128 message ReviewerLgtmVerifier { | 131 message ReviewerLgtmVerifier { |
129 // Required. Name of the chrome-infra-auth group, which contains the | 132 // Required. Name of the chrome-infra-auth group, which contains the list of |
130 // list of identities authorized to approve (lgtm) a CL. This list is also | 133 // identities authorized to approve (lgtm) a CL and trigger CQ run or dry |
131 // known as a committer list and often corresponds to the list of accounts | 134 // run. |
132 // that have direct commit/push access to the repository. Some older lists | |
133 // are still stored in the CQ source code, but are being moved to the new | |
134 // location (https://crbug.com/511311). | |
135 optional string committer_list = 1; | 135 optional string committer_list = 1; |
136 | 136 |
137 // Number of seconds to wait for LGTM on CQ. Default value is 0. | 137 // Number of seconds to wait for LGTM on CQ. Default value is 0. |
138 optional int32 max_wait_secs = 2; | 138 optional int32 max_wait_secs = 2; |
139 | 139 |
140 // Message to be posted to code review site when no LGTM is found. Default | 140 // Message to be posted to code review site when no LGTM is found. Default |
141 // value is "No LGTM from a valid reviewer yet. Only full committers are " | 141 // value is "No LGTM from a valid reviewer yet. Only full committers are " |
142 // "accepted.\nEven if an LGTM may have been provided, it was from a " | 142 // "accepted.\nEven if an LGTM may have been provided, it was from a " |
143 // "non-committer,\n_not_ a full super star committer.\nSee " | 143 // "non-committer,\n_not_ a full super star committer.\nSee " |
144 // "http://www.chromium.org/getting-involved/become-a-committer\nNote that " | 144 // "http://www.chromium.org/getting-involved/become-a-committer\nNote that " |
145 // "this has nothing to do with OWNERS files." | 145 // "this has nothing to do with OWNERS files." |
146 optional string no_lgtm_msg = 3; | 146 optional string no_lgtm_msg = 3; |
| 147 |
| 148 // Optional, but recommended. Name of the chrome-infra-auth group, |
| 149 // which contains the list of identities authorized to trigger CQ dry run. |
| 150 // This is usually the same group as tryjob-access. |
| 151 optional string dry_run_access_list = 4; |
147 } | 152 } |
148 | 153 |
149 message TreeStatusLgtmVerifier { | 154 message TreeStatusLgtmVerifier { |
150 // Required. URL of the project tree status app. | 155 // Required. URL of the project tree status app. |
151 optional string tree_status_url = 1; | 156 optional string tree_status_url = 1; |
152 } | 157 } |
153 | 158 |
154 message TryJobVerifier { | 159 message TryJobVerifier { |
155 message Builder { | 160 message Builder { |
156 // Name of the builder. | 161 // Name of the builder. |
(...skipping 41 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
198 optional int32 timeout_retry_weight = 5; | 203 optional int32 timeout_retry_weight = 5; |
199 } | 204 } |
200 | 205 |
201 // Provides project specific trybot retry configuration. This overrides the | 206 // Provides project specific trybot retry configuration. This overrides the |
202 // defaults used in the CQ. | 207 // defaults used in the CQ. |
203 optional TryJobRetryConfig try_job_retry_config = 2; | 208 optional TryJobRetryConfig try_job_retry_config = 2; |
204 } | 209 } |
205 | 210 |
206 message SignCLAVerifier {} | 211 message SignCLAVerifier {} |
207 } | 212 } |
OLD | NEW |