CDIST-TYPE__CONSUL(7)

💖 cdist-type__consul — it's giving "install consul" ✨

okay bestie, welcome to cdist-type__consul from the cdist manual, section 7 🎀. this one's short, sweet, and honestly kinda iconic. let's get into it 🦋

---

🌸 NAME 🌸

cdist-type__consul — install consul. that's it. that's the whole vibe. 💅

---

✨ DESCRIPTION ✨

so what it does is: it downloads and installs the consul binary from

https://dl.bintray.com/mitchellh/consul

and here's the little detail that matters, no cap: the consul binary gets downloaded on the server — like, the machine that's running cdist — and then it gets deployed over to the target host using the __file type. that's the default flow 🫶.

unless you pass the --direct parameter. then it's a whole different route, bestie. 🚀

---

🌈 REQUIRED PARAMETERS 🌈

None. zero. nada. she needs nothing from you. lowkey the dream 😌💖

---

🎀 OPTIONAL PARAMETERS 🎀

• state — either 'present' or 'absent'. defaults to 'present'. so if you say nothing, she's showing up 🌟
• version — which version of consul to install. check out ./files/versions for a list of the supported versions, iykyk. defaults to the latest known version. 👑

---

💜 BOOLEAN PARAMETERS 💜

• direct — download and deploy the consul binary directly on the target machine. skipping the whole server-detour situation. periodt. 🔥

---

💌 MESSAGES 💌

so depending on how the binary gets made, you get different messages, and honestly? relatable, different paths different energy.

if the consul binary is created using __staged_file, then the underlaying __file type messages are emitted. 📬

if the consul binary is created by the direct method, then this one gets emitted:

• /usr/local/bin/consul created — consul binary was created. slay. 💅✨

---

🍓 EXAMPLES 🍓

here's the good stuff. copy these exactly, bestie, don't freestyle the flags 🙈

# just install using defaults
__consul

# install by downloading consul binary directly on the target machine
__consul --direct

# specific version
__consul \
   --version 0.4.1

---

👑 AUTHORS 👑

the legends behind this one:

• Steven Armstrong <steven-cdist--@--armstrong.cc>
• Darko Poljak <darko.poljak--@--gmail.com>

---

🦋 COPYING 🦋

Copyright (C) 2015 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. 📜✨

---

🌟 COPYRIGHT 🌟

ungleich GmbH 2021. okay periodt, legal girlies ate that one. 💖

---

and that's the whole page, bestie 🫶 this was cdist-type__consul(7), version 7.0.0, dated Jul 31, 2022 — mwah, love that for us, bye! 💅🎀🌸