- Python 84.7%
- Roff 15.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
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
|
||
| .forgejo/workflows | ||
| completion | ||
| debian | ||
| src/puppetctl | ||
| tests | ||
| .gitignore | ||
| LICENSE | ||
| puppetctl.1 | ||
| pyproject.toml | ||
| README.md | ||
| setup.cfg | ||
| setup.py | ||
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.