Consul

===================

This role installs Consul as either a server or a client on AWS.

Requirements

---

None.

Role Variables

---

Default Variables

Most users can use the default settings provided, but these can be changed if needed:

• consul_group: Default group name (consul)
• consul_gid: Default GID (10010)
• consul_user: Default username (consul)
• consul_uid: Default UID (10010)
• consul_version: Default version of Consul (1.2.2)
• consul_start: Start service by default (True)

Playbook Variables

In your playbook, you should define the following variables:

• consul_role: Set to "client" or "server"
• consul_datacenter: Name for the cluster
• consul_encryptkey: Key generated by Consul keygen
• consul_cert: SSL Certificate for the cluster
• consul_key: SSL Key for the cluster
• ca_cert: Intermediate SSL Certificate for the cluster

Dependencies

---

This role is designed to work in AWS, using the AWS provider for the retry_join configuration parameter:

"retry_join": ["provider=aws tag_key=role tag_value=consul"]

If you want to use it outside of AWS, you'll need to change the retry_join setting to use a different method.

Example Playbook

---

You need to set the required variables in your playbook and call the role like this:

- name: Converge
  hosts: all
  vars:
    consul_role: server
    consul_datacenter: "us-east-1"
    consul_encryptkey: "YKbtX0Gc3mnJ7QwaNwNYtg=="
    consul_cert: |
      -----BEGIN CERTIFICATE-----
      (Your SSL Certificate here)
      -----END CERTIFICATE-----
    consul_key: |
      -----BEGIN PRIVATE KEY-----
      (Your SSL Key here)
      -----END PRIVATE KEY-----
    ca_cert: |
      -----BEGIN CERTIFICATE-----
      (Your CA Certificate here)
      -----END CERTIFICATE-----
  roles:
    - role: austincloudguru.consul

License

---

MIT

Author Information

---

Mark Honomichl aka AustinCloudGuru
Created in 2018