Commit 87ebf516 authored by Maciej Delmanowski's avatar Maciej Delmanowski

Remove the 'lib/debops-tools/' directory

I don't think that anythin in the directory is used anymore within the
project, it can be safely removed, and is still preserved in the git
history if needed.
parent 8cd380ae
# Created by http://www.gitignore.io
*.py[oc]
*.egg-info
/build
/dist
/_venv
### vim ###
[._]*.s[a-w][a-z]
[._]s[a-w][a-z]
*.un~
Session.vim
.netrwhist
*~
### Emacs ###
# -*- mode: gitignore; -*-
*~
\#*\#
/.emacs.desktop
/.emacs.desktop.lock
*.elc
auto-save-list
tramp
.\#*
# Org-mode
.org-id-locations
*_archive
# flymake-mode
*_flymake.*
# eshell files
/eshell/history
/eshell/lastdir
# elpa packages
/elpa/
# reftex files
*.rel
# AUCTeX auto folder
/auto/
### SublimeText ###
# workspace files are user-specific
*.sublime-workspace
# project files should be checked into the repository, unless a significant
# proportion of contributors will probably not be using SublimeText
# *.sublime-project
#sftp configuration file
sftp-config.json
### Intellij ###
# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm
## Directory-based project format
.idea/
/*.iml
# if you remove the above rule, at least ignore user-specific stuff:
# .idea/workspace.xml
# .idea/tasks.xml
# .idea/dictionaries
# and these sensitive or high-churn files:
# .idea/dataSources.ids
# .idea/dataSources.xml
# .idea/sqlDataSources.xml
# .idea/dynamic.xml
# and, if using gradle::
# .idea/gradle.xml
# .idea/libraries
## File-based project format
*.ipr
*.iws
## Additional for IntelliJ
out/
# generated by mpeltonen/sbt-idea plugin
.idea_modules/
# generated by JIRA plugin
atlassian-ide-plugin.xml
# generated by Crashlytics plugin (for Android Studio and Intellij)
com_crashlytics_export_strings.xml
### TextMate ###
*.tmproj
*.tmproject
tmtags
### Eclipse ###
*.pydevproject
.metadata
.gradle
tmp/
*.tmp
*.bak
*.swp
*~.nib
local.properties
.settings/
.loadpath
# External tool builders
.externalToolBuilders/
# Locally stored "Eclipse launch configurations"
*.launch
# CDT-specific
.cproject
# PDT-specific
.buildpath
# sbteclipse plugin
.target
# TeXlipse plugin
.texlipse
## For quick testing.
## Generated by https://github.com/ypid/ypid-ansible-common/blob/master/bin/sphinx-debops-role-build
docs/Makefile
docs/_build/
docs/conf.py
docs/defaults.rst
docs/includes/global.rst
docs/_templates/page.html
docs/_templates/.gitkeep
docs/_static/custom.css
docs/_static/.gitkeep
---
sudo: required
language: 'python'
python: '2.7'
virtualenv:
system_site_packages: true
before_install:
- 'sudo apt-get -q update'
- 'sudo apt-get -yq install python-unittest2'
install: True
script:
- 'nosetests'
- 'git clone --depth 1 https://github.com/nickjj/rolespec'
- 'cd rolespec ; bin/rolespec -r https://github.com/debops/test-suite'
This diff is collapsed.
Contributing guidelines
=======================
.. contents:: Sections
:local:
Philosophy
----------
- Do one thing well
- Modularity and flexibility
- DebOps itself is just a name, it is the sum of its parts
Discussion
----------
Join us in `#debops <http://webchat.freenode.net/?channels=debops>`_ on Freenode
or post on the `debops <https://lists.debops.org/mailman/listinfo/>`_
mailing list.
Issue reporting
---------------
DebOps is officially hosted on Github at https://github.com/debops.
Scripts and documentation
~~~~~~~~~~~~~~~~~~~~~~~~~
Checkout the `debops/debops issue tracker <https://github.com/debops/debops/issues>`_.
Playbooks and roles
~~~~~~~~~~~~~~~~~~~
Checkout the `debops/debops-playbooks issue tracker <https://github.com/debops/debops-playbooks/issues>`_.
Tests
~~~~~
Checkout the `debops/test-suite issue tracker <https://github.com/debops/test-suite>`_.
Code submissions
----------------
We accept `pull requests <https://help.github.com/articles/using-pull-requests>`_
on everything. Here's a quick work flow:
Fork it
~~~~~~~
- Fork it into your Github account
- Clone your fork onto your workstation
- ``git clone git@github.com:YOURACCOUNT/the-repo.git``
- Add the official repo as your upstream
- ``git remote add upstream https://github.com/debops/the-repo``
Make your contribution
~~~~~~~~~~~~~~~~~~~~~~
::
git checkout -b somefeaturebranch
git add <the files you modified>
git push origin somefeaturebranch
Please try your best to make great commit messages. Have a read through
`better commits <http://web-design-weekly.com/2013/09/01/a-better-git-commit>`_
and research how to use ``git add -p``.
Submit your pull request through Github
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Select the branch on your repo, click the green PR button and submit it.
Update your fork
~~~~~~~~~~~~~~~~
You should do this before making any commits and after your PR has been accepted.
::
git checkout master
git fetch upstream
git rebase upstream/master
git push origin master
Code style
----------
Refer to the `DebOps Code Standards Policy <https://docs.debops.org/en/latest/debops-policy/docs/code-standards-policy.html>`_.
License agreement
-----------------
By contributing you agree that these contributions are your own
(or approved by your employer) and you grant a full, complete, irrevocable
copyright license to all users and developers of the project, present and
future, pursuant to the license of the project.
debops-tools - manage DebOps playbooks and roles
Copyright (C) 2013-2017 Maciej Delmanowski <drybjed@gmail.com>
Copyright (C) 2014 Nick Janetakis <nick.janetakis@gmail.com>
Copyright (C) 2014-2015 Hartmut Goebel <h.goebel@crazy-compilers.com>
Copyright (C) 2015-2017 Robin Schneider <ypid@riseup.net>
Copyright (C) 2013-2017 DebOps https://debops.org/
This repository is part of DebOps.
DebOps is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 3, as
published by the Free Software Foundation.
DebOps is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with DebOps. If not, see https://www.gnu.org/licenses/.
This diff is collapsed.
#
# This file is part of `debops`.
# Based on prior work from `gitflow`
# Copyright (c) 2010-2011 Vincent Driessen
# Copyright (c) 2012-2015 Hartmut Goebel
# Distributed under a BSD-like license.
#
.PHONY : all clean celan-files clean-all clean-tox
.PHONY : xunit-test test test-dist cover
.PHONY : dump-requirements install-requirements
.PHONY : dist
all: cover
clean: clean-files
clean-files:
find . -name '*.py[co]' -delete
rm -rf *.egg *.egg-info
rm -f nosetests.xml *.egg-lnk pip-log.txt
clean-all: clean-tox clean
rm -rf build dist .coverage
clean-tox:
rm -rf .tox
xunit-test:
nosetests --with-xunit
test:
nosetests --with-spec --spec-color
test-dist:
PIP_DOWNLOAD_CACHE=~/Projects/pkgrepo/pkgs
tox
cover:
nosetests --with-coverage3 --cover-package=gitflow --with-spec --spec-color
dump-requirements:
pip freeze -l > .requirements
install-requirements:
pip install -r .requirements
dist:
# ensure a clean build
rm -rf build
python setup.py sdist
python setup.py bdist
|debops_logo| `DebOps <https://debops.org>`_
============================================
|CII Best Practices|
**Your Debian-based data center in a box**
A collection of `Ansible <https://ansible.com/>`_ 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
<https://docs.debops.org/en/latest/debops/docs/installation.html>`_ for more
details.
Getting started
^^^^^^^^^^^^^^^
Here is a short intro how to use DebOps. Please have a look at the
`Getting Started Guide
<https://docs.debops.org/en/latest/debops-playbooks/docs/guides/getting-started.html>`_ 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 <https://github.com/debops/debops-playbooks>`_
- `Custom scripts <https://docs.debops.org/en/latest/debops-playbooks/docs/custom-features.html>`_
- DebOps guides and troubleshooting
- `Using linux containers <https://docs.debops.org/en/latest/debops-playbooks/docs/guides/linux-containers.html>`_
- `Creating a local APT server to use backports <https://docs.debops.org/en/latest/debops-playbooks/docs/guides/local-apt-repository.html>`_
- `Solving common problems <https://github.com/debops/debops-tools/wiki/Solutions-to-problems-you-may-encounter>`_
Do you want to contribute?
^^^^^^^^^^^^^^^^^^^^^^^^^^
Sounds great, check out the `contributing guide <https://docs.debops.org/en/latest/debops/docs/contributing.html>`_
for the details.
Authors
```````
**Maciej Delmanowski**
- Email: drybjed@gmail.com
- Twitter: `@drybjed <https://twitter.com/drybjed>`_
- Github: `drybjed <https://github.com/drybjed>`_
**Nick Janetakis**
- Email: nick.janetakis@gmail.com
- Twitter: `@nickjanetakis <https://twitter.com/nickjanetakis>`_
- Github: `nickjj <https://github.com/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 <https://github.com/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:
{% extends "README.md.j2" %}
{% block title %}
## [![DebOps](https://debops.org/images/debops-small.png)](https://debops.org) {{ role.name }}
{% endblock %}
{% block badges %}
{% if ansigenome_info.travis|d() %}
[![Travis CI](https://img.shields.io/travis/{{ scm.user + '/' + role.slug }}.svg?style=flat)](https://travis-ci.org/{{ scm.user + '/' + role.slug }})
[![test-suite](https://img.shields.io/badge/test--suite-{{ scm.repo_prefix | replace("-","--") | replace("_","__") + role.name | replace("-","--") | replace("_","__") }}-blue.svg?style=flat)](https://github.com/{{ scm.user }}/test-suite/tree/master/{{ scm.repo_prefix + role.name }}/)
{% endif %}
{% if ansigenome_info.galaxy_url|d() %}
[![Ansible Galaxy](https://img.shields.io/badge/galaxy-{{ role.galaxy_name | replace('-', '--')}}-660198.svg?style=flat)]({{ ansigenome_info.galaxy_url }})
{% endif %}
{%- endblock %}
{% block installation %}
### Installation
This role requires at least Ansible{% if galaxy_info.min_ansible_version is defined and galaxy_info.min_ansible_version %} `v{{ galaxy_info.min_ansible_version }}`{% endif %}. To install it, run:
```Shell
ansible-galaxy install {{ role.galaxy_name }}
```
### Documentation
More information about `{{ role.galaxy_name }}` can be found in the
[official {{ role.galaxy_name }} documentation](https://docs.debops.org/en/latest/ansible/roles/{{ role.slug }}/docs/).
### Contributing
Please note that this repository is not the upstream repository where changes should be contributed to.
Head over to https://github.com/debops/debops where you can find the contents of this repo and where changes are welcome.
{% endblock %}
{% block standalone %}
### Are you using this as a standalone role without DebOps?
You may need to include missing roles from the [DebOps common
playbook](https://github.com/debops/debops-playbooks/blob/master/playbooks/common.yml)
into your playbook.
[Try DebOps now](https://debops.org/) for a complete solution to run your Debian-based infrastructure.
{% endblock %}
{% block defaults %}
{% endblock %}
{% block facts %}
{% endblock %}
{% block usage %}
{% endblock %}
{% block footer %}
***
This role is part of [DebOps](https://debops.org/). README generated by [ansigenome](https://github.com/nickjj/ansigenome/).
{% endblock %}
{% extends "README.rst.j2" %}
{% block title %}
{%- set title_length = (role.name | length | int + 9) -%}
|DebOps| {{ role.name }}
{{ "#" * title_length }}
.. |DebOps| image:: https://debops.org/images/debops-small.png
:target: https://debops.org
{% endblock %}
{% block badges %}
{% if ansigenome_info.travis is defined and ansigenome_info.travis %}|Travis CI| |test-suite|{% endif %}{% if ansigenome_info.galaxy_id is defined and ansigenome_info.galaxy_id %} |Ansible Galaxy|{% endif %}
{% if ansigenome_info.travis is defined and ansigenome_info.travis %}
.. |Travis CI| image:: http://img.shields.io/travis/{{ scm.user + '/' + role.slug }}.svg?style=flat
:target: http://travis-ci.org/{{ scm.user + '/' + role.slug }}
.. |test-suite| image:: http://img.shields.io/badge/test--suite-{{ scm.repo_prefix | replace("-","--") | replace("_","__") + role.name | replace("-","--") | replace("_","__") }}-blue.svg?style=flat
:target: https://github.com/{{ scm.user }}/test-suite/tree/master/{{ scm.repo_prefix + role.name }}/
{% endif %}
{% if ansigenome_info.galaxy_id is defined and ansigenome_info.galaxy_id %}
.. |Ansible Galaxy| image:: http://img.shields.io/badge/galaxy-{{ role.galaxy_name }}-660198.svg?style=flat
:target: https://galaxy.ansible.com/detail#/role/{{ ansigenome_info.galaxy_id }}
{% endif %}
{% endblock %}
{% block installation %}
Installation
~~~~~~~~~~~~
{% if galaxy_info.min_ansible_version is defined and galaxy_info.min_ansible_version %}This role requires at least Ansible ``v{{ galaxy_info.min_ansible_version }}``. {% endif %}To install it, run:
::
ansible-galaxy install {{ role.galaxy_name }}
Are you using this as a standalone role without DebOps?
=======================================================
You may need to include missing roles from the `DebOps common playbook`_
into your playbook.
`Try DebOps now`_ for a complete solution to run your Debian-based infrastructure.
.. _DebOps common playbook: https://github.com/debops/debops-playbooks/blob/master/playbooks/common.yml
.. _Try DebOps now: https://github.com/debops/debops/
{% endblock %}
{% block authors %}
Authors and license
~~~~~~~~~~~~~~~~~~~
``{{ role.name }}`` role was written by:
{% for credit in authors %}
- {% if credit.url is defined and credit.url %}`{% endif %}{{ credit.name }}{% if credit.url is defined and credit.url %} <{{ credit.url }}>`_{% endif %}{% if credit.email is defined and credit.email %} | `e-mail <mailto:{{ credit.email }}>`_{% endif %}{% if credit.twitter is defined and credit.twitter %} | `Twitter <https://twitter.com/{{ credit.twitter }}>`_{% endif %}{% if credit.github is defined and credit.github %} | `GitHub <https://github.com/{{ credit.github }}>`_{% endif %}
{% endfor %}
License: `{{ license.type | trim }} <{{ license.url | trim }}>`_
{% endblock %}
{% block footer %}
****
This role is part of the `DebOps`_ project. README generated by `ansigenome`_.
.. _DebOps: https://debops.org/
.. _Ansigenome: https://github.com/nickjj/ansigenome/
{% endblock %}
{%- set author = authors | first -%}
{% block title %}
## {{ role.name }}
{% endblock %}
{% block ansigenome_managed %}
<!-- This file was generated by Ansigenome. Do not edit this file directly but
instead have a look at the files in the ./meta/ directory. -->
{% endblock %}
{% block badges %}
{% if ansigenome_info.travis|d() %}
[![Travis CI](http://img.shields.io/travis/{{ scm.user + '/' + role.slug }}.svg?style=flat)](http://travis-ci.org/{{ scm.user + '/' + role.slug }})
{% endif %}
{% if ansigenome_info.galaxy_url|d() %}
[![Ansible Galaxy](http://img.shields.io/badge/galaxy-{{ role.galaxy_name | replace('-', '--')}}-660198.svg?style=flat)]({{ ansigenome_info.galaxy_url }})
{% endif %}
{% if galaxy_info.platforms|d() %}
[![Platforms](http://img.shields.io/badge/platforms-{{ galaxy_info.platforms | map(attribute='name') | sort | join('%20/%20') | lower }}-lightgrey.svg?style=flat)](#)
{% endif %}
{%- endblock %}
{% if ansigenome_info.status|d() is mapping or ansigenome_info.beta|d() %}
{% block status %}
{# Consider using the `ansigenome_info.status` instead of `ansigenome_info.beta` #}
{% if ansigenome_info.status|d() and ansigenome_info.status.name|d('beta') == 'deprecated' %}
{% block deprecated %}
### Warning, this is a deprecated role
{% endblock %}
{% elif ansigenome_info.beta|d() or ansigenome_info.status.name|d('beta') == 'beta' %}
{% block beta %}
### Warning, this is a Beta role
This role has been marked by the author as a beta role, which means that it
might be significantly changed in the future. Be careful while using this role
in a production environment.
{% endblock %}
{% endif %}
{% if ansigenome_info.status|d() and ansigenome_info.status.note|d('') %}
{{ ansigenome_info.status.note }}
{% endif %}
***
{% endblock %}
{% endif %}
{% if ansigenome_info.synopsis|d() %}
{% block synopsis %}
{{ ansigenome_info.synopsis | trim }}
{% endblock %}
{% endif %}
{% if ansigenome_info.galaxy_url|d() %}
{% block installation %}
### Installation
This role requires at least Ansible{% if galaxy_info.min_ansible_version|d() %} `v{{ galaxy_info.min_ansible_version }}`{% endif %}. To install it, run:
```Shell
ansible-galaxy install {{ role.galaxy_name }}
```
{% endblock %}
{% endif %}
{% if dependencies|d() -%}
{% block dependencies %}
### Role dependencies
{% for role_dependency_name in dependencies | map(attribute='role') | unique %}
- `{{ role_dependency_name | trim }}`
{% endfor %}
{% endblock %}
{% endif %}
{% block standalone %}
{% endblock %}
{% if ansigenome_info.defaults|d() %}
{% block defaults %}
### Role variables
List of default variables available in the inventory:
```YAML
{{ ansigenome_info.defaults | trim }}
```
{% endblock %}
{% endif %}
{% if ansigenome_info.facts|d() %}
{% block facts %}
List of internal variables used by the role:
{{ ansigenome_info.facts | trim | indent(4, true) }}{% endblock %}{% endif %}
{% if ansigenome_info.usage|d() %}
{% block usage %}
### Detailed usage guide
{{ ansigenome_info.usage | trim }}
{% endblock %}
{% endif %}
{% if ansigenome_info.custom|d() %}
{{ ansigenome_info.custom | trim }}{% endif %}
{% block authors %}
### Authors and license
{% for credit in authors %}
- {{ "[" if credit.url|d() else "" }}{{ credit.name }}{{ "](" + credit.url + ")" if credit.url|d() else "" }}{{ " (maintainer)" if (credit.maintainer|d()) else "" }}{% if credit.email|d() %} | [e-mail](mailto:{{ credit.email }}){% endif %}{% if credit.twitter|d() %} | [Twitter](https://twitter.com/{{ credit.twitter }}){% endif %}{% if credit.github|d() %} | [GitHub](https://github.com/{{ credit.github }}){% endif %}
{% endfor %}
License: [{{ license.type | trim }}]({{ license.url | trim }})
{% endblock %}
{% block footer %}
***
README generated by [Ansigenome](https://github.com/nickjj/ansigenome/).
{% endblock %}
{%- set author = authors | first -%}
{%- set title_length = role.name | length -%}
{% block title %}
{{ role.name }}
{{ "=" * title_length }}
{% endblock %}
{% block badges %}
{% if ansigenome_info.travis is defined and ansigenome_info.travis %}|Travis CI|{% endif %}{% if ansigenome_info.galaxy_id is defined and ansigenome_info.galaxy_id %} |Ansible Galaxy|{% endif %}{% if galaxy_info.platforms is defined and galaxy_info.platforms %} |Platforms|{% endif %}
{% if ansigenome_info.travis is defined and ansigenome_info.travis %}