mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-06 02:54:26 +00:00
kevinveenbirkenbachandClaude Opus 4.7
c02229b4be
Apply a consistent naming convention to the Make target inventory so
every target is grouped by its domain:
- compose-* (compose-up/down/restart/stop/exec/inner-run)
- network-* (network-dns-setup/remove, network-ipv6-disable/restore,
network-refresh, network-trust-ca)
- security-* (security-apparmor-restore/teardown)
- diagnose-* (diagnose-network, diagnose-disk-usage)
- fix-* (fix-chmod, fix-dockerignore)
- clean-* (clean-cache, clean-pycache-dirs)
- install-* (install-agent)
- meta-* (meta-list, meta-tree, meta-mig)
Drop the stale debug-network target and reintroduce its functionality
as diagnose-network. Cascade renames through:
- Makefile (.PHONY entries, prereqs, recursive $(MAKE) calls)
- contributor docs, agent-iteration docs, role-level docs
- bundle README, environment scripts, install/lint/test wrappers
- AGENTS.md, CLAUDE.md, compose/cache.override.yml, .github/workflows
Historical entries under docs/requirements/ and changelog/ stay
untouched as audit logs.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
17 lines
1.2 KiB
Markdown
17 lines
1.2 KiB
Markdown
# Network 🌐
|
|
|
|
Contributor-side network tooling: probe the live container network stack, suggest free per-role subnets, and suggest free host-bound ports.
|
|
|
|
## Subcommands 🧭
|
|
|
|
| Path | Purpose |
|
|
|---|---|
|
|
| [diagnose/](diagnose/) | Run `python -m cli.contributing.network.diagnose` to print a structured DNS / TCP / TLS / PMTU report (IPv4 + IPv6) plus interface MTU, `/etc/resolv.conf`, `/etc/hosts`, proxy env vars, and CA bundle summaries from inside the running infinito container. Exposed as `make diagnose-network`. |
|
|
| [address/](address/) | `cli contributing network address suggest`: propose the next free per-role IPv4 subnet(s) gap-first within the established umbrella blocks. |
|
|
| [ports/](ports/) | `cli contributing network ports suggest`: propose free host-bound ports inside `PORT_BANDS.<scope>.<category>`. |
|
|
|
|
## Related Documentation 📚
|
|
|
|
- [docs/contributing/actions/debugging/network.md](../../../docs/contributing/actions/debugging/network.md) explains how to read the diagnose output and how to fix MTU / IPv6 / connectivity issues.
|
|
- [docs/contributing/tools/network/](../../../docs/contributing/tools/network/) covers the contract of the `address` and `ports` suggesters.
|