https://github.com/Red5d/docker-autocompose

Generate a docker-compose yaml definition from a running container
https://github.com/Red5d/docker-autocompose

automation compose docker docker-compose

Last synced: 2 months ago
JSON representation

Generate a docker-compose yaml definition from a running container

• Host: GitHub
• URL: https://github.com/Red5d/docker-autocompose
• Owner: Red5d
• Created: 2016-01-02T22:15:37.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-04-05T02:22:46.000Z (9 months ago)
• Last Synced: 2024-06-30T01:00:31.888Z (7 months ago)
• Topics: automation, compose, docker, docker-compose
• Language: Python
• Size: 51.8 KB
• Stars: 1,758
• Watchers: 20
• Forks: 197
• Open Issues: 15
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• jimsghstars - Red5d/docker-autocompose - Generate a docker-compose yaml definition from a running container (Python)

README

        
# docker-autocompose

Generates a docker-compose yaml definition from a docker container.

Required Modules:

* [pyaml](https://pypi.python.org/project/pyaml/)

* [docker](https://pypi.python.org/project/docker)

* [six](https://pypi.python.org/project/six)

Example Usage:

    sudo python autocompose.py 

Generate a compose file for multiple containers together:

    sudo python autocompose.py apache-test mysql-test

The script defaults to outputting to compose file version 3, but use "-v 1" to output to version 1:

    sudo python autocompose.py -v 1 apache-test

Outputs a docker-compose compatible yaml structure:

[docker-compose reference](https://docs.docker.com/compose/)

[docker-compose yaml file specification](https://docs.docker.com/compose/compose-file/)

While experimenting with various docker containers from the Hub, I realized that I'd started several containers with complex options for volumes, ports, environment variables, etc. and there was no way I could remember all those commands without referencing the Hub page for each image if I needed to delete and re-create the container (for updates, or if something broke).

With this tool, I can easily generate docker-compose files for managing the containers that I've set up manually.

## Native installation

You can install it system-wide from the project directory with a command:

```python setup.py install --optimize=1```

There are unofficial packages available in the Arch User Repository:

* [Stable](https://aur.archlinux.org/packages/docker-autocompose)

* [Development (follows the master branch)](https://aur.archlinux.org/packages/docker-autocompose-git)

**AUR packages are provided by a third party and are not tested or updated by the maintainer(s) of the docker-autocompose project.**

## Docker Usage

You can use this tool from a docker container by either cloning this repo and building the image or using the [automatically generated image on GitHub](https://github.com/Red5d/docker-autocompose/pkgs/container/docker-autocompose)

Pull the image from GitHub (supports both x86 and ARM)

    docker pull ghcr.io/red5d/docker-autocompose:latest

Use the new image to generate a docker-compose file from a running container or a list of space-separated container names or ids:

    docker run --rm -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/red5d/docker-autocompose  ...

To print out all containers in a docker-compose format:

    docker run --rm -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/red5d/docker-autocompose $(docker ps -aq)

    

## Contributing

When making changes, please validate the output from the script by writing it to a file (docker-compose.yml or docker-compose.yaml) and running "docker-compose config" in the same folder with it to ensure that the resulting compose file will be accepted by docker-compose.