aptly

command module
v1.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 14, 2018 License: MIT Imports: 5 Imported by: 0

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/ <http://www.aptly.info/>`_. For support please use
mailing list `aptly-discuss <https://groups.google.com/forum/#!forum/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 <http://dl.bintray.com/smira/aptly/>`_.

If you have Go environment set up, you can build aptly from source by running (go 1.8+ 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 <CONTRIBUTING.md>`_.

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

Vagrant:

-   `Vagrant configuration <https://github.com/sepulworld/aptly-vagrant>`_ 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 <https://github.com/mikepurvis/aptly-docker>`_ with aptly inside by Mike Purvis
-    `Docker container <https://github.com/bryanhong/docker-aptly>`_ with aptly and nginx by Bryan Hong

With configuration management systems:

-   `Chef cookbook <https://github.com/hw-cookbooks/aptly>`_ by Aaron Baer
    (Heavy Water Operations, LLC)
-   `Puppet module <https://github.com/alphagov/puppet-aptly>`_ by
    Government Digital Services
-   `Puppet module <https://github.com/tubemogul/puppet-aptly>`_ by
    TubeMogul
-   `SaltStack Formula <https://github.com/saltstack-formulas/aptly-formula>`_ by
    Forrest Alvarez and Brian Jackson
-   `Ansible role <https://github.com/aioue/ansible-role-aptly>`_ by Tom Paine

CLI for aptly API:

-   `Ruby aptly CLI/library <https://github.com/sepulworld/aptly_cli>`_ by Zane Williamson
-   `Python aptly CLI (good for CI) <https://github.com/TimSusa/aptly_api_cli>`_ by Tim Susa

GUI for aptly API:

-   `Python aptly GUI (via pyqt5) <https://github.com/chnyda/python-aptly-gui>`_ by Cedric Hnyda

Scala sbt:

-   `sbt aptly plugin <https://github.com/amalakar/sbt-aptly>`_ by Arup Malakar

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
Package api provides implementation of aptly REST API
Package api provides implementation of aptly REST API
Package aptly provides common infrastructure that doesn't depend directly on Debian or CentOS
Package aptly provides common infrastructure that doesn't depend directly on Debian or CentOS
Package cmd implements console commands
Package cmd implements console commands
Package context provides single entry to all resources
Package context provides single entry to all resources
Package database provides KV database for meta-information
Package database provides KV database for meta-information
Package deb implements Debian-specific repository handling
Package deb implements Debian-specific repository handling
Package files handles operation on filesystem for both public pool and published files
Package files handles operation on filesystem for both public pool and published files
Package http provides all HTTP (and FTP)-related operations
Package http provides all HTTP (and FTP)-related operations
Package pgp provides interface to signature generation and validation
Package pgp provides interface to signature generation and validation
Package query implements query language for
Package query implements query language for
Package s3 handles publishing to Amazon S3
Package s3 handles publishing to Amazon S3
Package swift handles publishing to OpenStack Swift
Package swift handles publishing to OpenStack Swift
systemd
activation
Package activation implements primitives for systemd socket activation.
Package activation implements primitives for systemd socket activation.
Package utils collects various services: simple operations, compression, etc.
Package utils collects various services: simple operations, compression, etc.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL