From 6c3d8b03be6b8d4f99ba31ce7b6be136de84ecaa Mon Sep 17 00:00:00 2001 From: Anita Kuno Date: Wed, 14 May 2014 10:10:00 -0400 Subject: [PATCH] The process for making a Third-Party CI voting needs docs Currently the process for making a Third-Party CI system voting is not documented. This patch documents the current ideal process for moving a Third-Party CI system from the non-voting permissions group to the voting permissions group in Gerrit. Change-Id: I762aec397f1c0c26bab62fbcb124e8b002066a43 --- doc/source/third_party.rst | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/doc/source/third_party.rst b/doc/source/third_party.rst index f541d223bb..8b05bc6f12 100644 --- a/doc/source/third_party.rst +++ b/doc/source/third_party.rst @@ -221,3 +221,39 @@ can test your CI system without affecting regular OpenStack reviews. Once you confirm your CI system works as you expected, change your configuration of gerrit trigger plugin or zuul to subscribe gerrit events from your target project. + +Permissions on your Third Party System +-------------------------------------- + +When your CI account is created it will be in the `Third-Party CI Gerrit +group `_. +The permissions on this group allow for commenting and voting on the +`openstack-dev/sandbox `_ +repo as well as commenting without voting on other repos in gerrit. + +In order to get your Third Pary CI account to have voting permissions on +repos in gerrit in addition to ``openstack-dev/sandbox`` you have a greater +chance of success if you follow these steps: + +* Set up your system and test it according to "Testing your CI setup" outlined + above (this will create a history of activity associated with your account + which will be evaluated when you apply for voting permissions). + +* Post comments, that adhere to the "Requirements" listed above, that demonstrate + the format for your system communication to the repos you want your system to test. + +* Once your Third Party Account has a history on gerrit so that others can evaluate + your format for comments, and the stability of your voting pattern (in the sandbox repo): + + * send an email to the openstack-dev mailing list nominating your system for voting + permissions + * openstack-dev@lists.openstack.org + * use tags [Infra][Nova] for the Nova program, please replace [Nova] with [Program], + where [Program] is the name of the program your CI account will test + * present your account history + * address any questions and concerns with your system + +* If the members of the program you want voting permissions from agree your system should be + able to vote, the ptl or a core-reviewer from the program communicates this decision to the + OpenStack Infrastructure team who will move your Third Party CI System to the `Voting + Third-Party CI Gerrit group `_.