Fix EAI_AGAIN: work around Docker's internal-network DNS bug with a static IP

- egress-proxy gets a fixed IP (172.28.5.10) on a new 172.28.5.0/24
  subnet for the 'egress' network.
- sde-meeting-toolkit gets a static extra_hosts entry for
  'egress-proxy' instead of relying on Docker's embedded DNS, which
  breaks for internal-network names on a container that's also on a
  normal network (confirmed via a real smoke test run - EAI_AGAIN).
- Update CHANGELOG with the root cause and the subnet-collision caveat.
This commit is contained in:
2026-09-29 18:52:28 -07:00
parent dc1f6b81e9
commit 6eb4b59d97
2 changed files with 22 additions and 2 deletions

View File

@@ -2,6 +2,11 @@
All notable changes to this project are logged here, newest first. This file starts from the point the toolkit was handed off and set up in this repo.
## 2026-09-29 (4)
- Fixed (found via real smoke test on the user's own Docker): `sde-meeting-toolkit` couldn't resolve `egress-proxy` at all (`getaddrinfo EAI_AGAIN egress-proxy`) once `egress` was marked `internal: true`. Root cause is a known Docker bug: a container on both a normal network (`proxy`) and an `internal: true` network (`egress`) can lose embedded DNS resolution for names on the internal side. Fixed by giving `egress-proxy` a fixed IP (`172.28.5.10` on a new `172.28.5.0/24` subnet) and adding a static `extra_hosts` entry on `sde-meeting-toolkit` instead of relying on DNS for that one name.
- Note: `172.28.5.0/24` is an arbitrary private subnet choice. If it collides with another Docker network already on a host, change it (and the matching `ipv4_address`/`extra_hosts` entries) to an unused one - Docker's error message names the conflict if this happens.
## 2026-09-29 (3)
- Added: outbound network restriction. `sde-meeting-toolkit` no longer has any direct route to the internet. Its one outbound call (the AI draft button, to `api.anthropic.com`) is routed through a new `egress-proxy` container (`egress-proxy/`, tinyproxy) that only allows that one destination and refuses everything else, even from inside a compromised app container.