Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/smira/aptly-fork

aptly - Debian repository management tool (fork of aptly-dev/aptly)
https://github.com/smira/aptly-fork

Last synced: about 2 months ago
JSON representation

aptly - Debian repository management tool (fork of aptly-dev/aptly)

Lists

README

        

=====
aptly
=====

.. image:: https://api.travis-ci.org/aptly-dev/aptly.svg?branch=master
:target: https://travis-ci.org/aptly-dev/aptly

.. image:: https://codecov.io/gh/aptly-dev/aptly/branch/master/graph/badge.svg
:target: https://codecov.io/gh/aptly-dev/aptly

.. image:: https://badges.gitter.im/Join Chat.svg
:target: https://gitter.im/aptly-dev/aptly?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

.. image:: http://goreportcard.com/badge/aptly-dev/aptly
:target: http://goreportcard.com/report/aptly-dev/aptly

Aptly is a swiss army knife for Debian repository management.

.. image:: http://www.aptly.info/img/aptly_logo.png
:target: http://www.aptly.info/

Documentation is available at `http://www.aptly.info/ `_. For support please use
mailing list `aptly-discuss `_.

Aptly features: ("+" means planned features)

* make mirrors of remote Debian/Ubuntu repositories, limiting by components/architectures
* take snapshots of mirrors at any point in time, fixing state of repository at some moment of time
* publish snapshot as Debian repository, ready to be consumed by apt
* controlled update of one or more packages in snapshot from upstream mirror, tracking dependencies
* merge two or more snapshots into one
* filter repository by search query, pulling dependencies when required
* publish self-made packages as Debian repositories
* REST API for remote access
* mirror repositories "as-is" (without resigning with user's key) (+)
* support for yum repositories (+)

Current limitations:

* translations are not supported yet

Download
--------

To install aptly on Debian/Ubuntu, add new repository to ``/etc/apt/sources.list``::

deb http://repo.aptly.info/ squeeze main

And import key that is used to sign the release::

$ apt-key adv --keyserver pool.sks-keyservers.net --recv-keys ED75B5A4483DA07C

After that you can install aptly as any other software package::

$ apt-get update
$ apt-get install aptly

Don't worry about squeeze part in repo name: aptly package should work on Debian squeeze+,
Ubuntu 10.0+. Package contains aptly binary, man page and bash completion.

If you would like to use nightly builds (unstable), please use following repository::

deb http://repo.aptly.info/ nightly main

Binary executables (depends almost only on libc) are available for download from `Bintray `_.

If you have Go environment set up, you can build aptly from source by running (go 1.10+ required)::

mkdir -p $GOPATH/src/github.com/aptly-dev/aptly
git clone https://github.com/aptly-dev/aptly $GOPATH/src/github.com/aptly-dev/aptly
cd $GOPATH/src/github.com/aptly-dev/aptly
make install

Binary would be installed to ``$GOPATH/bin/aptly``.

Contributing
------------

Please follow detailed documentation in `CONTRIBUTING.md `_.

Integrations
------------

Vagrant:

- `Vagrant configuration `_ by
Zane Williamson, allowing to bring two virtual servers, one with aptly installed
and another one set up to install packages from repository published by aptly

Docker:

- `Docker container `_ with aptly inside by Mike Purvis
- `Docker container `_ with aptly and nginx by Artem Smirnov

With configuration management systems:

- `Chef cookbook `_ by Aaron Baer
(Heavy Water Operations, LLC)
- `Puppet module `_ by
Government Digital Services
- `Puppet module `_ by
TubeMogul
- `SaltStack Formula `_ by
Forrest Alvarez and Brian Jackson
- `Ansible role `_ by Tom Paine

CLI for aptly API:

- `Ruby aptly CLI/library `_ by Zane Williamson
- `Python aptly CLI (good for CI) `_ by Tim Susa

GUI for aptly API:

- `Python aptly GUI (via pyqt5) `_ by Cedric Hnyda

Scala sbt:

- `sbt aptly plugin `_ by Arup Malakar