NameDateSize

..16-Mar-201612 KiB

.dockerignore13-Oct-20140

.gitignore27-Nov-20141.1 KiB

.gitmodules23-Oct-2014105

.ruby-version28-May-201411

.travis.yml13-Oct-2014577

app/07-Aug-20144 KiB

AUTHORS11-Apr-20143.4 KiB

bin/27-Nov-20144 KiB

CHANGELOG.md16-Feb-20157.6 KiB

ci/10-Jan-20144 KiB

config/23-Feb-20154 KiB

config.ru17-Apr-2015301

custom_plan.rb26-Oct-2013197

data/06-Oct-20144 KiB

db/02-Feb-20154 KiB

doc/02-Oct-20144 KiB

Dockerfile17-Oct-20141.8 KiB

dolt.ru26-Oct-201373

Gemfile17-Apr-20153.1 KiB

Gemfile.lock17-Apr-201511.6 KiB

Guardfile30-Nov-20131.7 KiB

HACKING.md26-Oct-20131.8 KiB

hooks/01-Sep-20144 KiB

ldap-wizard/12-May-20144 KiB

lib/16-Feb-20154 KiB

LICENSE29-Dec-201233.7 KiB

log/26-Oct-20134 KiB

Procfile26-Oct-2013259

public/13-Dec-20134 KiB

Rakefile10-Jan-2014254

README.md10-Apr-20143.1 KiB

script/06-Oct-20144 KiB

test/03-Dec-20144 KiB

tmp/26-Oct-20134 KiB

todo.org26-Oct-20131.9 KiB

Vagrantfile03-Dec-20141.8 KiB

vendor/11-Apr-20144 KiB

zeus.json26-Oct-2013466

README.md

1# Gitorious.org
2
3Gitorious is a web application for hosting, managing and contributing on Git
4repositories.
5
6# Contributing
7
8Please see HACKING
9
10# License
11
12Please see the LICENSE file
13
14# Performing tasks on the command line
15
16Gitorious 3 ships with a set of high-level abstractions called use cases and
17commands. These can be used to carry out many tasks e.g. from the command-line.
18Using the use cases ensures that every step of a certain task is carried out,
19and you don't end up with inconsistent data. See the app/use_cases directory
20for further information.
21
22# Installation
23
24To install Gitorious locally visit [getgitorious.com](http://getgitorious.com).
25
26# Messaging server
27
28Many Gitorious operations are performed asynchronously to ensure good
29performance. Examples of such tasks includes updating the database when pushing
30to Gitorious, creating bare git repositories when creating repositories in the
31web UI and more. To process these asynchronous actions, Gitorious uses a
32messaging system where it sends messages to a queue, and a worker (i.e. another
33process, usually some kind of daemon) fetches messages back for processing.
34
35Gitorious provides several messaging implementations ("adapters"). The
36alternatives along with how to install and run them are presented below. You
37only need one of these alternatives.
38
39## Sync adapter
40
41Processes messages synchronously, which means that no extra process is
42required. This is a very simple solution, but will yield poor performance. It's
43intended use is for development, but may also fit small setups where performance
44is not an issue (e.g. if resources are scarce). To use it, simply set
45messaging_adapter in gitorious.yml to "sync":
46
47  messaging_adapter: sync
48
49## Resque adapter
50
51Resque uses Redis as a backend for messaging. It comes with a nice
52administration interface that allows for resending of messages, introspection
53and general statistics about your queue. To use it, set messaging_adapter to
54"resque" in gitorious.yml:
55
56    messaging_adapter: resque
57
58To use Resque, you need to install and run Redis. This is described in detail on
59the official Resque page: https://github.com/resque/resque
60
61To process messages from the queue with Resque, you need to run rake:
62
63    RAILS_ENV=production QUEUE=* bin/rake resque:work
64
65You can also run a worker for a single, or a handful of queues too. This allows
66you to assign different priority to different queues. The list of queues in use
67can be found in lib/gitorious/messaging/resque_adapter.rb.
68
69Note that Gitorious generally uses JMS style queue names, e.g.
70/queue/GitoriousPostReceiveWebHook. Because the Resque web frontend does not
71handle queue names with slashes in them, we strip queue names such that the
72aforementioned queue will be named GitoriousPostReceiveWebHook under Resque.
73
74
75# More Help
76
77* Consult the mailinglist (http://groups.google.com/group/gitorious) or drop
78  by #gitorious on irc.freenode.net if you have questions.
79
80
81# Gotchas
82
83Gitorious will add a 'forced command' to your ~/.ssh/authorized_keys file for
84the target host: if you start finding ssh oddities suspect this first. Don't
85log out until you've ensured you can still log in remotely.
86