Skip to content

Commit 57cd6d8

Browse files
[llvm][docs] Document how to get admin permissions for a Buildbot worker (#108561)
I spent a long time trying different combinations of primary and verified emails, until a colleague tried it who happened to have a public profile email set when I did not. Document how this works to save everyone else the legwork.
1 parent a07639f commit 57cd6d8

File tree

1 file changed

+30
-1
lines changed

1 file changed

+30
-1
lines changed

llvm/docs/HowToAddABuilder.rst

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -276,4 +276,33 @@ Leave it on the staging buildmaster
276276
impacting the broader community. The sponsoring organization simply
277277
has to take on the responsibility of all bisection and triage.
278278

279-
279+
Managing a Worker From The Web Interface
280+
========================================
281+
282+
Tasks such as clearing pending building requests can be done using
283+
the Buildbot web interface. To do this you must be recognised as an admin
284+
of the worker:
285+
286+
* Set your public GitHub profile email to one that was included in the
287+
``admin`` information you set up on the worker. It does not matter if this
288+
is your primary account email or a "verified email". To confirm this has been
289+
done correctly, go to ``github.com/<your GitHub username>`` and you should
290+
see the email address listed there.
291+
292+
A worker can have many admins, if they are listed in the form
293+
``First Last <[email protected]>, First2 Last2 <[email protected]>``.
294+
You only need to have one of those addresses in your profile to be recognised
295+
as an admin.
296+
297+
If you need to add an email address, you can edit the ``admin`` file and
298+
restart the worker. You should see the new admin details in the web interface
299+
shortly afterwards.
300+
301+
* Connect GitHub to Buildbot by clicking on the "Anonymous" button on the
302+
top right of the page, then "Login with GitHub" and authorise the app.
303+
304+
Some tasks don't give immediate feedback, so if nothing happens within a short
305+
time, try again with the browser's web console open. Sometimes you will see
306+
403 errors and other messages that might indicate you don't have the correct
307+
details set up.
308+

0 commit comments

Comments
 (0)