Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/lxdock/lxdock

Build and orchestrate your development environments with LXD - a.k.a. Vagrant is Too Heavy™
https://github.com/lxdock/lxdock

containers devops devops-tools linux lxc lxd lxdock orchestration python python3 vagrant

Last synced: about 1 month ago
JSON representation

Build and orchestrate your development environments with LXD - a.k.a. Vagrant is Too Heavy™

Awesome Lists containing this project

README 

        
LXDock

######



.. image:: https://readthedocs.org/projects/lxdock/badge/?style=flat-square&version=stable

   :target: https://lxdock.readthedocs.io/en/stable/

   :alt: Documentation



.. image:: https://img.shields.io/pypi/l/lxdock.svg?style=flat-square

   :target: https://pypi.python.org/pypi/lxdock/

   :alt: License



.. image:: https://img.shields.io/pypi/v/lxdock.svg?style=flat-square

   :target: https://pypi.python.org/pypi/lxdock/

   :alt: Latest Version



.. image:: https://img.shields.io/travis/lxdock/lxdock.svg?style=flat-square

    :target: https://travis-ci.org/lxdock/lxdock

    :alt: Build status



.. image:: https://img.shields.io/codecov/c/github/lxdock/lxdock.svg?style=flat-square

    :target: https://codecov.io/github/lxdock/lxdock

    :alt: Codecov status



|



LXDock is a wrapper around LXD_ that allows developers to orchestrate their development environments

using a workflow similar to Vagrant.



.. contents:: Table of Contents

    :local:



Status: New Maintainers

=======================



As of LXDock v0.4.1 the two creators of LXDock stopped using it, however the

project has several new maintainers now.



See: `issue #106 `_



The Travis CI tests are working again as we have switched to the Snap version of LXD since the

PPA is no longer maintained. This is great news as it has allowed a number of outstanding

PR's to be merged, with more to come.



There is also a Vagrantfile included for running the tests locally.



The next release will be v0.5.0, but no release date has been set at this point.



More to come...



Why use LXDock?

===============



**It's fast.** LXDock is much *much* faster than a typical Vagrant + Virtualbox setup.



**Multi-arch.** Vagrant has been designed with Virtualbox and x86 in mind. Even if you use

alternative providers, you're going to have to jump through inelegant hoops to have your

``Vagrantfile`` work on x86 and arm (for example) at the same time because the very concept of a

Vagrant box is arch-specific.



**Simpler.** When working with containers, much of the complexity of Vagrant becomes useless. Why

the need for special "vagrant-prepared" boxes when ``lxc exec`` is available? It's much simpler to

use whatever images are provided directly by lxd. By removing the need to manage boxes, ``lxdock``

suddenly becomes much simpler (a simple wrapper around lxd, really).



Documentation

=============



Online browsable documentation is available at https://lxdock.readthedocs.io.



Head over to the documentation for all the details on how to set up LXDock and how to start using

containers in your project!



Requirements

============



LXD_, Python 3.4+. Please refer to the requirements_ section of the documentation for a full list of

dependencies.



.. _LXD: https://www.ubuntu.com/cloud/lxd

.. _requirements: https://lxdock.readthedocs.io/en/stable/getting_started.html#requirements



Communication

=============



You can join the ``#lxdock`` channel on irc.freenode.net to get help and ask questions related to

the development of LXDock.



Current Maintainers

===================



Rob van der Linde (`@robvdl `_),

Norman Kabir (`@nkabir `_)



Original Authors

================



Virgil Dupras (`@hsoft `_), Morgan Aubert

(`@ellmetha `_) and contributors_.



.. _contributors: https://github.com/lxdock/lxdock/contributors



License

=======



GPLv3. See ``LICENSE`` for more details.