Skip to content

[llvm][docs] Document how to get admin permissions for a Buildbot worker #108561

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 14, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 30 additions & 1 deletion llvm/docs/HowToAddABuilder.rst
Original file line number Diff line number Diff line change
Expand Up @@ -276,4 +276,33 @@ Leave it on the staging buildmaster
impacting the broader community. The sponsoring organization simply
has to take on the responsibility of all bisection and triage.


Managing a Worker From The Web Interface
========================================

Tasks such as clearing pending building requests can be done using
the Buildbot web interface. To do this you must be recognised as an admin
of the worker:

* Set your public GitHub profile email to one that was included in the
``admin`` information you set up on the worker. It does not matter if this
is your primary account email or a "verified email". To confirm this has been
done correctly, go to ``github.com/<your GitHub username>`` and you should
see the email address listed there.

A worker can have many admins, if they are listed in the form
``First Last <[email protected]>, First2 Last2 <[email protected]>``.
You only need to have one of those addresses in your profile to be recognised
as an admin.

If you need to add an email address, you can edit the ``admin`` file and
restart the worker. You should see the new admin details in the web interface
shortly afterwards.

* Connect GitHub to Buildbot by clicking on the "Anonymous" button on the
top right of the page, then "Login with GitHub" and authorise the app.

Some tasks don't give immediate feedback, so if nothing happens within a short
time, try again with the browser's web console open. Sometimes you will see
403 errors and other messages that might indicate you don't have the correct
details set up.

Loading