Metadata-Version: 2.1
Name: ansible-compose
Version: 0.1.3.post2
Summary: The obscene docker-compose deploy with ansible cli
Home-page: https://yourlabs.io/oss/ansible-compose
Author: James Pic
Author-email: jamespic@gmail.com
License: UNKNOWN
Description: ansible-compose: deploy docker-compose over ssh
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        Deploying a docker-compose.yml
        ==============================
        
        Provide ssh configuration and target dir as first argument, then the path to a
        docker-compose.yml file::
        
           ansible-compose user@host:22/absolute/target/path ./docker-compose-example.yml
        
        Or, deploy from a url, just like kubectl apply would let you::
        
           ansible-compose user@host:22/absolute/target/path https://raw.git.../docker-compose.yml
        
        Automatic creation of volume dirs
        =================================
        
        It will try to automatically create the volume bind dirs for you. To set the
        uid and/or guid, set them as env vars, either in the compose.yml::
        
           environment:
             uid: 1001
             gid: 100
        
        Or on the command line
        
        Transforms for docker-compose.yml on the CLI
        ============================================
        
        You can also apply transforms to the docker-compose.yml on the command line
        with env vars: servicename_environment_something=foo will overwrite the
        something env var of the servicename service with the `foo` value, whereas
        setting drop_servicename_environment_something=1 will drop the value at all.
        
        This kind of filter will also work on service options ie. servicename_image=foo
        or drop_servicename_image=1 would respectively override and drop the image key
        of the servicename service. It also works on services themselves, and any other
        key at the first level of the compose document.
        
        Note that any other argument will be passed to ansible-playbook.
        
        Running commands on the compose of a target
        ===========================================
        
        Provide ssh configuration and target dir as first argument, then the
        docker-compose command::
        
           ansible-compose user@host:22/absolute/target/path stop
           ansible-compose user@host:22/absolute/target/path start
           ansible-compose user@host:22/absolute/target/path logs
           ansible-compose user@host:22/absolute/target/path help
        
        Installation
        ============
        
        ::
        
           pip install --user ansible-container
           export PATH="$HOME/.local/bin:$PATH"
           echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development
Classifier: Topic :: System
Description-Content-Type: text/x-rst
