30 lines
887 B
Markdown
30 lines
887 B
Markdown
# 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
|
|
```
|