diff options
author | David Spickett <david.spickett@linaro.org> | 2024-10-14 09:09:20 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-10-14 09:09:20 +0100 |
commit | 57cd6d86340bb8b26df4358fc3c237581d697f14 (patch) | |
tree | 3b8679f986fa0fcb7507d3a2667ac4a1c53206cf /llvm/docs | |
parent | a07639f4bb89c4e56afcfcd7935a9438fd2e69f5 (diff) | |
download | llvm-57cd6d86340bb8b26df4358fc3c237581d697f14.zip llvm-57cd6d86340bb8b26df4358fc3c237581d697f14.tar.gz llvm-57cd6d86340bb8b26df4358fc3c237581d697f14.tar.bz2 |
[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.
Diffstat (limited to 'llvm/docs')
-rw-r--r-- | llvm/docs/HowToAddABuilder.rst | 31 |
1 files changed, 30 insertions, 1 deletions
diff --git a/llvm/docs/HowToAddABuilder.rst b/llvm/docs/HowToAddABuilder.rst index 1333753..f07640f 100644 --- a/llvm/docs/HowToAddABuilder.rst +++ b/llvm/docs/HowToAddABuilder.rst @@ -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 <first.last@example.com>, First2 Last2 <first2.last2@example.com>``. + 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. + |