16.27. cdist-type__consul_template_template(7)¶
16.27.1. NAME¶
cdist-type__consul_template_template - Manage consul-template templates
16.27.2. DESCRIPTION¶
Generate and deploy template definitions for a consul-template. See https://github.com/hashicorp/consul-template#examples for documentation. Templates are written in the Go template format. Either the --source or the --source-file parameter must be given.
16.27.3. REQUIRED PARAMETERS¶
- destination
the destination where the generated file should go.
16.27.4. OPTIONAL PARAMETERS¶
- command
an optional command to run after rendering the template to its destination.
- source
path to the template source. Conflicts --source-file.
- source-file
path to a local file which is uploaded using the __file type and configured as the source. If source is '-' (dash), take what was written to stdin as the file content. Conflicts --source.
- state
if this template is 'present' or 'absent'. Defaults to 'present'.
- wait
The minimum(:maximum) time to wait before rendering a new template to disk and triggering a command, separated by a colon (:). If the optional maximum value is omitted, it is assumed to be 4x the required minimum value. This is a numeric time with a unit suffix ("5s"). There is no default value. The wait value for a template takes precedence over any globally-configured wait.
16.27.5. EXAMPLES¶
# configure template on the target
__consul_template_template nginx \
--source /etc/my-consul-templates/nginx.ctmpl \
--destination /etc/nginx/nginx.conf \
--command 'service nginx restart'
# upload a local file to the target and configure it
__consul_template_template nginx \
--wait '2s:6s' \
--source-file "$__manifest/files/nginx.ctmpl" \
--destination /etc/nginx/nginx.conf \
--command 'service nginx restart'
16.27.6. SEE ALSO¶
cdist-type__consul_template(7), cdist-type__consul_template_config(7)
16.27.7. AUTHORS¶
Steven Armstrong <steven-cdist--@--armstrong.cc>
16.27.8. COPYING¶
Copyright (C) 2015-2016 Steven Armstrong. 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.