Metadata-Version: 2.1
Name: podman-compose
Version: 0.1.3
Summary: A script to run docker-compose.yml using podman
Home-page: https://github.com/muayyad-alsadi/podman-compose
Author: Muayyad Alsadi
Author-email: alsadi@gmail.com
License: GPL-2.0-only
Description: # podman-compose
        
        A script to run `docker-compose.yml` using [podman](https://podman.io/),
        doing necessary mapping to make it work rootless.
        
        ## Installation
        
        Install latest stable version from PyPI:
        
        ```
        pip install podman-compose
        ```
        
        Or latest stable version from GitHub:
        
        ```
        pip install https://github.com/muayyad-alsadi/podman-compose/archive/master.tar.gz
        ```
        
        Or latest development version from GitHub:
        
        ```
        pip install https://github.com/muayyad-alsadi/podman-compose/archive/devel.tar.gz
        ```
        
        ## Mappings
        
        * `1podfw` - create all containers in one pod (inter-container communication is done via `localhost`), doing port mapping in that pod.
        * `1pod` - create all containers in one pod, doing port mapping in each container.
        * `identity` - no mapping.
        * `hostnet` - use host network, and inter-container communication is done via host gateway and published ports.
        * `cntnet` - create a container and use it via `--network container:name` (inter-container communication via `localhost`).
        * `publishall` - publish all ports to host (using `-P`) and communicate via gateway.
        
        ## Examples
        
        When testing the `AWX`, if you got errors just wait for db migrations to end. 
        
        ### Working Example
        
        *Tested on latest ``podman`` (commit `349e69..` on 2019-03-11).*
        
        By using many containers on a single pod that shares the network (services talk 
        via localhost):
        
        ```
        podman-compose -t 1podfw -f examples/awx3/docker-compose.yml up
        ```
        
        Or by reusing a container network and `--add-host`:
        
        ```
        podman-compose -t cntnet -f examples/awx3/docker-compose.yml up
        ```
        
        Or by using host network and localhost works as follows:
        
        ```
        podman-compose -t hostnet -f examples/awx3-hostnet-localhost/docker-compose.yml up
        ```
        
        ### Work in progress
        
        ```
        podman-compose -t 1pod -f examples/awx3/docker-compose.yml up
        ```
        
Keywords: podman,podman-compose
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Description-Content-Type: text/markdown
