kubitron / redmine_git_hosting

A ChiliProject/Redmine plugin which makes configuring your own git hosting easy.
78 stars 15 forks source link

Clearer installation instructions #81

Open plsamuel opened 12 years ago

plsamuel commented 12 years ago

I have installed the plugin recently and found the instructions to be pretty daunting to follow. Especially the Installation section, it is way to verbose... There are plenty of details that are not necessary for a normal user. I have found this guide to be more "up to the point" it could be used as a starting point: http://nsaunders.wordpress.com/2012/04/24/redmine-gitolite-integration/

Maybe the other details should be in a Troubleshooting after the installation section (like the stuff about git:// protocol).

Also, the stuff about visudo is there twice.

The section about "plugin variables BEFORE you run the db:migrate_plugins" is also too verbose, should be like:

gitScriptDir: location of plugin, ending by "/". If empty, will default to 'REDMINE_ROOT/vendor/plugins/redmine_git_hosting/bin', which is fine for most installations. httpServer: URL of redmine server, including port if necessary, ex: my.server:8080 ...

kubitron commented 12 years ago

I'll look at this. By an large the instructions are intended to cover most configuration options (and every one of the ones mentioned there are ones that people use). I can see if they can be made less verbose.

saric commented 12 years ago

From README:

This plugin does not currently work well when gitServer is on a different physical machine from the Redmine installation (i.e. a different host than httpServer).

What this exactly means: "not currently work well"? Not working at all, partially working, or what? Is there problem with post-receive hook or something else?

kubitron commented 12 years ago

Problem with lots of things, at this point. The plugin will not be able to install the post-receive hook. It will not be able to rearrange the repository when you change the parentage of projects. It will also not be able to view the repository via the repository tab on Redmine. In theory, the latter could work by using actual ssh calls (although would be slower), but right now it su's to the git user in order to look at the repo.

saric commented 12 years ago

I think that it can be done, if following requirements are met:

  1. If httpServer and gitServer have access to shared directory, by using NFS or some clustered filesystem
  2. gitUser's home and git repos are located on this shared filesystem
  3. gitUser have the same uid and home directory on both servers
  4. provide ruby interpreter and required modules used in hooks
kubitron commented 12 years ago

@saric, this is certainly plausible, but is really just a variant of the "all on one machine" version. I was responding to people who wanted a completely separate git server.

BTW, is everything working for you now?