Metadata-Version: 1.1
Name: ara
Version: 0.7.0
Summary: ARA - Ansible run analysis
Home-page: https://github.com/dmsimard/ara
Author: David Moreau Simard
Author-email: dms@redhat.com
License: UNKNOWN
Description: ARA: Ansible Run Analysis
        =========================
        tl;dr
        -----
        ARA_ is an attempt to make Ansible_ runs easier to visualize, understand and
        troubleshoot.
        
        ARA is three things:
        
        1. An `Ansible callback plugin`_ to record playbook runs into a local or remote database
        2. A `CLI client`_ to query the database
        3. A `web interface`_ to visualize the database
        
        .. _ARA: https://github.com/dmsimard/ara
        .. _Ansible: https://www.ansible.com/
        .. _Ansible callback plugin: https://ara.readthedocs.io/en/latest/configuration.html#ansible
        .. _CLI client: https://ara.readthedocs.io/en/latest/usage.html#querying-the-database-with-the-cli
        .. _web interface: https://ara.readthedocs.io/en/latest/usage.html#browsing-the-web-interface
        
        Overview
        --------
        ARA organizes recorded playbook data in a way to make it intuitive for you to
        search and find what you're interested for as fast and as easily as possible.
        
        It provides summaries of task results per host or per playbook.
        
        It allows you to filter task results by playbook, play, host, task or by the
        status of the task.
        
        With ARA, you're able to easily drill down from the summary view for the results
        you're interested in, whether it's a particular host or a specific task.
        
        Beyond browsing a single ansible-playbook run, ARA supports recording and
        viewing multiple runs in the same database.
        
        This allows you to, for example, recognize patterns (ex: this particular host
        is always failing this particular task) since you have access to data from
        multiple runs.
        
        Installing
        ==========
        Packaged dependencies
        ---------------------
        RHEL, CentOS, Fedora
        ~~~~~~~~~~~~~~~~~~~~
        ::
        
            yum -y install gcc python-devel libffi-devel openssl-devel
        
        Ubuntu, Debian
        ~~~~~~~~~~~~~~
        ::
        
            apt-get -y install gcc python-dev libffi-dev libssl-dev
        
        From source
        -----------
        ::
        
            git clone https://github.com/dmsimard/ara
            cd ara
            pip install .
        
        From pip
        --------
        ::
        
            pip install ara
        
        What does the web interface look like ?
        ---------------------------------------
        A video is available on YouTube_ and the following are screenshots of the
        web interface:
        
        .. image:: docs/images/preview1.png
        .. image:: docs/images/preview2.png
        
        .. _YouTube: https://www.youtube.com/watch?v=k3qtgSFzAHI
        
        Documentation
        -------------
        Documentation is available on `readthedocs.io`_.
        
        .. _readthedocs.io: https://ara.readthedocs.io/en/latest/
        
        Discussing ARA
        --------------
        We hang out in **#ara** on freenode IRC. Come chat with us !
        
        Author
        ======
        David Moreau Simard
        
        Contributors and special thanks
        ===============================
        See contributors on GitHub_.
        
        Special thanks to `Lars Kellogg-Stedman`_ for the early feedback on the
        project, ideas and code contributions.
        
        .. _GitHub: https://github.com/dmsimard/ara/graphs/contributors
        .. _Lars Kellogg-Stedman: http://blog.oddbit.com/
        
        Copyright
        =========
        Copyright 2016 Red Hat, Inc.
        
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
        
            http://www.apache.org/licenses/LICENSE-2.0
        
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
        
        
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Development Status :: 4 - Beta
