opendev/system-config
Code Issues Proposed changes

Add instructions on how to disable a third party ci account

Browse Source 
Change-Id: Idb04a31a6b3b4697d2199e601b0a1b4d4bff0c85
This commit is contained in:
Yolanda Robla 2016-01-08 18:06:43 +01:00
parent abec9d984a
commit 74e36c01f4
1 changed files with 38 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
doc/source/gerrit.rst
View File

@ -656,3 +656,41 @@ When there is a change in HTML headers, or CSS, this can be applied
without the need of restarting Gerrit. To do that, ssh in the Gerrit without the need of restarting Gerrit. To do that, ssh in the Gerrit
instance, and touch GerritSiteHeader.html and/or GerritSite.css, instance, and touch GerritSiteHeader.html and/or GerritSite.css,
under /home/gerrit2/review_site/etc directory. under /home/gerrit2/review_site/etc directory.
Deactivating a Gerrit account
-----------------------------
To deactivate a Gerrit account (use case can be a failing Third Party CI), you
must follow that steps:
1. Identify the account ID of the Third Party CI you need to deactivate. Third-Party CI
members can be found on: https://review.openstack.org/#/admin/groups/270,members
That will give you the name and email of all members. Then you can get the matching
numerical account ID with the help of REST API:
curl -i -H "Accept: application/json" --digest --user <<gerrit_user>>:<<http_pass>> -X GET https://review.openstack.org/a/accounts/{email}
This will return a JSON dictionary, that will contain _account_id field.
2. Mark the account as inactive using gerrit ssh api, with:
ssh -p 29418 review.openstack.org gerrit set-account --inactive {account-id}
Alternatively you can use REST API, sending a DELETE for:
curl -i -H "Accept: application/json" --digest --user <<gerrit_user>>:<<http_pass>> -X DELETE https://review.openstack.org/a/accounts/{account-id}/active
3. Check if there are active gerrit ssh connections:
ssh -p 29418 review.openstack.org gerrit show-connections -n | grep {account-id}
And kill all of them with subsequent:
ssh -p 29418 review.openstack.org gerrit close-connection {connection-id}
4. You can check if the account is properly marked as inactive using REST API,
sending a GET for:
curl -i -H "Accept: application/json" --digest --user <<gerrit_user>>:<<http_pass>> -X GET https://review.openstack.org/a/accounts/{account-id}/active
A 200 return code means the account is active, and 204 means account inactive.
4. In the case of a failing Third Party CI, if the account caused a loop of comments in
a change, you can delete them with following query:
delete from change_messages where author_id={account-id} and change_id={change-id};