NAME¶

repopush - safely rsync a package repository to another location

SYNOPSIS¶

repopush [-Nv] /path/to/local/repo remote

repopush [-Nv] [-f configfile] -s section

DESCRIPTION¶

The repopush tool is yet another program that helps with copying the various package files and repository metadata from one OS package repository to another, taking care to copy and remove files in such a way as to never have the remote repository present an inconsistent view. This is done by first copying the new package files, then copying the new metadata files, then removing the outdated metadata files, and only then removing the outdated package files.

The repopush tool supports APT and YUM repositories and figures out which one to handle by analyzing the contents of the local repository. This is one of the reasons why the latter must indeed be a directory on a locally-mounted filesystem.

The repopush tool accepts the following command-line options:

There are two ways to specify the local and remote parameters: directly on the command line or in a INI-style configuration file. If the -s option is specified, repopush will use the confget tool to read the configuration file (either the one specified by the -f option or a default one in the user's home directory), look for the specified section, and use the "local" and "remote" values from that section.

As noted above, the local parameter should be a path to a directory. The remote parameter can be in any format that the rsync tool accepts.

FILES¶

If the local and remote parameters are specified on the command line, the operation of the repopush tool is not affected by any files.

If a configuration section is specified via the -s option, repopush will look for a configuration file (either one specified via the -f option or a default one in the user's home directory) and treat it as an INI-style file containing one or more sections. See the documentation of the confget tool for more information about the supported format of the INI-style files.

EXAMPLES¶

Test-run a repository update:

Perform the actual update, a bit quieter:

The same, but with the "to-www-infra" section specified in the $HOME/.config/repopush.conf file:

To achieve the above result, the repopush.conf file should contain a section like this:

[to-www-infra]
local=/var/lib/repos/infra
remote=www:/var/www/repo/infra

HISTORY¶

The repopush tool was first written by Peter Pentchev in 2020. This manual page was created in 2021.

AUTHORS¶

Peter Pentchev <roam@ringlet.net>