Add github_runner_network_mode knob (host networking for host-side adb)

[compscidr]

What

Adds a github_runner_network_mode variable wired into the community.docker.docker_container task in roles/github_runner/tasks/main.yml, defaulting to default (no behavior change).

Why

For an Android runner we want the adb server to run on the host (the host owns the USB phones) and have the in-container adb client reach it. Running the runner container with network_mode: host shares the host's net namespace so adb talks to the host server at 127.0.0.1:5037. This lets a CI job reboot its phones without the container losing them on USB re-enumeration.

Changes

• roles/github_runner/defaults/main.yml — add github_runner_network_mode: default.
• roles/github_runner/tasks/main.yml — add network_mode: "{{ github_runner_network_mode }}" and move the ports: expression into a runner_ports var that omits the mapping when network_mode == 'host' (since ports: is invalid with network_mode: host).
• molecule/android-runner-host/ — new scenario asserting host networking converges, is idempotent, uses NetworkMode: host, and publishes no ports. Added to the CI matrix.
• README.md — document the new variable and usage pattern.
• galaxy.yml — bump to 0.1.3 (BumpApp/bump#4602 pins to it).

Testing

Ran locally with molecule (docker driver):

• android-runner-host — converge + idempotence + verify all pass (NetworkMode: host, PortBindings: {}).
• android-runner (regression after the ports: refactor) — full run exits 0, ADB port still mapped correctly.
• ansible-lint passes on the production profile.

Notes

• Default (default) keeps current behavior; existing molecule scenarios pass unchanged.
• Release as 0.1.3 and publish to Galaxy.

Closes #47

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds a configurable Docker network mode for the GitHub runner container, enabling Android runners to use host networking so in-container ADB clients can reach a host-side ADB server.

Changes:

• Introduces github_runner_network_mode defaulting to default.
• Wires network_mode into the Docker container task and omits ADB port publishing when using host.
• Adds documentation, CI coverage, and a Molecule scenario for host-networked Android runners.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
roles/github_runner/tasks/main.yml	Applies the configured Docker network mode and conditionally omits port mappings for host networking.
roles/github_runner/defaults/main.yml	Adds the new default role variable.
README.md	Documents the new option and host-side ADB usage pattern.
molecule/android-runner-host/converge.yml	Adds convergence playbook for the new Molecule scenario.
molecule/android-runner-host/molecule.yml	Defines the host-network Android runner scenario.
molecule/android-runner-host/verify.yml	Verifies host networking and absence of published ports.
galaxy.yml	Bumps the collection version to 0.1.3.
.github/workflows/lint-and-test.yml	Adds the new Molecule scenario to CI.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.