Skip to content

docs: improve ansible development documentation and harden goad attack box#243

Merged
l50 merged 1 commit into
mainfrom
chore/migrate-nimbus-range-ansible
Apr 29, 2026
Merged

docs: improve ansible development documentation and harden goad attack box#243
l50 merged 1 commit into
mainfrom
chore/migrate-nimbus-range-ansible

Conversation

@l50
Copy link
Copy Markdown
Contributor

@l50 l50 commented Apr 29, 2026

Key Changes:

  • Added comprehensive development guide for Ansible collection workflow
  • Updated README to clarify in-repo usage and development references
  • Hardened attack box provisioning by disabling Transparent Huge Pages (THP)
  • Improved maintainability by automating documentation and diagram regeneration

Added:

  • Detailed docs/development.md covering collection layout, development,
    pre-commit hooks, molecule usage, CI workflows, and role/playbook
    authoring
  • Pre-task and handler in goad_attack_box.yml to disable THP at runtime
    and persistently via kernel cmdline, mitigating instance lockups during
    heavy workloads

Changed:

  • Updated ansible/README.md development section to reference the new
    development guide, clarify the collection is not published to Galaxy, and
    point to local development and CI details
  • Inserted pre-commit, molecule, and architecture diagram documentation
    references to improve onboarding and contributor experience

Removed:

  • Obsolete release process section and Galaxy release guidance from
    ansible/README.md, replaced with current in-repo workflow details

**Added:**

- Introduced `docs/development.md` detailing local development workflow, tooling,
  pre-commit hooks, CI, and collection consumption specifics for the ansible
  subdirectory

**Changed:**

- Rewrote the Development section in `README.md` to clarify that the collection
  is consumed from the repository, not published to Ansible Galaxy, and
  referenced the new development documentation for contributor guidance
- Updated `goad_attack_box.yml` playbook to include pre_tasks that disable
  Transparent Huge Pages both persistently and at runtime, with a handler to
  update grub, mitigating kernel lockups during heavy workloads

**Removed:**

- Removed outdated release process documentation reference from `README.md`
@l50 l50 changed the title feat: enforce lockout-aware password spray and update agent instructions docs(ansible): rewrite collection docs for ares context Apr 29, 2026
@l50 l50 changed the title docs(ansible): rewrite collection docs for ares context ``` Apr 29, 2026
@l50 l50 changed the title ``` docs: improve ansible development documentation and harden goad attack box Apr 29, 2026
@l50 l50 merged commit 53ca3c9 into main Apr 29, 2026
10 of 11 checks passed
@l50 l50 deleted the chore/migrate-nimbus-range-ansible branch April 29, 2026 20:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant