0 Fork 0

mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2026-11-11 21:26:44 +00:00

Files

T

kevinveenbirkenbachandClaude Fable 5 e35acc09bc feat(updater): support registry.gitlab.com images

Add registry.gitlab.com to the mirrorable registries so discovery
yields the GitLab CNG images to the version updater and mirror sync.

Seed the generic v2 tag scan with the OCI last cursor for v-prefixed
pins and raise the page size to 1000: CNG repos carry tens of
thousands of commit-sha tags that sort before the release tags, so an
unseeded scan exhausted the page cap without reaching any semver tag.

Pin every gitlab service version in meta/services.yml and drop the
GITLAB_VERSION template override so services.yml is the single source
for per-service versions.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-08 02:37:28 +02:00

annotations

refactor(roles): drop compose-nocheck flags + extract include-gated sub-tasks

2026-06-14 19:08:46 +02:00

cache

fix(keycloak-swarm): render delegated realm-user credentials + drop retry recursion

2026-07-06 19:03:07 +02:00

claude

test(lint/cache-read): extend scope to utils, cli, plugins, library

2026-05-15 14:23:32 +02:00

cleanup

refactor: single /var/lib SPOT + swarm Playwright artifact upload

2026-06-26 17:01:09 +02:00

docker

feat(updater): support registry.gitlab.com images

2026-07-08 02:37:28 +02:00

domains

refactor(meta): split server.yml into csp/domains/networks.yml

2026-06-28 22:45:05 +02:00

env

fix(env): keep the env generator importable on the bare bootstrap python

2026-07-04 03:21:55 +02:00

github

feat(meta/complexity): multi-key sort, filter DSL, CI columns

2026-06-30 20:33:01 +02:00

handler

fix(vault): encrypt_string reads plaintext from stdin so leading-dash values encrypt

2026-06-17 11:30:39 +02:00

install

fix(security): resolve all open code-scanning alerts and guard against recurrence

2026-06-30 01:38:40 +02:00

inventory

feat(swarm): swarm-aware deploy CLI with inventory-derived dep closure

2026-06-05 02:24:51 +02:00

manager

refactor(gitlab): replace Omnibus with the Cloud Native GitLab composition

2026-07-08 02:37:27 +02:00

README.md

Shared Utilities (`utils/`)

This directory contains shared Python helpers used by custom modules and plugins.

Purpose

Use utils/ for reusable code that should not be duplicated across:

library/ modules,
plugins/action/,
plugins/filter/,
plugins/lookup/.

Typical shared utilities:

API clients,
validation/conversion helpers,
path and configuration helpers,
cross-plugin/module domain logic.
Shared HTTP(S) connection handler for multiple modules.
Common validation or transformation functions for user input.
Utility functions for interacting with Docker, LDAP, etc.
Grouped helper packages such as utils/domains/ for related domain logic.

Design Guidelines

Keep helpers focused and composable.
Avoid side effects during import.
Prefer explicit function/class APIs over implicit globals.
Keep dependencies minimal so modules/plugins stay lightweight.

Example Import

from utils.domains.primary_domain import get_primary_domain

What Does Not Belong Here

Standalone executable modules (put in library/).
Ansible plugin entrypoints (put in plugins/*).

References

Module utilities: https://docs.ansible.com/ansible/latest/dev_guide/developing_module_utilities.html
Plugin development: https://docs.ansible.com/ansible/latest/dev_guide/developing_plugins.html