Scroll to navigation



aptly-publisher - tool for easy creation of Aptly multi component publishes


usage: aptly-publisher [-h] [-v] [-d] [--dry] [--timeout TIMEOUT] --url URL

[--recreate] [--no-recreate] [--force-overwrite]
[--publish-contents] [--acquire-by-hash] [--components COMPONENTS [COMPONENTS ...]] [--storage STORAGE] [-p PUBLISH [PUBLISH ...]] [-c CONFIG] [--dists DISTS [DISTS ...]] [--architectures ARCHITECTURES [ARCHITECTURES ...]] [--only-latest] [--source SOURCE] [--target TARGET] [--packages PACKAGES [PACKAGES ...]] [--diff] [--hard] [-r RESTORE_FILE] [-s SAVE_DIR] [-x PREFIX] action

positional arguments:

Action to perform (publish, promote, cleanup, restore, dump, purge)

optional arguments:

show this help message and exit


-v, --verbose

-d, --debug

--dry, --dry-run

Aptly client timeout. Raise for larger publishes and slow server.
URL to Aptly API, eg. http://localhost:8080
Drop publish and create it again, only way to add new components
Never recreate publish (even when we are adding new components where it's the only option)
Overwrite files in pool/ directory without notice
Publish contents. It's slow so disabled by default to support large repositories.
Use Acquire-by-hash option. This may help with repository consistency.
Space-separated list of components to promote or restore or to purge (in case of purge)
Storage backend to use for all publishes, can be empty (filesystem, default), swift:[name] or s3:[name]
Space-separated list of publish

Action 'publish':

Configuration YAML file
Space-separated list of distribution to work with (including prefix), default all.
List of architectures to publish (also determined by config, defaults to amd64, i386)
Publish only latest packages of every publishes

Action 'promote':

Source publish to take snapshots from. Can be regular expression, eg. jessie(/?.*)/nightly
Target publish to update. Must be format if source is regex, eg. jessie{0}/testing
Space-separated list of packages to promote
Show differences between publishes (snapshots to be updated)


Remove all unused packages and snapshots

Action 'restore':

File used to restore publish

Action 'dump':

Path of where dump of publish will be done
Prefix for dump files' names


The full documentation for aptly-publisher is maintained as a Texinfo manual. If the info and aptly-publisher programs are properly installed at your site, the command

info aptly-publisher

should give you access to the complete manual.

August 2019 aptly-publisher 0.12.10-2