extern/podman-compose
1
0
Fork 1
mirror of https://github.com/containers/podman-compose.git synced 2025-08-17 09:01:19 +02:00
Code Issues Packages Projects Releases Wiki Activity

Python packaging

Browse Source
This commit is contained in:
Artur Barseghyan
2019-08-21 22:45:53 +02:00
parent 35219c84b9
commit 6846b27585
8 changed files with 109 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
README.md
View File

@ -1,20 +1,38 @@
# PodMan-Compose
# podman-compose
A script to run `docker-compose.yml` using [podman](https://podman.io/),
doing necessary mapping to make it work rootless.
## NOTE
Note, that it's still under development and might not work well yet.
it's still underdevelopment and does not work yet.
## 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
* `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
@ -22,30 +40,29 @@ 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)
*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)
By using many containers on a single pod that shares the network (services talk
via localhost):
```
./podman-compose.py -t 1podfw -f examples/awx3/docker-compose.yml up
```
Or by reusing a container network and `--add-host`
Or by reusing a container network and `--add-host`:
```
$ ./podman-compose.py -t cntnet -f examples/awx3/docker-compose.yml up
```
Or by using host network and localhost works as in
Or by using host network and localhost works as follows:
```
$ ./podman-compose.py -t hostnet -f examples/awx3-hostnet-localhost/docker-compose.yml up
```
### in progress work
### Work in progress
```
./podman-compose.py -t 1pod -f examples/awx3/docker-compose.yml up
```