podman-compose/README.md
2019-03-11 11:51:28 +02:00

52 lines
1.5 KiB
Markdown

# PodMan-Compose
A script to run `docker-compose.yml` using [podman](https://podman.io/),
doing necessary mapping to make it work rootless.
## NOTE
it's still underdevelopment and does not work yet.
## 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.py -t 1podfw -f examples/awx/docker-compose.yml up
```
Or by reusing a container network and `--add-host`
```
$ ./podman-compose.py -t cntnet -f examples/awx/docker-compose.yml up
```
Or by using host network and localhost works as in
```
$ ./podman-compose.py -t hostnet -f examples/awx-hostnet-localhost/docker-compose.yml up
```
### in progress work
```
./podman-compose.py -t 1pod -f examples/awx/docker-compose.yml up
```