Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/debops/debops-tools

Your Debian-based data center in a box
https://github.com/debops/debops-tools

Last synced: 5 days ago
JSON representation

Your Debian-based data center in a box

Awesome Lists containing this project

README

        

|debops_logo| `DebOps `_
============================================

|CII Best Practices|

**Your Debian-based data center in a box**

A collection of `Ansible `_ playbooks,
scalable from one container to an entire data center.

DebOps is a framework
^^^^^^^^^^^^^^^^^^^^^

- **117+ highly extensible roles** with sane defaults
- **Tuned for production** and works great for development
- **Built for modularity** so extending it is simple
- **Custom scripts** to tie everything together

We believe in the UNIX philosophy; one tool should only do one thing very well.
DebOps has many playbooks and roles but it is just a set of focused tools to
help you run and manage your infrastructure.

In fact all of the DebOps playbooks and roles can be ran with Ansible directly.

Installation
^^^^^^^^^^^^

Dependencies
````````````

DebOps requires a dependency that is not already installed by Ansible.
Install ``netaddr`` however you see fit:

::

$ pip install netaddr
$ apt-get install python-netaddr
$ yum install python-netaddr

DebOps scripts
``````````````

The easiest way to install DebOps is::

$ sudo pip install https://github.com/debops/debops-tools/archive/master.zip
$ debops-update

If you want to have more control on the installation process, you can
use::

$ git clone https://github.com/debops/debops-tools
$ sudo pip install ./debops-tools
$ debops-update

Please see the `Installation Guide
`_ for more
details.

Getting started
^^^^^^^^^^^^^^^

Here is a short intro how to use DebOps. Please have a look at the
`Getting Started Guide
`_ for more
detailed information.

**Make your first project**

::

$ debops-init ~/myproject

**Add a host to your inventory**

Take a peek at ``~/myproject/ansible/inventory/hosts``.

**Verify it**

::

$ ssh yourhost
$ debops-task all -m setup

**Run the DebOps playbooks**

::

$ debops

What do you want to learn more about?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

|Gratipay|_

- `Playbooks and roles `_
- `Custom scripts `_
- DebOps guides and troubleshooting
- `Using linux containers `_
- `Creating a local APT server to use backports `_
- `Solving common problems `_

Do you want to contribute?
^^^^^^^^^^^^^^^^^^^^^^^^^^

Sounds great, check out the `contributing guide `_
for the details.

Authors
```````

**Maciej Delmanowski**

- Email: [email protected]
- Twitter: `@drybjed `_
- Github: `drybjed `_

**Nick Janetakis**

- Email: [email protected]
- Twitter: `@nickjanetakis `_
- Github: `nickjj `_

**Hartmut Goebel**

- Email: [email protected]
- Website: http://www.crazy-compilers.com

**Robin `ypid` Schneider**

- Email: [email protected]
- Website: https://me.ypid.de/
- GitHub: `ypid `_

.. |Gratipay| image:: https://img.shields.io/gratipay/drybjed.svg?style=flat
.. _Gratipay: https://www.gratipay.com/drybjed/
.. |debops_logo| image:: https://debops.org/images/debops-small.png

.. |CII Best Practices| image:: https://bestpractices.coreinfrastructure.org/projects/237/badge
:target: https://bestpractices.coreinfrastructure.org/projects/237

..
Local Variables:
mode: rst
ispell-local-dictionary: "american"
End: