modcloth.confd

This role installs and configures confd (and allows adding of confd resources/templates).

It:

• Installs confd
• Optionally creates confd resources and templates
• Installs a cron task to run confd

See https://github.com/kelseyhightower/confd for description of confd.

Requirements

None

Role Variables

See defaults/main.yml for defaults.

confd_version: # version of confd to download
confd_download_url: # url to download confd from
confd_binary_path: # where to put the confd binary
confd_config_directory: # where to store confd configuration
confd_backend: # which confd backend to use
confd_backend_nodes: # list of confd backend nodes
confd_interval: # interval on which to run confd (seconds)

confd_service_template: # template to use as upstart job
confd_service_name: # name to name the service

# list of confd resources
# these are used to generate confd resource.toml's and templates to use during configuration generation
confd_resources: []
# each resource is a hash with the following keys:
# service_name (required): name of the service which uses the confd generated configuration (should have no spaces)
# template (required): name of the local template to copy up (using copy module)
# name (required): name of resource (used in filename generation)
# src (required): name of the template on the remote system
# dest (required): where to write the template after processing
# check_cmd (optional): the command to run to check if the generated file is valid. %s will be replaced with {{.src}} to get around Jinja templating
# reload_cmd (optional): the command to run to have the service reload the configuration
# owner (optional): user who should own the generated file
# group (optional): group who should own the generated file
# mode (optional): the file mode of the generated file
# confd_keys (optional): list of keys for confd to check

Dependencies

None

Example Playbook

- hosts: all
  roles:
  - role: modcloth.confd
    confd_resources:
    - service_name: foo
      template: "files/foo.tmpl"
      template_output: /etc/defaults/foo
      confd_keys:
      - /myapp

License

MIT

Author Information

ModCloth, Inc.