Metadata-Version: 1.1
Name: flyingcloud
Version: 0.3.27
Summary: Build Docker images using SaltStack
Home-page: https://github.com/cookbrite/flyingcloud
Author: MetaBrite, Inc.
Author-email: flyingcloud-admin@metabrite.com
License: Apache Software License 2.0
Description: ***********
        flyingcloud
        ***********
        
        ===================================
        Build Docker images using SaltStack
        ===================================
        
        This is a Python library and set of tools that lets you build `Docker <http://docker.com>`_ images using 
        masterless `SaltStack <http://saltstack.com/>`_ instead of (or in addition to) using Dockerfiles.
        
        FlyingCloud is easy to run from the commandline, and built to be run on
        a Continuous Integration server.
        
        
        ============================
        Why would I want to do that?
        ============================
        
        * Because you are installing a complex stack of software and have outgrown Docker's simple installation system.
        * Because you want to configure your Docker layers instead of writing shell scripts.
        * Because you want to install the same software stack on developer workstations and don't want to
          maintain two separate ways of installing a complex stack of software.
        
        
        ============
        How it works
        ============
        
        FlyingCloud runs `Salt <https://docs.saltstack.com/en/latest/>`_
        in `masterless mode <https://docs.saltstack.com/en/latest/topics/tutorials/quickstart.html>`_,
        applying `Salt states <https://docs.saltstack.com/en/latest/topics/tutorials/starting_states.html>`_
        for each Docker layer. Layers can also run custom Python code if necessary.
        
        Salt states can do many system administration tasks solely with configuration.
        `Here's a list of all the built-in Salt states <https://docs.saltstack.com/en/develop/ref/states/all/index.html>`_.
        And you can `write your own <https://docs.saltstack.com/en/latest/ref/states/writing.html>`_.
        
        
        ============
        Installation
        ============
        
        .. code-block:: bash
        
            $ pip install flyingcloud
        
        
        =======
        Example
        =======
        
        The `Flask Web App Example`_ shows how to create several reusable Docker images, built
        on each other, along with a small web application and an example of running tests inside
        the Docker container.
        
        .. _Flask Web App Example: https://github.com/cookbrite/flyingcloud/tree/master/examples/flask-web-app
        
        
        =============
        Documentation
        =============
        
        * `FlyingCloud <http://flyingcloud.readthedocs.io/en/latest/>`_
        
        
        ============
        Contributing
        ============
        
        
        We welcome contributions. This project is in an early stage and under heavy development. 
        To contribute, join the Google Group or file a pull request.
        
        * `FlyingCloud Google Group <https://groups.google.com/group/flyingcloud-users>`_
        
        
        =======
        License
        =======
        
        * `Apache License v2.0 <http://www.apache.org/licenses/LICENSE-2.0>`_
        
Keywords: docker saltstack devops automation
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Utilities
Classifier: Topic :: System :: Clustering
Classifier: Topic :: System :: Distributed Computing
