No description
  • Python 84.7%
  • Roff 15.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
André Keller 8b30b17ba2
All checks were successful
Build Debian package / Build package for jammy/main (push) Successful in 35s
Build Debian package / Build package for noble/main (push) Successful in 31s
Build Debian package / Build package for resolute/main (push) Successful in 39s
Build Debian package / Publish Debian packages (push) Successful in 3s
Fix noop-run semantics
2026-11-17 19:41:37 +01:00
.forgejo/workflows Set correct main branch 2026-11-17 13:41:57 +01:00
completion Initial release 2026-11-17 13:40:19 +01:00
debian Fix noop-run semantics 2026-11-17 19:41:37 +01:00
src/puppetctl Fix noop-run semantics 2026-11-17 19:41:37 +01:00
tests Fix noop-run semantics 2026-11-17 19:41:37 +01:00
.gitignore Initial release 2026-11-17 13:40:19 +01:00
LICENSE Initialize repository 2026-11-17 12:52:00 +01:00
puppetctl.1 Fix noop-run semantics 2026-11-17 19:41:37 +01:00
pyproject.toml Initial release 2026-11-17 13:40:19 +01:00
README.md Fix noop-run semantics 2026-11-17 19:41:37 +01:00
setup.cfg Initial release 2026-11-17 13:40:19 +01:00
setup.py Initial release 2026-11-17 13:40:19 +01:00

puppetctl

Small administrative frontend for the puppet-run.service and puppet-run.timer units managed by the Puppet module. The upstream puppet.service stays disabled.

Command Action
puppetctl status Show Puppet disabled state and systemd execution state
sudo puppetctl run Run Puppet with --test in the foreground; respects disablement
sudo puppetctl noop-run Run --test --noop, temporarily enabling Puppet if disabled
sudo puppetctl disable 'reason' Disable Puppet; leave timer untouched
sudo puppetctl enable Re-enable Puppet; leave timer untouched
sudo puppetctl stop 'reason' Stop timer, wait for agent, stop timer again, disable Puppet
sudo puppetctl start Enable Puppet, start timer, and run --test interactively

stop waits for both the scheduled service and Puppet's native catalog-run lock (including interactive runs), at most 30 minutes by default; stop --timeout SECONDS 'reason' changes this bound. It never terminates a running catalog application. If the wait times out, the timer has been stopped but Puppet remains enabled and the command exits with an error. Run status and retry when the agent has finished.

Systemd operations use the system D-Bus API through Ubuntu's python3-dbus package. Only native Puppet commands are executed as subprocesses.

The helper does not store its own state. The timer state is managed by systemd; Puppet's native agent disabled lock remains authoritative. run respects administrative disablement. noop-run temporarily enables a disabled agent and restores its original disable reason after the run, including on failure. All interactive runs execute the native Puppet command in the foreground (--test, optionally --noop); scheduled runs continue through puppet-run.service. Puppet's native agent lock controls overlapping interactive and scheduled runs.

The package is built as a native Debian package for Ubuntu 22.04, 24.04 and 26.04. Release tags use debian/*; the Forgejo workflow follows the shared build and publish actions used by other peer42 packages.

Requirements: Ubuntu 22.04+, python3-dbus, systemd, and an installed OpenVox/Puppet agent at /opt/puppetlabs/bin/puppet. The package does not install or configure systemd units; those are managed by the Puppet module.