DISNIXOS-VM-ENV(1)

📦 version 0.9.4, in nixos 26.05, nixpkgs unstable

💅 DISNIXOS-VM-ENV 💅

okay so bestie, let me introduce you to disnixos-vm-env from the User Commands girlies — this is the one that spins up a whole network of VMs and deploys your distributed system inside it 🫶

✨ NAME ✨

disnixos-vm-env — deploys and runs a distributed system in a network of VMs spawned by the NixOS test driver 🌸 no cap, that's literally what it does.

🎀 SYNOPSIS 🎀

disnixos-vm-env -s services_nix -n network_nix [ -n network_nix ... ] -d
distribution_nix [OPTION]
disnixos-vm-env -P packages_nix -n network_nix [ -n network2_nix ... ]
[OPTION]

🦋 DESCRIPTION 🦋

The command disnixos-vm-env is used to generate and launch a network of virtual machines, closely matching the machine configurations defined in the network model. Iconic behavior honestly ✨

This command requires 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
  • A network model capturing the NixOS configurations of machines in the network and its properties
  • A distribution model which maps services to machines

By invoking this command, it will first build a network of virtual machines, closely matching the NixOS configurations in the network model. Then it will build all the services that are defined in the distribution model from source code including all its dependencies. Finally, it launches the virtual machines and deploys the system into the virtual network. the way it does all three in order… main character energy fr fr 💜

🔥 OPTIONS 🔥

  • -s, --services=services_nix — Services Nix expression which describes all components of the distributed system 💖
  • -n, --network=network_nix — Network Nix expression which declares a NixOS configuration for each machine in the network 🌈 (and yeah, you can pass this one multiple times, see the synopsis bestie, it's right there)
  • -d, --distribution=distribution_nix — Distribution Nix expression which maps services to machines in the network 🎀
  • -P, --packages=packages_nix — Packages Nix expression specifying the packages that should be deployed in a Nix profile mapped to each machine in the network 🍓
  • --deploy-state — Indicates whether to globally deploy state (disabled by default) 🙈
  • --show-trace — Shows a trace of the output 👀 very "let me see the receipts" of it all
  • -h, --help — Shows the usage of this command 🫶
  • -v, --version — Shows the version of this command ⭐

🌸 ENVIRONMENT 🌸

  • DISNIX_DEPLOY_STATE — If set to 1 it also deploys the state of all components. (defaults to: 0) 💫 lowkey confusing that it's a separate thing from the --deploy-state flag but okay, that's the lore.
  • DYSNOMIA_STATEDIR — Specifies where the snapshots must be stored on the coordinator machine (defaults to: /var/state/dysnomia) 🧚

Copyright © 2008-2022 Sander van der Burg 💖

okay that's the whole page bestie, go deploy something gorgeous ✨💅 and yeah — this was disnixos-vm-env (disnixos 0.9.4) dated January 1980 (yes the date is silly, don't come for me, that's just what the footer says 😭). bye ily 🫶🦋

📦 where this page comes from