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.

  +--------------------------------------------------------------------------+
  | /etc/rsyncd.conf                                                         |
  +--------------------------------------------------------------------------+
  |                                                                          |
  | uid = rsync                                                              |
  | gid = rsync                                                              |
  | address = example.com                                                    |
  | max connections = 10                                                     |
  | use chroot = yes                                                         |
  |                                                                          |
  | [repo]                                                                   |
  |         path = /pub/share/repo                                           |
  |         comment = My Repository                                          |
  |                                                                          |
  +--------------------------------------------------------------------------+

Create a service file:

  +--------------------------------------------------------------------------+
  | /etc/sysmgr/rsync or /etc/sv/rsync/run                                   |
  +--------------------------------------------------------------------------+
  |                                                                          |
  | #!/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.