Files
computer-playbook/roles/sys-service
kevinveenbirkenbachandClaude Opus 4.7 4bd23d5f1b chore(roles): mark non-invokable roles with nocheck:required-by-coverage (Bundle D)
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>
2026-05-23 04:23:45 +02:00
..
…

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.sh SPOT for reusable service-failure diagnostics.
  • Exposes tasks/utils/debug.yml as the canonical Ansible wrapper around that script.

Features

  • Unit Cleanup: Automated removal of old service units.
  • Custom Templates: Supports both systemctl.service.j2 and systemctl@.service.j2.
  • Timers: Integrates with sys-timer for scheduled execution.
  • Runtime Limits: Configurable RuntimeMaxSec per service.
  • Handlers: Automatic reload/restart of services when definitions change.
  • Shared Diagnostics: Centralized systemctl/journalctl/unit-file diagnostics via files/debug.sh.
  • Wrapper Task: Reusable Ansible include in tasks/utils/debug.yml for 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).