mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-07 03:15:56 +00:00
evangelostsak
ca1a93f93a
Run 37931817959 timed the four cells and two of them are real: a module call costs 245ms over docker and 212ms over ssh through the tunnel, with or without become on the docker side. The connection plugin is not the cost. The escalated ssh cell is not real. The benchmark ran without the extras, so ansible_become_password was absent and all 200 calls failed on 'Incorrect sudo password' - 3.2s each, which prices a failing sudo rather than a working one. It now passes the same two -e files the deploy passes. Its exit code also reached the round, so a diagnostic turned three green deploys red. transport_bench now discards its own rc: whether a deploy passes is not a benchmark's business.
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