AuroraMiddleware/skia2
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
974165680c
skia2/site/dev/testing/swarmingbots.md

79 lines
4.5 KiB
Markdown
Raw Normal View History

Update docs on Skia bots. No-Try: true Docs-Preview: https://skia.org/?cl=52163 Change-Id: I2bcd73bc7597219e4748c28e9120b5138a0eb3d1 Reviewed-on: https://skia-review.googlesource.com/52163 Reviewed-by: Eric Boren <borenet@google.com> Reviewed-by: Ravi Mistry <rmistry@google.com> Commit-Queue: Ben Wagner <benjaminwagner@google.com>
2017-09-27 18:45:47 +00:00
Skia Swarming Bots
==================
Overview
--------
Skia's Swarming bots are hosted in three places:
* Google Compute Engine. This is the preferred location for bots which don't need to run on physical
hardware, ie. anything that doesn't require a GPU or a specific hardware configuration. Most of
our compile bots live here, along with some non-GPU test bots on Linux and Windows. We get
surprisingly stable performance numbers from GCE, despite very few guarantees about the physical
hardware.
* Chrome Golo. This is the preferred location for bots which require specific hardware or OS
configurations that are not supported by GCE. We have several Mac, Linux, and Windows bots in the
Golo.
* The Skolo (local Skia lab in Chapel Hill). Anything we can't get in GCE or the Golo lives
here. This includes a wider variety of GPUs and all Android, ChromeOS, iOS, and other devices.
[go/skbl](https://goto.google.com/skbl) lists all Skia Swarming bots.
Add section for how to connect to Skia swarming bots No-Try: true Docs-Preview: https://skia.org/?cl=67849 Bug: skia:7098 Change-Id: Ib603bdd2117aab6f626cd68e26529d277a0f1508 Reviewed-on: https://skia-review.googlesource.com/67849 Commit-Queue: Ravi Mistry <rmistry@google.com> Reviewed-by: Kevin Lubick <kjlubick@google.com> Reviewed-by: Ben Wagner <benjaminwagner@google.com>
2017-11-06 21:10:42 +00:00
<a name="connecting-to-swarming-bots"></a>
Connecting to Swarming Bots
---------------------------
Point to new CT swarming bots project ID No-Try: true Docs-Preview: https://skia.org/?cl=132085 Bug: skia:8010 Change-Id: I44f45d6e6511700524f6fb4d389ab740ed2d6f9d Reviewed-on: https://skia-review.googlesource.com/132085 Reviewed-by: Ben Wagner <benjaminwagner@google.com> Commit-Queue: Ravi Mistry <rmistry@google.com>
2018-06-05 13:28:31 +00:00
- Machine name like “skia-gce-NNN”, “skia-ct-gce-NNN”, “skia-i-gce-NNN”, “ct-gce-NNN”, “ct-xxx-builder-NNN” -> GCE
Update doc for connecting to GCE bots. No-Try: true Docs-Preview: https://skia.org/?cl=116544 Change-Id: Ia10e638513907efa368411dfb7c8d90247a4ffee Reviewed-on: https://skia-review.googlesource.com/116544 Reviewed-by: Ravi Mistry <rmistry@google.com> Reviewed-by: Eric Boren <borenet@google.com> Commit-Queue: Ben Wagner <benjaminwagner@google.com>
2018-03-26 21:08:00 +00:00
* First determine the project for the bot:
+ skia-gce-NNN, skia-ct-gce-NNN: [skia-swarming-bots](https://console.cloud.google.com/compute/instances?project=skia-swarming-bots)
Point to new CT swarming bots project ID No-Try: true Docs-Preview: https://skia.org/?cl=132085 Bug: skia:8010 Change-Id: I44f45d6e6511700524f6fb4d389ab740ed2d6f9d Reviewed-on: https://skia-review.googlesource.com/132085 Reviewed-by: Ben Wagner <benjaminwagner@google.com> Commit-Queue: Ravi Mistry <rmistry@google.com>
2018-06-05 13:28:31 +00:00
+ skia-i-gce-NNN: [google.com:skia-buildbots](https://console.cloud.google.com/compute/instances?project=google.com:skia-buildbots)
+ ct-gce-NNN, ct-xxx-builder-NNN: [ct-swarming-bots](https://console.cloud.google.com/compute/instances?project=ct-swarming-bots)
Update doc for connecting to GCE bots. No-Try: true Docs-Preview: https://skia.org/?cl=116544 Change-Id: Ia10e638513907efa368411dfb7c8d90247a4ffee Reviewed-on: https://skia-review.googlesource.com/116544 Reviewed-by: Ravi Mistry <rmistry@google.com> Reviewed-by: Eric Boren <borenet@google.com> Commit-Queue: Ben Wagner <benjaminwagner@google.com>
2018-03-26 21:08:00 +00:00
* To log in to a Linux bot in GCE, use `gcloud compute ssh --project <project> default@<machine name>`. Choose the zone listed on the VM's detail page (see links above). You may also specify the zone using the `--zone` command-line flag.
* To log in to a Windows bot in GCE, on the VM's detail page, first click the "Set Windows password" button, then click the "RDP" button. (If it hasn't been installed, you will be instructed to install the Chrome RDP Extension for GCP.)
Add section for how to connect to Skia swarming bots No-Try: true Docs-Preview: https://skia.org/?cl=67849 Bug: skia:7098 Change-Id: Ib603bdd2117aab6f626cd68e26529d277a0f1508 Reviewed-on: https://skia-review.googlesource.com/67849 Commit-Queue: Ravi Mistry <rmistry@google.com> Reviewed-by: Kevin Lubick <kjlubick@google.com> Reviewed-by: Ben Wagner <benjaminwagner@google.com>
2017-11-06 21:10:42 +00:00
- Machine name ends with “a9”, “m3”, "m5" -> Chrome Golo/Labs
Point to better doc for ChOps swarming bots. No-Try: true Docs-Preview: https://skia.org/?cl=151367 Change-Id: I68cbe6e77c4dd9df6d43fc2b25850df8ec317f94 Reviewed-on: https://skia-review.googlesource.com/151367 Auto-Submit: Ben Wagner <benjaminwagner@google.com> Reviewed-by: Kevin Lubick <kjlubick@google.com> Commit-Queue: Kevin Lubick <kjlubick@google.com>
2018-09-04 15:12:54 +00:00
* To log in to Golo bots, see [go/chrome-infra-build-access](https://goto.google.com/chrome-infra-build-access).
Add section for how to connect to Skia swarming bots No-Try: true Docs-Preview: https://skia.org/?cl=67849 Bug: skia:7098 Change-Id: Ib603bdd2117aab6f626cd68e26529d277a0f1508 Reviewed-on: https://skia-review.googlesource.com/67849 Commit-Queue: Ravi Mistry <rmistry@google.com> Reviewed-by: Kevin Lubick <kjlubick@google.com> Reviewed-by: Ben Wagner <benjaminwagner@google.com>
2017-11-06 21:10:42 +00:00
- Machine name starts with “skia-e-”, “skia-i-” (other than “skia-i-gce-NNN”), “skia-rpi-” -> Chapel Hill lab (aka Skolo)<br/>
To log in to Skolo bots, see the [Skolo maintenance doc][remote access] remote access section. See the following for OS specific instructions:<br/>
* [Remotely debug an Android device in Skolo][remotely debug android]
* [VNC to Skolo Windows bots][vnc to skolo windows]
* [ChromeOS Debugging][chromeos debugging]
Update docs on Skia bots. No-Try: true Docs-Preview: https://skia.org/?cl=52163 Change-Id: I2bcd73bc7597219e4748c28e9120b5138a0eb3d1 Reviewed-on: https://skia-review.googlesource.com/52163 Reviewed-by: Eric Boren <borenet@google.com> Reviewed-by: Ravi Mistry <rmistry@google.com> Commit-Queue: Ben Wagner <benjaminwagner@google.com>
2017-09-27 18:45:47 +00:00
Debugging
---------
Add more detail to Swarming bot doc. No-Try: true Docs-Preview: https://skia.org/?cl=54561 Change-Id: Id7bcccf1ffa7b1726bc5f9394178a629078b1225 Reviewed-on: https://skia-review.googlesource.com/54561 Commit-Queue: Ben Wagner <benjaminwagner@google.com> Reviewed-by: Ravi Mistry <rmistry@google.com> Reviewed-by: Eric Boren <borenet@google.com>
2017-10-03 20:31:35 +00:00
If you need to run code on a specific machine/device to debug an issue, the simplest option is to
run tryjobs (after adding debugging output to the relevant code). In some cases you may also need to
[create or modify tryjobs](automated_testing#adding-new-jobs).
Add section for how to connect to Skia swarming bots No-Try: true Docs-Preview: https://skia.org/?cl=67849 Bug: skia:7098 Change-Id: Ib603bdd2117aab6f626cd68e26529d277a0f1508 Reviewed-on: https://skia-review.googlesource.com/67849 Commit-Queue: Ravi Mistry <rmistry@google.com> Reviewed-by: Kevin Lubick <kjlubick@google.com> Reviewed-by: Ben Wagner <benjaminwagner@google.com>
2017-11-06 21:10:42 +00:00
For Googlers: If you need more control (e.g. to run GDB) and need run to directly on a swarming bot then you can use [leasing.skia.org](https://leasing.skia.org).<br/>
If that does not work then the [current trooper][current trooper] can help you bring the device back to your desk and connect
it to GoogleGuest Wifi or the [Google Test Network](http://go/gtn-criteria).
Update docs on Skia bots. No-Try: true Docs-Preview: https://skia.org/?cl=52163 Change-Id: I2bcd73bc7597219e4748c28e9120b5138a0eb3d1 Reviewed-on: https://skia-review.googlesource.com/52163 Reviewed-by: Eric Boren <borenet@google.com> Reviewed-by: Ravi Mistry <rmistry@google.com> Commit-Queue: Ben Wagner <benjaminwagner@google.com>
2017-09-27 18:45:47 +00:00
If you need to make changes on a Skolo device, please check with an Infra team member. Most can be
flashed/imaged back to a clean state, but others can not.
If a permanent change needs to be made on the machine (such as an OS or driver update), please [file
Add more detail to Swarming bot doc. No-Try: true Docs-Preview: https://skia.org/?cl=54561 Change-Id: Id7bcccf1ffa7b1726bc5f9394178a629078b1225 Reviewed-on: https://skia-review.googlesource.com/54561 Commit-Queue: Ben Wagner <benjaminwagner@google.com> Reviewed-by: Ravi Mistry <rmistry@google.com> Reviewed-by: Eric Boren <borenet@google.com>
2017-10-03 20:31:35 +00:00
a bug][infra bug] and assign to jcgregorio for reassignment.
Update docs on Skia bots. No-Try: true Docs-Preview: https://skia.org/?cl=52163 Change-Id: I2bcd73bc7597219e4748c28e9120b5138a0eb3d1 Reviewed-on: https://skia-review.googlesource.com/52163 Reviewed-by: Eric Boren <borenet@google.com> Reviewed-by: Ravi Mistry <rmistry@google.com> Commit-Queue: Ben Wagner <benjaminwagner@google.com>
2017-09-27 18:45:47 +00:00
Add more detail to Swarming bot doc. No-Try: true Docs-Preview: https://skia.org/?cl=54561 Change-Id: Id7bcccf1ffa7b1726bc5f9394178a629078b1225 Reviewed-on: https://skia-review.googlesource.com/54561 Commit-Queue: Ben Wagner <benjaminwagner@google.com> Reviewed-by: Ravi Mistry <rmistry@google.com> Reviewed-by: Eric Boren <borenet@google.com>
2017-10-03 20:31:35 +00:00
[current trooper]: http://skia-tree-status.appspot.com/trooper
[remote access]:
https://docs.google.com/document/d/1zTR1YtrIFBo-fRWgbUgvJNVJ-s_4_sNjTrHIoX2vulo/edit#heading=h.2nq3yd1axg0n
[infra bug]: https://bugs.chromium.org/p/skia/issues/entry?template=Infrastructure+Bug
Add section for how to connect to Skia swarming bots No-Try: true Docs-Preview: https://skia.org/?cl=67849 Bug: skia:7098 Change-Id: Ib603bdd2117aab6f626cd68e26529d277a0f1508 Reviewed-on: https://skia-review.googlesource.com/67849 Commit-Queue: Ravi Mistry <rmistry@google.com> Reviewed-by: Kevin Lubick <kjlubick@google.com> Reviewed-by: Ben Wagner <benjaminwagner@google.com>
2017-11-06 21:10:42 +00:00
[remotely debug android]: https://docs.google.com/document/d/1nxn7TobfaLNNfhSTiwstOnjV0jCxYUI1uwW0T_V7BYg/
[vnc to skolo windows]:
https://docs.google.com/document/d/1zTR1YtrIFBo-fRWgbUgvJNVJ-s_4_sNjTrHIoX2vulo/edit#heading=h.7cqd856ft0s
[chromeos debugging]:
https://docs.google.com/document/d/1yJ2LLfLzV6pXKjiameid1LHEz1mj71Ob4wySIYxlBdw/edit#heading=h.9arg79l59xrf
Update docs on Skia bots. No-Try: true Docs-Preview: https://skia.org/?cl=52163 Change-Id: I2bcd73bc7597219e4748c28e9120b5138a0eb3d1 Reviewed-on: https://skia-review.googlesource.com/52163 Reviewed-by: Eric Boren <borenet@google.com> Reviewed-by: Ravi Mistry <rmistry@google.com> Commit-Queue: Ben Wagner <benjaminwagner@google.com>
2017-09-27 18:45:47 +00:00
Maintenance Tasks
-----------------
Add more detail to Swarming bot doc. No-Try: true Docs-Preview: https://skia.org/?cl=54561 Change-Id: Id7bcccf1ffa7b1726bc5f9394178a629078b1225 Reviewed-on: https://skia-review.googlesource.com/54561 Commit-Queue: Ben Wagner <benjaminwagner@google.com> Reviewed-by: Ravi Mistry <rmistry@google.com> Reviewed-by: Eric Boren <borenet@google.com>
2017-10-03 20:31:35 +00:00
See the [Skolo maintenance doc][skolo maintenance].
[skolo maintenance]:
https://docs.google.com/document/d/1zTR1YtrIFBo-fRWgbUgvJNVJ-s_4_sNjTrHIoX2vulo/edit
Reference in New Issue Copy Permalink