DISNIX-DELEGATE(1)

📦 version 0.10.2, in nixos 26.05, nixpkgs unstable

💅 DISNIX-DELEGATE(1) 💅

okay so bestie, welcome to disnix-delegate — a User Command and honestly kind of a backstage icon. she doesn't want the spotlight, she just makes everybody else's builds happen on the right machines. let's get into it 🎀

✨ NAME ✨

disnix-delegate — delegates service builds to the target machines. that's the whole vibe. no cap.

🦋 SYNOPSIS 🦋

disnix-delegate -s services_nix -i infrastructure_nix -d distribution_nix [OPTION]
disnix-delegate -A architecture_nix [OPTION]

two whole ways in, pick your fighter 💖

🌸 DESCRIPTION 🌸

so the command disnix-delegate is literally there to instantiate all derivations of the services on the deployed machines in the network, and then hand off (delegate! see what they did there) their build operations to the target machines. she's a delegator. it's giving manager energy but like, the helpful kind. 👑

this command needs three Nix expressions as input parameters — and yes, all three, no skipping:

  • a services model capturing the components of a distributed system and its inter-dependencies 🔗
  • an infrastructure model capturing the machines in the network and its properties 🖥️
  • a distribution model which maps services to machines 🗺️
💀 real talk though: most users don't need to use this command directly. the disnix-env command will automatically invoke this command to activate the new configuration. so unless you're doing something specific, she's already being called for you, bestie. main character energy behind the scenes fr fr.

💅 OPTIONS 💅

  • -s, --services=services_nix — the Services Nix expression which describes all components of the distributed system ✨
  • -i, --infrastructure=infrastructure_nix — the Infrastructure Nix expression which captures properties of machines in the network 🖥️
  • -d, --distribution=distribution_nix — the Distribution Nix expression which maps services to machines in the network 🗺️
  • -P, --packages=packages_nix — a Packages Nix expression specifying the packages that should be deployed in a Nix profile mapped to each machine in the network 📦
  • -A, --architecture=architecture_nix — the Deployment architecture Nix expression that captures all properties of the services and infrastructure, including the distribution of services to targets 🏛️ (this is the one-expression-to-rule-them-all path from the second synopsis line, iykyk)
  • -B, --build=build_nix — a Build Nix expression that maps store derivations to target machines in the network 🔨
  • --extra-params=PARAMS — a string with an attribute set in the Nix expression language, propagating extra parameters to input models 🎁
  • --target-property=PROP — the target property of an infrastructure model, that specifies how to connect to the remote Disnix interface. defaults to hostname 🏷️
  • --interface=INTERFACE — path to executable that communicates with a Disnix interface. defaults to: disnix-ssh-client 🔌
  • -m, --max-concurrent-transfers=NUM — maximum amount of concurrent closure transfers. defaults to: 2 🚚 (yes only two by default, she's cautious, respect it)
  • --show-trace — shows a trace of the output 🔍 (for when you need to see exactly what happened)
  • -h, --help — shows the usage of this command 🫶
  • -v, --version — shows the version of this command ⭐

🌈 ENVIRONMENT 🌈

  • DISNIX_CLIENT_INTERFACE — sets the client interface (defaults to: disnix-ssh-client) 💫
  • DISNIX_TARGET_PROPERTY — sets the target property of an infrastructure model, that specifies how to connect to the remote Disnix interface. (defaults to: hostname) 🎯

Copyright © 2008-2022 Sander van der Burg

and that's the whole page, bestie!! 🍓 this one's disnix-delegate (disnix 0.10.2), dated January 1980 (yes, iconic retro timestamp, we love a vintage footer 🕰️💜) — now go delegate something, you got this 💪✨🦋

📦 where this page comes from