Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skn0tt/ansible-role-docker-app
Ansible Role for Docker-App
https://github.com/skn0tt/ansible-role-docker-app
ansible ansible-role docker docker-app docker-compose
Last synced: 13 days ago
JSON representation
Ansible Role for Docker-App
- Host: GitHub
- URL: https://github.com/skn0tt/ansible-role-docker-app
- Owner: Skn0tt
- License: mit
- Created: 2018-07-26T17:59:48.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T05:59:04.000Z (11 months ago)
- Last Synced: 2024-10-06T04:03:12.155Z (about 1 month ago)
- Topics: ansible, ansible-role, docker, docker-app, docker-compose
- Language: Shell
- Size: 27.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
DockerApp
=========
A role for orchestrating Docker using [docker-app](https://github.com/docker/app).
Requirements
------------
- `docker`
- `pip`
Variables
--------------
This role exposes one variable, `dockerapp_images`, which specifies a list
of dockerapp images and their associated configuration. An image definition
comprises the `name` of the image, a `config` dictionary defining environment
variables, and an optional `state` field indicating whether the container should
be `up`, `down`, `start`, or `stop`, with the default state being `up`.
```yaml
dockerapp_images:
- name: skn0tt/ente.dockerapp
config:
REDIS_VERSION: 2.12.2
SYMMETRIC_SIGNING: true
```
The default value is
```yaml
dockerapp_images: []
```
Dependencies
------------
No other roles are required to use this role.
Installing This Role
--------------------
In order to install this role, you should create (or edit) a file called
`requirements.yml` in your Ansible root with contents like this:
```yaml
- src: skn0tt.docker_app
```
You can now run `ansible-galaxy install -r requirements.yml` to install the
role.
If you wish to use this role in a Tower job, add the `requirements.yml` file to
the `roles` directory in your project and Tower will download the roles when the
job runs.
Example Playbook
----------------
Assuming you have defined a host group called `servers`, you can use this role
on the hosts in that inventory as follows.
```yaml
- hosts: servers
roles:
- skn0tt.docker_app
```
License
-------
MIT
Author Information
------------------
Simon Knott [[email protected]](mailto:[email protected])
[simonknott.de](https://simonknott.de)
Contributors :tada:
------------
Jack Henahan [@jhenahan](https://github.com/jhenahan)