Mercurial > kallithea
annotate docs/usage/vcs_support.rst @ 7086:438876d818d3
tests: git changeset authors need to have the format 'username <user@example.com>'
New verions of dulwich caused tests like test_compare_forks_on_branch_extra_commits_git
to fail because of this.
Since this is fixed now, re-allow dulwich versions 0.18.6 and newer.
author | domruf <dominikruf@gmail.com> |
---|---|
date | Thu, 11 Jan 2018 19:59:10 +0100 |
parents | 4d04ac08fff7 |
children |
rev | line source |
---|---|
4970
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
1 .. _vcs_support: |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
2 |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
3 =============================== |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
4 Version control systems support |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
5 =============================== |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
6 |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
7 Kallithea supports Git and Mercurial repositories out-of-the-box. |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
8 For Git, you do need the ``git`` command line client installed on the server. |
811 | 9 |
4970
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
10 You can always disable Git or Mercurial support by editing the |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
11 file ``kallithea/__init__.py`` and commenting out the backend. |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
12 |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
13 .. code-block:: python |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
14 |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
15 BACKENDS = { |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
16 'hg': 'Mercurial repository', |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
17 #'git': 'Git repository', |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
18 } |
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
19 |
5433
fbbe80e3322b
docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents:
5417
diff
changeset
|
20 |
4937
326a9336fbe5
spelling: use correct Git capitalisation where appropriate
Andrew Shadura <andrew@shadura.me>
parents:
4902
diff
changeset
|
21 Git support |
4970
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
22 ----------- |
2325
18d34a56a736
fix for issue #417, git execution was broken on windows for certain commands.
Marcin Kuzminski <marcin@python-works.com>
parents:
2095
diff
changeset
|
23 |
5433
fbbe80e3322b
docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents:
5417
diff
changeset
|
24 |
4902 | 25 Web server with chunked encoding |
5575
ed2fb6e84a02
docs: use consistent style for section titles
Mads Kiilerich <madski@unity3d.com>
parents:
5434
diff
changeset
|
26 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
5433
fbbe80e3322b
docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents:
5417
diff
changeset
|
27 |
4970
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
28 Large Git pushes require an HTTP server with support for |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4937
diff
changeset
|
29 chunked encoding for POST. The Python web servers waitress_ and |
4970
601282d36c06
docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
30 gunicorn_ (Linux only) can be used. By default, Kallithea uses |
6554
2c3d30095d5e
gearbox: replace paster with something TurboGears2-ish that still works with the Pylons stack
Mads Kiilerich <madski@unity3d.com>
parents:
5575
diff
changeset
|
31 waitress_ for `gearbox serve` instead of the built-in `paste` WSGI |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4937
diff
changeset
|
32 server. |
2023
c45fb78969a3
docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents:
1123
diff
changeset
|
33 |
6554
2c3d30095d5e
gearbox: replace paster with something TurboGears2-ish that still works with the Pylons stack
Mads Kiilerich <madski@unity3d.com>
parents:
5575
diff
changeset
|
34 The web server used by gearbox is controlled in the .ini file:: |
3224
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2992
diff
changeset
|
35 |
2023
c45fb78969a3
docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents:
1123
diff
changeset
|
36 use = egg:waitress#main |
c45fb78969a3
docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents:
1123
diff
changeset
|
37 |
2325
18d34a56a736
fix for issue #417, git execution was broken on windows for certain commands.
Marcin Kuzminski <marcin@python-works.com>
parents:
2095
diff
changeset
|
38 or:: |
18d34a56a736
fix for issue #417, git execution was broken on windows for certain commands.
Marcin Kuzminski <marcin@python-works.com>
parents:
2095
diff
changeset
|
39 |
18d34a56a736
fix for issue #417, git execution was broken on windows for certain commands.
Marcin Kuzminski <marcin@python-works.com>
parents:
2095
diff
changeset
|
40 use = egg:gunicorn#main |
3224
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2992
diff
changeset
|
41 |
4902 | 42 Also make sure to comment out the following options:: |
2023
c45fb78969a3
docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents:
1123
diff
changeset
|
43 |
3224
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2992
diff
changeset
|
44 threadpool_workers = |
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2992
diff
changeset
|
45 threadpool_max_requests = |
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2992
diff
changeset
|
46 use_threadpool = |
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2992
diff
changeset
|
47 |
2024
370e995e46c2
fixes in doc about waitress wsgi
Marcin Kuzminski <marcin@python-works.com>
parents:
2023
diff
changeset
|
48 |
4971
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
49 Mercurial support |
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
50 ----------------- |
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
51 |
5433
fbbe80e3322b
docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents:
5417
diff
changeset
|
52 |
4971
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
53 Working with Mercurial subrepositories |
5575
ed2fb6e84a02
docs: use consistent style for section titles
Mads Kiilerich <madski@unity3d.com>
parents:
5434
diff
changeset
|
54 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
5433
fbbe80e3322b
docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents:
5417
diff
changeset
|
55 |
4972
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
56 This section explains how to use Mercurial subrepositories_ in Kallithea. |
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
57 |
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
58 Example usage:: |
4971
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
59 |
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
60 ## init a simple repo |
4972
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
61 hg init mainrepo |
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
62 cd mainrepo |
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
63 echo "file" > file |
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
64 hg add file |
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
65 hg ci --message "initial file" |
4971
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
66 |
4972
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
67 # clone subrepo we want to add from Kallithea |
4971
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
68 hg clone http://kallithea.local/subrepo |
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
69 |
4972
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
70 ## specify URL to existing repo in Kallithea as subrepository path |
4971
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
71 echo "subrepo = http://kallithea.local/subrepo" > .hgsub |
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
72 hg add .hgsub |
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
73 hg ci --message "added remote subrepo" |
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
74 |
4972
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
75 In the file list of a clone of ``mainrepo`` you will see a connected |
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
76 subrepository at the revision it was cloned with. Clicking on the |
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
77 subrepository link sends you to the proper repository in Kallithea. |
4971
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
78 |
4972
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
79 Cloning ``mainrepo`` will also clone the attached subrepository. |
4971
9cef5a168b88
docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4970
diff
changeset
|
80 |
4972
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
81 Next we can edit the subrepository data, and push back to Kallithea. This will |
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
82 update both repositories. |
811 | 83 |
6734
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
84 .. _importing: |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
85 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
86 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
87 Importing existing repositories |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
88 ------------------------------- |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
89 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
90 There are two main methods to import repositories in Kallithea: via the web |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
91 interface or via the filesystem. If you have a large number of repositories to |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
92 import, importing them via the filesystem is more convenient. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
93 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
94 Importing via web interface |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
95 ^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
96 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
97 For a small number of repositories, it may be easier to create the target |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
98 repositories through the Kallithea web interface, via *Admin > Repositories* or |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
99 via the *Add Repository* button on the entry page of the web interface. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
100 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
101 Repositories can be nested in repository groups by first creating the group (via |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
102 *Admin > Repository Groups* or via the *Add Repository Group* button on the |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
103 entry page of the web interface) and then selecting the appropriate group when |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
104 adding the repository. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
105 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
106 After creation of the (empty) repository, push the existing commits to the |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
107 *Clone URL* displayed on the repository summary page. For Git repositories, |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
108 first add the *Clone URL* as remote, then push the commits to that remote. The |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
109 specific commands to execute are shown under the *Existing repository?* section |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
110 of the new repository's summary page. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
111 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
112 A benefit of this method particular for Git repositories, is that the |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
113 Kallithea-specific Git hooks are installed automatically. For Mercurial, no |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
114 hooks are required anyway. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
115 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
116 Importing via the filesystem |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
117 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
118 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
119 The alternative method of importing repositories consists of creating the |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
120 repositories in the desired hierarchy on the filesystem and letting Kallithea |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
121 scan that location. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
122 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
123 All repositories are stored in a central location on the filesystem. This |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
124 location is specified during installation (via ``setup-db``) and can be reviewed |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
125 at *Admin > Settings > VCS > Location of repositories*. Repository groups |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
126 (defined in *Admin > Repository Groups*) are represented by a directory in that |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
127 repository location. Repositories of the repository group are nested under that |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
128 directory. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
129 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
130 To import a set of repositories and organize them in a certain repository group |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
131 structure, first place clones in the desired hierarchy at the configured |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
132 repository location. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
133 These clones should be created without working directory. For Mercurial, this is |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
134 done with ``hg clone -U``, for Git with ``git clone --bare``. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
135 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
136 When the repositories are added correctly on the filesystem: |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
137 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
138 * go to *Admin > Settings > Remap and Rescan* in the Kallithea web interface |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
139 * select the *Install Git hooks* checkbox when importing Git repositories |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
140 * click *Rescan Repositories* |
6789
4d04ac08fff7
docs: fix some sphinx warnings
Mads Kiilerich <mads@kiilerich.com>
parents:
6734
diff
changeset
|
141 |
6734
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
142 This step will scan the filesystem and create the appropriate repository groups |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
143 and repositories in Kallithea. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
144 |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
145 *Note*: Once repository groups have been created this way, manage their access |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
146 permissions through the Kallithea web interface. |
c5512c9d2118
docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents:
6554
diff
changeset
|
147 |
5433
fbbe80e3322b
docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents:
5417
diff
changeset
|
148 |
2023
c45fb78969a3
docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents:
1123
diff
changeset
|
149 .. _waitress: http://pypi.python.org/pypi/waitress |
3224
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2992
diff
changeset
|
150 .. _gunicorn: http://pypi.python.org/pypi/gunicorn |
4972
b52a1ccee927
docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4971
diff
changeset
|
151 .. _subrepositories: http://mercurial.aragost.com/kick-start/en/subrepositories/ |