kevinveenbirkenbachandClaude Opus 4.8
96aa7784b6
Add a 'timeout' lookup plugin that returns round(base * TIMEOUT_FACTOR)
(group_vars default 1, so value-identical to the old literals). One knob
in group_vars stretches every wait in the stack for a slow uplink:
TIMEOUT_FACTOR: 2 doubles them all.
- plugins/lookup/timeout.py + unit tests (identity, factor scaling,
string coercion, error paths).
- group_vars/all/17_resource.yml: TIMEOUT_FACTOR: 1.
- Convert all 34 literal 'timeout:' task keywords / module args across 25
task+handler files to "{{ lookup('timeout', <base>) | int }}".
- tests/lint/repository/yaml/test_timeout_uses_lookup.py enforces the
lookup in every task/handler timeout (opt-out: # nocheck: timeout-lookup).
- swarm.yml pre-deploy build handler: add the missing timeout (same
network-build hang vector as compose.yml's Build compose).
- Drop 13 pre-existing narration comments in the touched files (comment
lint enforces whole-file on any edited file).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
dev-nix
This role installs the Nix package manager in a secure, reproducible, and idempotent way across multiple Linux distributions.
Description
The role installs Nix using either the native package manager (where supported and reliable) or the official installer with SHA256 verification.
On platforms where distro packages are known to be problematic (e.g. Arch Linux ARM), the role deliberately avoids the system package and falls back to the official installer to ensure a working and up-to-date Nix installation.
Overview
This role installs the Nix package manager via pacman on Arch x86_64 or via the official installer with SHA256 verification.
Installation Strategy
The role automatically selects the appropriate installation method:
-
Arch Linux (x86_64)
Installsnixvia the system package manager (pacman). -
All other platforms (including Arch Linux ARM, Debian, Ubuntu, Fedora, EL, Generic Linux)
Uses the official Nix installer in multi-user (daemon) mode.
This avoids ABI and SONAME mismatches on rolling or less frequently rebuilt distributions.
Security Model
The official installer is downloaded at runtime and verified before execution:
- The installer script is fetched from the official release location
- Its SHA256 checksum is fetched from the same release
- The checksum is validated before execution
- Installation aborts immediately if verification fails
No unverified code is executed on the target system.
Features
- Automatic platform detection (Arch x86_64 vs others)
- Verified official installer with SHA256 checksum validation
- Multi-user (daemon) installation mode
- Optional shell integration via
/etc/profile.d - Optional activation of experimental features (
nix-command,flakes) - Fully idempotent (safe to run multiple times)
- Distro-agnostic fallback logic
Configuration Options
Key variables (see defaults/main.yml):
-
dev_nix_installer_version
Nix version to install via the official installer. -
dev_nix_enable_experimental_features
Enable experimental features such asnix-commandandflakes. -
dev_nix_enable_shell_snippet
Whether to install a profile snippet for automatic environment loading.
Notes on Offline Usage
This role does not ship the installer script and therefore requires network access during installation.
If a fully offline or air-gapped setup is required, the role can be extended to use a locally vendored installer script with a pinned checksum.
Further Resources
- Nix project: https://nixos.org
- Nix releases: https://releases.nixos.org
- Infinito.Nexus License: https://s.infinito.nexus/license
Credits
Implemented by Kevin Veen-Birkenbach. Part of the Infinito.Nexus Project and maintained by Kevin Veen-Birkenbach. Licensed under the Infinito.Nexus Community License (Non-Commercial).