# Role `docker_compose` A role for deploying a Docker-Compose-based application. It deploys the given Compose file as well as configuration files to the specified hosts and makes sure all services are up-to-date and running. The Compose file gets deployed to `/ansible_docker_compose/compose.yaml` and the configuration files get deployed into the `/ansible_docker_compose/configs/` directory. A use case for the deployment of the additional configuration files is Composes top-level element `configs` in conjunction with the `configs` option for services. ## Supported Distributions The following distributions are supported: - Debian 11 ## Required Arguments For the required arguments look at the [`argument_specs.yaml`](./meta/argument_specs.yaml). ## `hosts` The `hosts` for this role need to be the machines, for which you want to make sure the given Compose file is deployed and all services of it are up-to-date and running. ## Links & Resources - <https://docs.docker.com/compose/> - <https://docs.docker.com/compose/compose-v2/> - <https://docs.docker.com/compose/production/> - <https://docs.docker.com/compose/startup-order/> - <https://docs.docker.com/compose/compose-file/> - <https://docs.docker.com/compose/compose-file/03-compose-file/> - <https://docs.docker.com/compose/compose-file/08-configs/> - <https://docs.docker.com/compose/compose-file/05-services/#configs> - <https://docs.docker.com/engine/reference/commandline/compose_up/> - <https://docs.docker.com/engine/reference/commandline/compose_ps/> - <https://docs.docker.com/engine/reference/commandline/compose_down/>