DebOps

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?

• 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: drybjed@gmail.com
• Twitter: @drybjed
• Github: drybjed

Nick Janetakis

• Email: nick.janetakis@gmail.com
• Twitter: @nickjanetakis
• Github: nickjj

Hartmut Goebel

• Email: h.goebel@crazy-compilers.com
• Website: http://www.crazy-compilers.com

Robin `ypid` Schneider

• Email: ypid@riseup.net
• Website: https://me.ypid.de/
• GitHub: ypid