aboutsummaryrefslogtreecommitdiff
path: root/doc/rsync-repositories.txt
blob: 999824db918d74a95d048b3418159531e77830c2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
RSYNC REPOSITORIES
=================================================================================

RSYNC repositories are simple to serve and simple to use. In the repository
directory, there needs to be a '.rsync' file that points to the remote of the
repository. This is used in order to fetch changes from the upstream. '.rsync'
file looks like this for the core repository:

    rsync://carbslinux.org/repo/core


RSYNC repositories have some few distinctions when it comes to fetching them.
Unlike GIT repositories, they don't have a defined "root" directory. When there
are multiple repositories in a shared repository (such as the Carbs Linux and
KISS Linux repositories), individual repositories need to have this '.rsync'
file. This doesn't, however, slow down operations. Fetching from rsync
repositories are still considerably faster and smaller.


Setting up an rsync repository
---------------------------------------------------------------------------------

Carbs Linux repositories automatically sync from the git repostitories and serve
it through the rsync daemon. Here is a sample shell script that I use in order to
sync repositories. Feel free to customize for your own use.

    #!/bin/sh
    HOSTNAME=rsync://carbslinux.org/repo
    GITDIR=/pub/git/repo
    SHAREDIR=/pub/share/repo

    git -C "$GITDIR" pull
    rsync -aC --delete --include=core --exclude=.rsync \
        "$GITDIR/" "$SHAREDIR"

    for dir in "$SHAREDIR/"*; do
        [ -d "$dir" ] || continue
        [ -f "$dir/.rsync" ] ||
            printf '%s/%s\n' "$HOSTNAME" "${dir##*/}" > "$dir/.rsync"
    done


You can then create an 'rsync' user for serving the repositories.

    $ adduser -SD rsync


Create '/etc/rsyncd.conf' and a service configuration as well.

rsyncd.conf:

    uid = rsync
    gid = rsync
    address = example.com
    max connections = 10
    use chroot = yes

    [repo]
            path = /pub/share/repo
            comment = My Repository


/etc/sysmgr/rsync or what have you:

    #!/bin/sh
    exec rsync --daemon --no-detach


Switching to an rsync repository
---------------------------------------------------------------------------------

It is considerably easy to switch to the Carbs Linux rsync repository.

    $ mkdir -p /path/to/repo
    $ rsync -az rsync://carbslinux.org/repo/ /path/to/repo

This will fetch the repository to the given location, you can then add it to your
$KISS_PATH.