Skip to content

docs(ops): standardize on default Docker context and add port-collision guard (#96) - #107

Merged
JJediny merged 1 commit into
mainfrom
fix/standardize-docker-context
Oct 4, 2026
Merged

JJediny merged 1 commit into
mainfrom
fix/standardize-docker-context

Conversation

@JJediny

@JJediny JJediny commented Oct 4, 2026

Copy link
Copy Markdown
Owner

Summary

Closes #96.

Standardizes deployment documentation and tooling on the system Docker daemon (default context) and adds a port conflict check to prevent host-port bind collisions.

Key Changes

  • Documentation: Updated README.md to document selecting the default context (docker context use default) to avoid running duplicates on Docker Desktop (desktop-linux).
  • Port Conflict Guard: Added scripts/check-ports.sh and a check-ports task in Taskfile.yml to detect if published stack ports (5080, 5081, 4317, 4318, 9000, 9090) are already bound before starting containers.
  • Cleanup: Cleaned up 5 stale benchmark containers (oo-bench-*) and exited profile containers from docker ps -a. Verified desktop-linux context and stale /home/john/loki directories are no longer present.
  • Unit Test: Added test_check_ports_script_exists_and_executable to tests/test_benchmarks.py.

Verification

  • bash scripts/check-ports.sh: Verified output and exit code.
  • uv run pytest tests/test_benchmarks.py: 9 passed in 0.25s.
  • uv run pytest tests/: 362 passed, 40 skipped across the full test suite.

…on guard (#96)

Documents DOCKER_CONTEXT=default / docker context use default in README.md
to prevent concurrent runs on Docker Desktop (desktop-linux) producing
port-bind collisions and unattached containers.
Adds scripts/check-ports.sh and Taskfile check-ports task to detect
published port collisions before compose boot.
Cleans up stale benchmark and profile containers.
Adds unit test to test_benchmarks.py.
@JJediny
JJediny merged commit d6eb40d into main Oct 4, 2026
9 checks passed
@JJediny
JJediny deleted the fix/standardize-docker-context branch October 4, 2026 00:59
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.

Steering: standardize on the 'default' Docker context; clean desktop-linux duplicate + stale leftovers

1 participant