community.docker.docker_stack – docker stack module¶
Note
This plugin is part of the community.docker collection (version 1.5.0).
To install it use: ansible-galaxy collection install community.docker
.
To use it in a playbook, specify: community.docker.docker_stack
.
Requirements¶
The below requirements are needed on the host that executes this module.
jsondiff
pyyaml
Parameters¶
Notes¶
Note
Return values out and err have been deprecated and will be removed in community.docker 2.0.0. Use stdout and stderr instead.
Examples¶
- name: Deploy stack from a compose file
community.docker.docker_stack:
state: present
name: mystack
compose:
- /opt/docker-compose.yml
- name: Deploy stack from base compose file and override the web service
community.docker.docker_stack:
state: present
name: mystack
compose:
- /opt/docker-compose.yml
- version: '3'
services:
web:
image: nginx:latest
environment:
ENVVAR: envvar
- name: Remove stack
community.docker.docker_stack:
name: mystack
state: absent
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Authors¶
Dario Zanzico (@dariko)