0 Fork 0

mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2026-11-14 06:37:25 +00:00

Files

T

kevinveenbirkenbachandClaude Opus 4.8 c44235d792 perf(swarm-test): fold DR-drill redeploy into the matrix update pass

The drill (backup/base.sh) no longer runs its own step-10 redeploy; it recovers device -> nfs export -> volume -> secrets and writes a sentinel. The matrix update pass (which runs next anyway) boots the recovered stack, and verify_recovered_marker.sh asserts the live marker after it. Saves one full stack redeploy per drilled app; the marker-gone check before recovery stays in 05_wipe_export.sh.

Also derive recover_drill.sh REPO from the script location instead of an INFINITO_REPO_ROOT shell-side default (lint: no INFINITO_* / absolute-path defaults in .sh).

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

2026-07-14 04:42:31 +02:00

annotations

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

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

cache

fix(svc-runner): publish no dev-stack ports in nested DooD deploys

2026-07-10 18:43:34 +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

diagnostics

refactor(diagnostics): recursive workflow-level rescue snapshot, no in-play rescue blocks

2026-07-12 03:15:53 +02:00

docker

fix(env): keep the .env generation stdlib-only for fresh-host bootstrap

2026-07-09 23:54:33 +02:00

domains

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

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

env

fix(cache): metadata/negative TTL so unknown packages refresh

2026-07-14 02:47:40 +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