kevinveenbirkenbachandClaude Opus 4.7
4bd23d5f1b
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>
System Utility: Git Pull (Shallow & Pinned)
Description
This Ansible role provides a robust, reusable Git pull utility for system automation.
It performs shallow clones or updates of Git repositories and optionally pins the working tree
to a specific tag (e.g. stable) in a detached HEAD state.
The role is designed to solve common automation pitfalls such as:
- conflicting local tags (
would clobber existing tag) - detached HEAD updates
- annotated vs. lightweight tags
- reliable change detection for Ansible
Internally, the role delegates complex Git logic to a small, well-tested Python helper script, keeping the Ansible YAML concise and readable.
Overview
This role:
- Ensures a repository exists at a given destination
- Clones the repository shallowly if it does not exist
- Updates an existing repository in a detached-safe manner
- Optionally removes conflicting local tags before fetching
- Optionally pins the checkout to a specific tag (e.g.
stable) - Marks the Ansible task as
changedif:- the repository was cloned
- tags were removed
- the pinned tag appeared for the first time
- the pinned tag moved on the remote (optional)
Purpose
The purpose of this role is to provide a generic, reusable Git pull primitive for other roles in the Infinito.Nexus ecosystem.
Typical use cases include:
- installing tools pinned to a
stabletag - reproducible system deployments
- CI/CD-friendly shallow clones
- avoiding fragile inline Git shell logic in roles
Features
- Shallow Clone & Update (
--depth) - Detached-safe Branch Updates
- Optional Tag Pinning (e.g.
stable) - Annotated Tag Support (
tag^{}) - Local Tag Conflict Healing
- Deterministic
changed_whenSemantics - Verbose Debug Logging (stderr-only)
Design Notes
- All human-readable logs go to stderr
- Machine-readable state (
CHANGED=…) is written to stdout - This guarantees reliable
changed_whenbehavior in Ansible - The Python helper is intentionally self-contained and unit-testable
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).