Metadata-Version: 1.1
Name: django-minke
Version: 1.2.3.dev0
Summary: Django- and fabric-based building toolkit for remote-control- and configuration-management-systems.
Home-page: UNKNOWN
Author: Thomas Leichtfuß
Author-email: thomas.leichtfuss@posteo.de
License: BSD License
Description: ================
        Welcome to Minke
        ================
        
        .. image:: https://travis-ci.com/thomst/django-minke.svg?branch=master
           :target: https://travis-ci.com/thomst/django-minke
        
        .. image:: https://coveralls.io/repos/github/thomst/django-minke/badge.svg
           :target: https://coveralls.io/github/thomst/django-minke
        
        .. image:: https://img.shields.io/badge/python-3.4%20%7C%203.5%20%7C%203.6%20%7C%203.7%20%7C%203.8-blue
           :target: https://img.shields.io/badge/python-3.4%20%7C%203.5%20%7C%203.6%20%7C%203.7%20%7C%203.8-blue
           :alt: python: 3.4, 3.5, 3.6, 3.7, 3.8
        
        .. image:: https://img.shields.io/badge/django-1.11%20%7C%202.0%20%7C%202.1%20%7C%202.2-orange
           :target: https://img.shields.io/badge/django-1.11%20%7C%202.0%20%7C%202.1%20%7C%202.2-orange
           :alt: django: 1.11, 2.0, 2.1, 2.2
        
        Links
        =====
        * Minke on github: https://github.com/thomst/django-minke
        * Minke on Read the Docs: https://django-minke.readthedocs.io
        * Getting started: https://django-minke.readthedocs.io/en/latest/docs/gettingstarted.html
        
        A framework for remote-control- and configuration-management-systems
        ====================================================================
        Minke is a framework that combines the full power of djangos admin-interface
        with the reliability and configurability of fabric2. A pure open-source- and
        pure python-solution to realize the most different szenarios concerning remote-
        control and configuration-managment.
        
        Imagine you just need to setup some managment-commands for a handful of servers -
        you can do that with minke. Imagine you have lots of servers with different
        setups that you need to group and address seperatly - you can do that with
        minke. Imagine you have servers with multiple subsystems installed on each of them
        and you not just want to manage those systems but also to track configurations,
        version-numbers, installed extensions or modules and to filter for all of those
        values within your backend - you can do that with minke.
        
        Features
        --------
        * full integration with django's admin-site
        * parrallel session-execution through celery
        * realtime monitoring of executed remote-sessions
        * command-line-api using django's management-commands
        * session- and command-history
        
        Concept
        -------
        The main idea of minke is to define an arbitrary data-structure that represents
        your server- and subsystem-landscape as django-models. And then be able to
        run specific remote-tasks for those models right out of their changelist-sites.
        Now those tasks could be anything about remote-control and system-managment, but
        also fetching relevant data to update your django-data-structure itself.
        
        To make this possible there are three main elements:
        
        * hosts,
        * minke-models,
        * and sessions.
        
        Hosts
        .....
        A Host is a django-model that is basically the database-representation of a
        specific ssh-config. It holds every information needed by fabric to connect
        to the remote-system.
        
        Minke-Models
        ............
        Minke-models now are all those models that you want to run remote-sessions with.
        This could be the data-representation of a server, but also of web-applications
        running on this server, and even something like installed extensions, patches,
        backups and everything else you want to track and manage in your minke-app.
        
        Sessions
        ........
        A session-class defines the code to be executed for minke-models. Sessions are
        similar fabric-tasks. Within a session you have access to a connection-object
        (as implemented by fabric) as well as to the minke-model-object you are working
        with. So a session could be as simple as running a single shell-command on the
        remote-machine, up to complex management-routines including manipulating the
        data of the minke-model-object itself.
        
Platform: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Django
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Topic :: System :: Systems Administration
