Skip to content

Choose Free Port#724

Merged
lbedner merged 1 commit into
mainfrom
choose-free-port
Jun 7, 2026
Merged

Choose Free Port#724
lbedner merged 1 commit into
mainfrom
choose-free-port

Conversation

@lbedner

@lbedner lbedner commented Jun 7, 2026

Copy link
Copy Markdown
Owner

No description provided.

Copilot AI review requested due to automatic review settings June 7, 2026 03:52

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds host-port auto-discovery to the generated Aegis Stack project so make serve / make serve-bg can automatically select an available host port (and optionally shift backing-service host ports), allowing multiple stacks to run side-by-side without manual config edits.

Changes:

  • Introduces scripts/find-free-port.sh and scripts/resolve-ports.sh to detect free host ports and emit export ... lines for Compose.
  • Updates Makefile and Compose templates to use auto-selected host ports (plus README note), and adds tests exercising the scripts directly.
  • Updates the lockfile (Typer 0.25.1 → 0.26.4).

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
uv.lock Bumps Typer version in the lockfile.
tests/test_serve_port_autodiscovery.py Adds tests for the new port-discovery helper scripts.
aegis/templates/copier-aegis-project/{{ project_slug }}/scripts/resolve-ports.sh Emits Compose export lines and a banner for chosen ports.
aegis/templates/copier-aegis-project/{{ project_slug }}/scripts/find-free-port.sh Scans for an available TCP port starting at a base port.
aegis/templates/copier-aegis-project/{{ project_slug }}/README.md.jinja Documents automatic port selection behavior for make serve.
aegis/templates/copier-aegis-project/{{ project_slug }}/Makefile.jinja Wires make serve / serve-bg to evaluate exported ports before Compose up.
aegis/templates/copier-aegis-project/{{ project_slug }}/docker-compose.yml.jinja Uses WEBSERVER_HOST_PORT (when set) for host port publishing.
aegis/templates/copier-aegis-project/{{ project_slug }}/docker-compose.dev.yml.jinja Applies host-port overrides for webserver, (optional) Redis/Postgres/Ollama, and (optional) Traefik.

Comment thread aegis/templates/copier-aegis-project/{{ project_slug }}/Makefile.jinja Outdated
Comment thread aegis/templates/copier-aegis-project/{{ project_slug }}/Makefile.jinja Outdated
Comment thread tests/test_serve_port_autodiscovery.py Outdated
@lbedner lbedner force-pushed the choose-free-port branch from ef5ae0e to abc6cc3 Compare June 7, 2026 04:12
@lbedner lbedner force-pushed the choose-free-port branch from abc6cc3 to a5c30b4 Compare June 7, 2026 04:31
@lbedner lbedner merged commit cd43df2 into main Jun 7, 2026
11 of 12 checks passed
@lbedner lbedner deleted the choose-free-port branch June 7, 2026 18:30
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.

2 participants