# patrickj.docker_compose_app

Ansible collection providing a single reusable role for deploying and managing Docker Compose applications.

## Contents

- `patrickj.docker_compose_app.app` — the base role. See [`roles/app/README.md`](roles/app/README.md) for usage, variables, and examples.

## Installation

```bash
ansible-galaxy collection install git+https://git.jaroszew.ski/ansible/ansible-collection-docker-compose-app.git
```

Or as a dependency in another collection's `galaxy.yml`:

```yaml
dependencies:
  "patrickj.docker_compose_app": ">=1.0.0"
```

## Scaffolding a new consuming role

`create_app_role.sh` at the repo root scaffolds a new "shim" role that depends on `patrickj.docker_compose_app.app`. Run it from the `roles/` directory of your consuming collection or playbook:

```bash
cd path/to/your/collection/roles
/path/to/this/repo/create_app_role.sh my-app
```