bluechi(1)

📦
version 1.3.0 · 2 versions
, in fedora 43, fedora 44

💖 bluechi(1) 💖

okay bestie, welcome to the bluechi(1) page from the General Commands Manual — yes we're doing man pages now, and honestly? iconic behavior.

✨ NAME ✨

bluechi-controller — the Controller of services across agents 👑

🌸 SYNOPSIS 🌸

bluechi-controller [options]

🦋 DESCRIPTION 🦋

Eclipse BlueChi™ is a systemd service controller built for multi-nodes environments — the kind where you've got a predefined number of nodes and everyone's very serious about it. It's aimed at highly regulated environments, like the ones that require functional safety (think: cars 🚗, fr fr).

So here's the tea: the bluechi controller puts its public API out there on the local DBus, and then it uses the DBus APIs that all the connected bluechi-agents hand over, to manage systemd services on those remote systems. Remote service management, no cap. 🫶

bluechi-controller [OPTIONS]

💅 OPTIONS 💅

--help, -h 🌈

Prints the usage statement and dips out. Simple. Clean. We love a graceful exit.

--port, -p 🔥

The port where bluechi-controller is listening and setting up its connections with bluechi-agents. Heads up bestie: this option overwrites the port that's defined in the configuration file. It's giving main character energy, it does not share the spotlight.

--config, -c 🎀

The path to the configuration file. See bluechi-controller.conf(5) for all the deets.

--version, -v ⭐

Prints the current bluechi version. Vibe check, but for software.

👑 Environment Variables 👑

bluechi-controller understands the following environment variables, and they can be used to override the settings from the configuration file (peep bluechi-controller.conf(5)). Yes, env vars said "not me overruling the config file 💀".

BC_LOG_LEVEL 🌸

The level used for logging. Supported values are:

  • DEBUG
  • INFO
  • WARN
  • ERROR

BC_LOG_TARGET 🧚

The target where logs are written to. Supported values are:

  • stderr
  • stderr-full
  • journald

BC_LOG_IS_QUIET 💜

If this flag is set to true, no logs are written by bluechi. Silence. Peace. Shhh. 🤫

💀 Exit Codes 💀

TBD

no literally, that's what it says. the exit codes are TBD. we know. we're all waiting. 🙈

🌈 CONFIGURATION FILES 🌈

bluechi-controller.conf(5)

⟨https://github.com/eclipse-bluechi/bluechi/blob/main/doc/man/bluechi-controller.conf.5.md⟩

and that's the whole page, bestie!! 🍓 every last flag, every last env var, preserved and slayed. this was bluechi(1) from the General Commands Manual — go forth and control those services across agents, periodt. 💖✨🎀🦋🌸💅🫶🔥👑🌈⭐💀🙈🍓🧚💜

📦 where this page comes from