CHAKE-ITAMAE(7)

✨ chake-itamae(7) β€” the vibe ✨

okay bestie, so you know chake-itamae? it lives in the Miscellaneous Information Manual section, and it's a whole lil plugin for chake. basically it lets chake go configure your nodes using itamae. iconic. let's get into it πŸ’…


🌸 NAME 🌸

chake-itamae β€” configure chake nodes with itamae ✨


πŸ’– DESCRIPTION πŸ’–

so like, this configuration manager? it just runs itamae(1) against your nodes. that's the whole thing. no cap. it's giving "small but mighty" energy fr fr 🫢


πŸŽ€ CONFIGURATION πŸŽ€

okay so the itamae configuration manager needs exactly one key called itamae, and the value has to be a list of strings β€” that list is the recipes you want applied to the node when converging. literally that's it, no notes πŸ’€

host1.mycompany.com:
  itamae:
    - cookbooks/basic/default.rb
    - roles/server.rb
  service1:
    option1: "here we go"

now here's the cute part 🧚 β€” any extra configuration you shove under host1.mycompany.com gets saved into a JSON file and handed over to the itamae --node-json option on the command line. so for the config above, the JSON file it produces looks like this:

{
  "itamae": [
    "cookbooks/basic.rb",
    "roles/server.rb"
  ]
  ,
  "service1": {
    "option1": "here we go"
  }
}

(yes the comma is on its own line, that's just how it comes out, we don't question the comma βœ‹πŸ˜­)

and then inside your itamae recipes you can grab all those values with the node object. like so:

template "/etc/service1.conf.d/option1.conf" do
  variables option1: node["option1"]
end

see? node["option1"] and boom, your value's right there. slay πŸ”₯


πŸ¦‹ BOOTSTRAPPING πŸ¦‹

the tea on bootstrapping is that there is very little of it for this configuration manager. why? because itamae needs literally zero setup on the node side β€” the Ruby code in your recipes is interpreted locally, not on the nodes. main character behavior honestly πŸ‘‘

so during bootstrapping, the only thing that happens is the node hostname getting set according to your chake configuration. that's the entire to-do list. periodt πŸ’…


🌈 SEE ALSO 🌈

  • chake(1) β€” go read that one too bestie, iykyk

okay that's the whole page!! it's from the Miscellaneous Information Manual, and this lil cutie was dated August 2026 ✨ mwah, go configure something gorgeous, ily, bye πŸ’–πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from