summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFredrik Luthander <fredrik.luthander@sonyericsson.com>2011-12-21 18:38:45 +0100
committerMartin Fick <mfick@codeaurora.org>2011-12-28 12:34:48 -0700
commit71267063e57aed4a0e58f07fd2128a278562019f (patch)
tree9dfa8adb120433942825c8347e5af70f7e9500c9
parentda8678845e172d5af34534d6693aa0fcb2250ab0 (diff)
Access control documentation: Conversion table between 2.1 and 2.2
Since the permissions have been rewritten entirely between Gerrit release series 2.1.x and 2.2.x, a table to ease conversion from 2.1.x is added. The table tries to address the old permissions one by one except for the push tag permission which in effect needed two permissions to work properly. This should be familiar to the administrator used to the 2.1.x permission model however. Change-Id: Id5429138d1170e0881b5331123dfd3e810d3f1c9 Signed-off-by: Fredrik Luthander <fredrik.luthander@sonyericsson.com>
-rw-r--r--Documentation/access-control.txt38
1 files changed, 38 insertions, 0 deletions
diff --git a/Documentation/access-control.txt b/Documentation/access-control.txt
index 749e644dc7..d3833dfe0c 100644
--- a/Documentation/access-control.txt
+++ b/Documentation/access-control.txt
@@ -300,6 +300,11 @@ Gerrit comes pre-configured with several default categories that
can be granted to groups within projects, enabling functionality
for that group's members.
+With the release of the Gerrit 2.2.x series, the web GUI for ACL
+configuration was rewritten from scratch. Use this
+<<conversion_table,table>> to better understand the access rights
+conversions from the Gerrit 2.1.x to the Gerrit 2.2.x series.
+
[[category_label-Verified]]
Label: Verified
@@ -728,6 +733,39 @@ The new column will appear at the end of the table (in position 3),
and `-1 Do not have copyright` will block submit, while `+1 Copyright
clear` is required to enable submit.
+
+[[conversion_table]]
+Conversion table from 2.1.x series to 2.2.x series
+--------------------------------------------------
+
+[options="header"]
+|=================================================================================
+|Gerrit 2.1.x |Gerrit 2.2.x
+|Code review |Label: Code review
+|Verify |Label: Verify
+|Forge Identity +1 |Forge author identity
+|Forge Identity +2 |Forge committer & author identity
+|Forge Identity +3 |Forge server & committer & author identity
+|Owner |Owner
+|Push branch +1 |Push
+|Push branch +2 |Create reference & Push
+|Push branch +3 |Push (with force) & Create reference
+|Push tag +1 & Push Branch +2 |No support to limit to push signed tag
+|Push tag +2 & Push Branch +2 |Push annotated tag
+|Read +1 |Read
+|Read +2 |Read & Push branch (refs/for/refs/...)
+|Read +3 |Read & Push branch (refs/for/refs/...) & Push merge
+|Submit |Submit
+|=================================================================================
+
+[NOTE]
+In Gerrit 2.2.x, the way to set permissions for upload has changed entirely.
+To upload a change for review is no longer a separate permission type,
+instead you grant ordinary push permissions to the actual
+recieving reference. In practice this means that you set push permissions
+on `refs/for/refs/heads/<branch>` rather than permissions to upload changes
+on `refs/heads/<branch>`.
+
[[restart_changes]]
[NOTE]
Restart the Gerrit web application and reload all browsers after