Blame doc/usage/read_only.rst

Vivek Anand 1d13b0
Understanding Read Only Mode of projects
Vivek Anand 1d13b0
=========================================
Vivek Anand 1d13b0
Vivek Anand 1d13b0
If a project is in Read Only Mode, the users of the project may not be
Vivek Anand 1d13b0
able to modify the git repository of the project. Let's say you forked
Vivek Anand 1d13b0
a project, then the forked project goes into a read only mode. You won't
Vivek Anand 1d13b0
be able to modify the git repository of the forked project in that mode.
Vivek Anand 1d13b0
After the read only mode is gone, you can begin to use the git repository
Vivek Anand 1d13b0
again. Let's say you decide to add another user to your fork, this time
Vivek Anand 1d13b0
the project will go in read only mode again but, you still will be able
Vivek Anand 1d13b0
to use the git repository while the new user will have to wait for read
Vivek Anand 1d13b0
only mode to get over. This is also true when you remove a user from your
Vivek Anand 1d13b0
project. The removed user can still access the project's git repository,
Vivek Anand 1d13b0
given that he had at least commit access, until the read only mode is over.
Vivek Anand 1d13b0
Vivek Anand 1d13b0
In Pagure, we use gitolite for Access Control Lists when using SSH.
Vivek Anand 1d13b0
Modifying gitolite may be a time taking task (depending on number of projects
Vivek Anand 1d13b0
hosted on the pagure instance) that's why Pagure does it outside of HTTP
Vivek Anand 1d13b0
Request-Response Cycle.
Vivek Anand 1d13b0
Vivek Anand 1d13b0
Whenever you fork a project or add/remove a new user/group to project,
Vivek Anand 1d13b0
gitolite needs to be refreshed in order to put those changes in effect
Vivek Anand 1d13b0
for ssh based git usage.
Vivek Anand 1d13b0
Vivek Anand 1d13b0
Vivek Anand 1d13b0
Actions that put the project in read only mode
Vivek Anand 1d13b0
==============================================
Vivek Anand 1d13b0
Vivek Anand 1d13b0
All the actions that needs gitolite to be compiled, will bring the
Vivek Anand 1d13b0
project in read only mode.
Vivek Anand 1d13b0
Vivek Anand 1d13b0
* Creating/Forking a project. (only the fork will be in read only mode)
Vivek Anand 1d13b0
* Adding/Removing a user/group from a project.