ansible-consul-template's Introduction

Consul-Template

Installs consul-template as either an Upstart or SystemD service.

Role Variables

---
# defaults file for consul-template
consul_template_version: "0.12.0"
consul_template_release: "consul-template_{{ consul_template_version }}_linux_amd64"
consul_template_archive_file: "{{ consul_template_release }}.zip"
consul_template_download_url: "https://releases.hashicorp.com/consul-template/{{ consul_template_version }}/{{ consul_template_archive_file }}"
consul_template_binary: consul-template
consul_template_home: /opt/consul-template
consul_template_config_file_template: consul-template.cfg.j2
consul_template_config_file: consul-template.cfg
consul_template_log_file: /var/log/consul-template
consul_template_log_level: "INFO"
consul_template_consul_server: "127.0.0.1"
consul_template_use_systemd: false
consul_template_use_upstart: false
consul_template_template_files: # Copies your templates
    - {src: "template.ctmpl"}
consul_template_templates: # Defines templates in configuration
    - {name: "template.ctmpl", dest: "/path/on/disk/where/template/will/render", cmd: "optional command to run when the template is updated", perms: 0600, backup: true}

Example Playbook Role Usage

Simple setup

Install and run consul-template using Upstart with a barebones config file that contains no template configuration.

roles:
    - { role: consul-template,
        consul_template_use_upstart: true }

Use your own config file

Provide your own configuration file for consul-template.

roles:
    - { role: consul-template,
        consul_template_config_file_template: "{{ playbook_dir }}/files/consul-template.cfg.j2"
        consul_template_use_upstart: true }