mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-19 00:49:54 +00:00
Adds `# nocheck: required-by-coverage — TODO: declare proper required_by`
markers to meta/services.yml of 74 non-invokable system roles (dev-*, pkgmgr*,
sys-aur*, sys-front-inj-*, sys-front-tls-*, sys-svc-{cdn,certbot,certs,
cln-domains,dns,journalctl,mail*,proxy,rdbms,ssh,sshd}, sys-timer*, sys-stk-*,
user-*, …).
This is the passthrough layer that lets the upcoming `required_by` lint
(Bundle C) hard-fail any *new* non-invokable role without an explicit coverage
declaration, while existing roles get a documented TODO grace period instead
of an immediate CI break.
No runtime effect — comments only.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
sys-service
Description
Role to manage systemd service units for Infinito.Nexus software stacks. It installs or removes unit files, configures runtime behavior, and ensures services are properly deployed.
Overview
- Resets service units by removing old or obsolete definitions.
- Deploys new service unit files and service scripts.
- Optionally sets up timers linked to the services.
- Ensures correct reload/restart behavior across the stack.
- Provides the shared
files/debug.shSPOT for reusable service-failure diagnostics. - Exposes
tasks/utils/debug.ymlas the canonical Ansible wrapper around that script.
Features
- Unit Cleanup: Automated removal of old service units.
- Custom Templates: Supports both
systemctl.service.j2andsystemctl@.service.j2. - Timers: Integrates with
sys-timerfor scheduled execution. - Runtime Limits: Configurable
RuntimeMaxSecper service. - Handlers: Automatic reload/restart of services when definitions change.
- Shared Diagnostics: Centralized
systemctl/journalctl/unit-file diagnostics viafiles/debug.sh. - Wrapper Task: Reusable Ansible include in
tasks/utils/debug.ymlfor calling and printing the shared diagnostics.
Further Resources
Credits
Developed and maintained by Kevin Veen-Birkenbach. Learn more at veen.world. Part of the Infinito.Nexus Project. Licensed under the Infinito.Nexus Community License (Non-Commercial).