Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
172 lines (131 sloc) 4.3 KB
../lib/images/debops.png

DebOps

Your Debian-based data center in a box

Travis CI GitLab CI CII Best Practices

The DebOps project is a set of Free and Open Source tools that let users bootstrap and manage an IT infrastructure based on Debian_ or Ubuntu_ operating systems. Ansible_ is used as the main configuration management platform. DebOps provides a :ref:`collection of Ansible roles <role_index>` that manage various services, as well as a set of Ansible playbooks that tie them together in a highly integrated environment.

Ansible roles and playbooks provided by DebOps can be used to manage a single host, a set of Debian or Ubuntu hosts, or an entire data center. The hosts in question can be physical or virtual machines, or even LXC/Docker containers.

Some of the applications and services supported in DebOps are:

You can :ref:`try out DebOps <quick_start>` without installing it on your computer, using Docker or Vagrant. Alternatively, a set of scripts can be installed on your own computer, that will let you manage multiple, separate IT infrastructue environments.

Note

The DebOps documentation is currently being reorganized, some of the sections might be empty or misleading. Ansible role documentation is current for the roles in the DebOps monorepo, the old project documentation is available at the end of the Table of Contents.

.. toctree::
   :caption: Introduction
   :maxdepth: 1
   :hidden:

   overview
   introduction/quick-start
   introduction/faq
   introduction/community
   introduction/philosophy
   introduction/timeline
   introduction/other-projects
   introduction/references

.. toctree::
   :caption: News
   :maxdepth: 1
   :hidden:

   news/releases
   news/changelog
   news/upgrades

.. toctree::
   :caption: User Guide
   :maxdepth: 2
   :hidden:

   user-guide/install
   user-guide/debops-for-ansible
   user-guide/project-directories
   user-guide/site-playbook
   user-guide/debops-cli
   user-guide/debops-config
   user-guide/bugs

.. toctree::
   :caption: Admin Guide
   :maxdepth: 2
   :hidden:

   admin-guide/bootstrap.rst
   admin-guide/common-config.rst
   admin-guide/dev-network.rst
   admin-guide/basic-virtualization.rst
   admin-guide/basic-mailserver.rst

.. toctree::
   :caption: Developer Guide
   :maxdepth: 2
   :hidden:

   dep/index
   developer-guide/development-model
   developer-guide/monorepo-layout
   developer-guide/code-standards
   developer-guide/software-sources
   developer-guide/debops-roadmap

.. toctree::
   :caption: Tester Guide
   :maxdepth: 2
   :hidden:

   tester-guide/test-methodology
   tester-guide/travis-ci
   tester-guide/gitlab-ci
   tester-guide/vagrant
   tester-guide/jane
   tester-guide/testinfra

.. toctree::
   :caption: Ansible Roles
   :hidden:

   ansible/role-index
   ansible/roles/index

.. toctree::
   :caption: DebOps API
   :maxdepth: 2
   :hidden:

   debops-api/index

.. toctree::
   :caption: Old documentation
   :maxdepth: 2
   :glob:
   :hidden:

   debops-tools/index
   debops-playbooks/index
   debops-policy/index
   philosophy