0 Fork 0

mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2026-11-13 06:06:38 +00:00

Files

T

kevinveenbirkenbachandClaude Opus 5 a056c2edaa fix(web-app-seaweedfs): mount the console config on the service that renders

The role's compose template names its service after the entity, which the rename turned into seaweedfs-console, while meta/volumes.yml still pointed the config mount at a role id that no longer exists and at the service key the engine consumer occupies. A mount whose service matches nothing is dropped without an error, so the console would have come up without its vhost config and still answered the HTTP probe from the nginx default page.

The remaining files are line joins the formatter produced once the shorter symbol name let the calls fit on one line; their syntax trees are identical to the previous revision.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-10-03 20:14:26 +02:00

annotations

fix(i18n): keep a nocheck alive when an annotation lands above it

2026-09-26 12:14:33 +02:00

cache

fix(users): reserve one username per domain label instead of the first two

2026-09-30 21:52:54 +02:00

claude

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

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

cleanup

refactor(roles): let a role declare its entity name and drop the get_ prefix

2026-10-03 19:40:53 +02:00

diagnostics

fix(diagnostics): let the in-zone probes read the drop-in that holds the zone

2026-09-03 12:50:58 +02:00

docker

refactor(roles): let a role declare its entity name and drop the get_ prefix

2026-10-03 19:40:53 +02:00

domains

style: delete every comment the comments-valid policy rejects

2026-08-18 03:22:02 +02:00

env

fix(env): take the services.yml path from the role-mapping SPOT

2026-10-01 05:50:21 +02:00

github

fix(ci): narrow a row's architectures by what its variant deploys

2026-09-22 16:01:09 +02:00

handler

fix(vault): keep ansible off the CI runner host's import path

2026-09-08 22:28:47 +02:00

i18n

fix(i18n): refuse a translation for what it destroyed, not for what it added

2026-09-30 17:35:51 +02:00

install

feat(docs): report a code span that names a linkable directory

2026-09-25 20:09:41 +02:00

inventory

perf(tools): bring the lane up only when it does not already serve

2026-09-29 11:48:07 +02:00

manager

fix(inventory): stop holding a default's template text to the value's pattern

2026-09-14 22:29:59 +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