File: trybot_usage.md

package info (click to toggle)
chromium 73.0.3683.75-1~deb9u1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 1,792,156 kB
  • sloc: cpp: 13,473,466; ansic: 1,577,080; python: 898,539; javascript: 655,737; xml: 341,883; asm: 306,070; java: 289,969; perl: 80,911; objc: 67,198; sh: 43,184; cs: 27,853; makefile: 12,092; php: 11,064; yacc: 10,373; tcl: 8,875; ruby: 3,941; lex: 1,800; pascal: 1,473; lisp: 812; awk: 41; jsp: 39; sed: 19; sql: 3
file content (71 lines) | stat: -rw-r--r-- 1,886 bytes parent folder | download
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
# Using the trybots

[TOC]

## Overview

The trybots let committers try uncommitted patches on multiple platforms in
an automated way.

 - Trybots include all platforms for which we currently build Chromium, though
   they may not support all configurations built on CI.
 - The commit queue runs a subset of available trybots. See [here][1] for more
   information.
 - trybots can be manually invoked via `git cl try` or the "Choose Trybots"
   UI in gerrit.
 - Any committer can use the trybots.
 - Non-committers with tryjob access can also use the trybots. See [here][2]
   for more information.
 - External contributors without tryjob access can ask committers to run
   tryjobs for them.

## Workflow

1. Upload your change to gerrit via `git cl upload`
2. Run trybots:

    * Run the default set of trybots by starting a CQ dry run, either by
      setting CQ+1 on gerrit or by running `git cl try` with no arguments.
    * Run trybots of your choice by providing arguments to `git cl try`:

        * specify bucket name with `-B/--bucket`. For chromium tryjobs, this
          should always be `luci.chromium.try`
        * specify bot names with `-b/--bot`. This can be specified more than once.

### Examples

Launching a CQ dry run:

```bash
$ git cl try
```

Launching a particular trybot:

```bash
$ git cl try -B luci.chromium.try -b linux_chromium_rel_ng
```

Launching multiple trybots:

```bash
$ git cl try -B luci.chromium.try \
  -b android-binary-size \
  -b ios-simulator-full-configs \
  -b linux-blink-rel \
  -b win7-blink-rel
  # etc
```

## Bugs? Feature requests? Questions?

[File a trooper bug.][3]

## Legacy documentation

 - [Design doc][4]

[1]: /docs/infra/cq.md
[2]: https://www.chromium.org/getting-involved/become-a-committer#TOC-Try-job-access
[3]: https://g.co/bugatrooper
[4]: https://www.chromium.org/developers/testing/try-server-usage/design