From ffd7684f5a1ba9fcf171b4f917d2e8d49c455dcc Mon Sep 17 00:00:00 2001 From: Jordi Gil Date: Wed, 12 Aug 2026 20:18:42 -0400 Subject: [PATCH] docs: clarify mock-epp/llmd-ext-proc image scope in operations.md The "Required local images" table read as if all provider/consumer gateways need locally-built `praxis-ai:llmd-ext-proc` and `praxis-ai-mock-epp` images. In practice only the generic `xtask env` harness (validate-all, verify-swim-mesh-three-node, verify-failover-under-lost-peer) uses those defaults; the named demos (grid-glb-demo, grid-combined-site, grid-llmd-pool-metrics) override them with published ghcr.io/praxis-proxy/grid-ai-rollup images via GRID_XTASK_GATEWAY_IMAGE/GRID_XTASK_MOCK_EPP_IMAGE and never touch an AI repository checkout. Also note that Containerfile.composed and a mock llm-d EPP server don't exist in the AI repository yet, so build-gateway-images --ai-repo can't produce either image today. That gap only blocks the generic-harness path (verify-failover-under-lost-peer); it doesn't affect the three named demos above. Cross-links ai#716 (tracking the gap) and ai#334 (the in-flight, other-team-owned ext_proc work it's soft-blocked on). Signed-off-by: Jordi Gil --- docs/architecture/operations.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/architecture/operations.md b/docs/architecture/operations.md index 53b4586..d6b8127 100644 --- a/docs/architecture/operations.md +++ b/docs/architecture/operations.md @@ -1305,6 +1305,31 @@ images must exist in the local container daemon: | `localhost/praxis-ai-mock-epp:latest` | AI repository external checkout | All provider gateways | | `grid-mock-providers:latest` | This repository, `mock-providers/Containerfile` | Provider clusters with `backend = "mock-openai"` only | +This table applies to the generic `xtask env` harness above +(`validate-all`, `verify-swim-mesh-three-node`, +`verify-failover-under-lost-peer`, etc.), which is the only +path that consumes these two locally-built defaults directly. +The named demos (`grid-glb-demo`, `grid-combined-site`, +`grid-llmd-pool-metrics`) do **not** need them — they override +`GRID_XTASK_GATEWAY_IMAGE`/`GRID_XTASK_MOCK_EPP_IMAGE` +(see `xtask/src/env/image_overrides.rs`) with published +`ghcr.io/praxis-proxy/grid-ai-rollup` images and never build +from an AI repository checkout. + +As of this writing, neither `Containerfile.composed` nor a mock +llm-d Endpoint Picker server implementation exists in the AI +repository (tracked in +[`ai#716`](https://github.com/praxis-proxy/ai/issues/716)), so +`build-gateway-images --ai-repo ` cannot currently produce +either of the first two images. That gap blocks only the +generic-harness path — concretely, `verify-failover-under-lost-peer` +today — not any of the three named demos above. It is itself +soft-blocked on the in-flight, other-team-owned +[`ai#334`](https://github.com/praxis-proxy/ai/pull/334) +(`ext_proc` compatibility moving into the AI repository), which is +deliberately paused pending a release-timeline decision rather than +abandoned. + Use `build-gateway-images --ai-repo ` to build the first two images from the AI repository source tree. Build `grid-mock-providers:latest` separately from this repository: