bzr branch
http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
|
1910.19.4
by Andrew Bennetts
Add a doc on "Running a Bazaar Server" (Robert Collins, Andrew Bennetts) |
1 |
======================= |
2 |
Running a Bazaar Server |
|
3 |
======================= |
|
4 |
||
5 |
Bazaar does not require a specialised server because it operates over HTTP, FTP |
|
6 |
or SFTP. There is an optional smart server that can be invoked over SSH, from |
|
7 |
inetd, or in a dedicated mode. |
|
8 |
||
9 |
Dumb servers |
|
10 |
============ |
|
11 |
||
12 |
We describe HTTP, FTP, SFTP and HTTP-WebDAV as "dumb" servers because they do |
|
13 |
not offer any assistance to Bazaar. If you make a Bazaar repository available |
|
14 |
over any of these protocols, Bazaar will allow you to read it remotely. Just |
|
15 |
enter the URL to the branch in the Bazaar command you are running.:: |
|
16 |
||
17 |
bzr log http://bazaar-vcs.org/bzr/bzr.dev |
|
18 |
||
19 |
Bazaar supports writing over FTP, SFTP and via a plugin over HTTP-WebDAV. |
|
20 |
||
21 |
High performance server |
|
22 |
======================= |
|
23 |
||
24 |
**In development** |
|
25 |
||
26 |
The high performance server is currently in development. The version of Bazaar |
|
27 |
that accompanies this documentation is able to use the servers underlying |
|
28 |
protocol as a dumb server. This is the first stage high performance server |
|
29 |
functionality to be delivered. |
|
30 |
||
31 |
The current high performance server **always** provides **read/write** access. |
|
32 |
It is not suitable for publishing of read-only mirrors. |
|
33 |
||
34 |
It can be configured to run in three different ways: |
|
35 |
||
36 |
SSH |
|
37 |
--- |
|
38 |
||
39 |
Using Bazaar over SSH requires no special configuration on the server:: |
|
40 |
||
|
2018.1.1
by Andrew Bennetts
Make bzr+ssh:// actually work (at least with absolute paths). |
41 |
BZR_REMOTE_PATH=~/bin/bzr bzr log bzr+ssh://host/~/path/to/branch |
|
1910.19.4
by Andrew Bennetts
Add a doc on "Running a Bazaar Server" (Robert Collins, Andrew Bennetts) |
42 |
|
43 |
inetd |
|
44 |
----- |
|
45 |
||
46 |
This example shows how to run `bzr` with a dedicated user `bzruser` for a shared |
|
47 |
repository in `/srv/bzr/repo` which has a branch at `/srv/bzr/repo/branchname` |
|
48 |
||
49 |
Running a Bazaar server from inetd requires an inetd.conf entry:: |
|
50 |
||
51 |
1234 stream tcp nowait bzruser /usr/bin/bzr serve --inet --directory=/srv/bzr/repo |
|
52 |
||
53 |
When running client commands, the URL you supply is a `bzr://` URL relative to |
|
54 |
the `--directory` option given in inetd.conf:: |
|
55 |
||
56 |
bzr log bzr://host:1234/branchname |
|
57 |
||
58 |
Dedicated |
|
59 |
--------- |
|
60 |
||
61 |
This mode has the same path and URL behaviour as the inetd mode. To run as a |
|
62 |
specific, you should use `su` or login as that user. This example runs bzr |
|
63 |
serve on `localhost` port `1234`. |
|
64 |
||
65 |
server:: |
|
66 |
||
67 |
bzr serve --port=localhost:1234 --directory=/srv/bzr/repo |
|
68 |
||
69 |
client:: |
|
70 |
||
71 |
bzr log bzr://host:1234/branchname |
|
72 |