CDIST-TYPE__CON...WATCH_KEYPREFIX(7)

📦
version 7.0.0 · 8 versions
, in fedora 43, fedora 44

✨ cdist-type__consul_watch_keyprefix ✨

okay bestie, welcome to the cdist-type__consul_watch_keyprefix manual page, section 7 of the cdist manuals 🎀 this one is short, sweet, and honestly kind of iconic.

💖 NAME 💖

cdist-type__consul_watch_keyprefix — manages consul keyprefix watches 👑

🌸 DESCRIPTION 🌸

So basically this type generates and deploys watch definitions of type 'keyprefix' for a consul agent. that's it, that's the whole job, and it does it flawlessly 💅

and if you wanna know what all those parameters actually mean? go read the docs at http://www.consul.io/docs/agent/watches.html — that's where the parameter documentation lives, not here, i don't make the rules 🙈

🎀 REQUIRED PARAMETERS 🎀

like, you literally cannot skip these, fr fr.

  • handler — the handler to invoke when the data view updates. it's the thing that gets called when stuff changes, no handler no party 😭
  • prefix — the prefix of keys to watch for changes. this is the lil key-prefix you're stalking for updates 👀

🦋 OPTIONAL PARAMETERS 🦋

these ones are the ~vibes~ extras, take 'em or leave 'em.

  • datacenter — can be provided to override the agent's default datacenter 🌍
  • state — if this watch is 'present' or 'absent'. Defaults to 'present'. (so if you say nothing, it's showing up. manifesting ✨)
  • token — can be provided to override the agent's default ACL token 🔑

🌈 EXAMPLES 🌈

here's the moment you've been waiting for, the actual usage, copy-paste away bestie:

__consul_watch_keyprefix some-id \
   --prefix foo/ \
   --handler /usr/bin/my-prefix-handler.sh

ate. no notes. 💅

👑 SEE ALSO 👑

💜 AUTHORS 💜

Steven Armstrong <steven-cdist--@--armstrong.cc> — the main character who wrote this 🫶

🍓 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.

(so like, go forth and remix, just keep the license, periodt 📜✨)

ungleich GmbH 2021

and that's the whole page, bestie!! this was version 7.0.0, dated Jul 31, 2021 — thanks for reading, mwah 💖🧚

📦 where this page comes from