.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__DOCKER_STACK" "7" "Feb 16, 2019" "4.10.6" "cdist"
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH NAME
.sp
cdist\-type__docker_stack \- Manage Docker stacks
.SH DESCRIPTION
.sp
This type manages service stacks.
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
Since there is no easy way to tell whether a stack needs to be updated,
\fIdocker stack deploy\fP is being run every time this type is invoked.
However, it does not mean this type is not idempotent. If Docker does not
detect changes, the existing stack will not be updated.
.UNINDENT
.UNINDENT
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B compose\-file
Path to the compose file. If it is \(aq\-\(aq (dash), read standard input.
.TP
.B state
\(aqpresent\(aq or \(aqabsent\(aq, defaults to \(aqpresent\(aq where:
.INDENT 7.0
.TP
.B present
the stack is deployed
.TP
.B absent
the stack is removed
.UNINDENT
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# Deploys \(aqfoo\(aq stack defined in \(aqdocker\-compose.yml\(aq compose file
__docker_stack foo \-\-compose\-file docker\-compose.yml
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHORS
.sp
Ľubomír Kučera <lubomir.kucera.jr at gmail.com>
.SH COPYING
.sp
Copyright (C) 2018 Ľubomír Kučera. You can redistribute it
and/or modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
.\" Generated by docutils manpage writer.
.