compose/pkg/compose
Nicolas De Loof 5bc5b864fc feat(provider): pull command and get-image protocol for image distribution
Providers opt into image distribution by declaring a pull block in
their metadata — the presence of the command block is the declaration
of support, generalizing the stop precedent. During its pull command a
provider can request the service image from the local daemon with a
get-image message (optionally platform-narrowed); compose answers on
stdin with one image-stream JSON line then the tar as HTTP/1.1 chunked
data (RFC 9112): length-prefixed blocks need no in-band delimiter in
binary data, the zero-length chunk marks a COMPLETE transfer, and any
stock chunked reader consumes it. There is deliberately no trailer nor
final CRLF after the zero chunk — a stock reader stops there without
consuming further bytes, so the next stdin answer starts clean for a
provider requesting several images. An export failure is announced
in-band through the error field so the provider is never left waiting;
a failure after the announce closes the answer channel so the
truncation is observable as EOF mid-chunk instead of a stream nobody
will finish. The stream is exclusive on stdin for its whole duration —
the framing invariant behind the lock.

get-image is scoped to the pull command: emitted during up, down or
stop it is a protocol error rather than served, so an image export can
never stall another lifecycle command.

Message dispatch moves out of executePlugin into handlePluginMessage,
which also keeps the function under the complexity threshold.

Signed-off-by: Nicolas De Loof <nicolas.deloof@gmail.com>
2026-10-02 17:35:20 +02:00
..
testdata
transform chore: explicit, unique, greppable names for internal identifiers 2026-08-20 11:17:11 +02:00
api_versions.go fix: gate extra EndpointsConfig behind API >= 1.44 2026-03-31 15:44:00 +02:00
apiSocket.go
attach.go chore: explicit, unique, greppable names for internal identifiers 2026-08-20 11:17:11 +02:00
attach_service.go
build.go remove buildx as a Go dependency 2026-08-25 17:27:26 +02:00
build_bake.go golangci-lint: enable perfsprint linter 2026-09-10 10:25:34 +02:00
build_bake_test.go fix(build): honor provenance/sbom false in per-service bake attest 2026-08-25 17:46:03 +02:00
build_classic.go golangci-lint: enable perfsprint linter 2026-09-10 10:25:34 +02:00
build_test.go build(deps): adopt compose-go jobs and the container-spec layering 2026-09-21 16:35:20 +02:00
commit.go golangci-lint: enable perfsprint linter 2026-09-10 10:25:34 +02:00
compose.go feat(compose): dedicated network for the provider relay link 2026-10-02 12:33:26 +02:00
compose_test.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
container.go
containers.go fix: share --parallel budget across down's ops and up's log-attach 2026-10-01 16:02:14 +02:00
containers_test.go chore(compose): orphan semantics stated where up and down diverge 2026-08-31 17:09:19 +02:00
convert.go
cp.go fix: bound compose cp's fan-out and panic-safe log slot release 2026-10-01 16:02:14 +02:00
cp_test.go fix: bound compose cp's fan-out and panic-safe log slot release 2026-10-01 16:02:14 +02:00
create.go feat: reconciliation plan creates pre_start hook runners 2026-09-30 12:03:10 +02:00
create_test.go build(deps): adopt compose-go jobs and the container-spec layering 2026-09-21 16:35:20 +02:00
dependencies.go fix: bound compose cp's fan-out and panic-safe log slot release 2026-10-01 16:02:14 +02:00
dependencies_test.go build(deps): adopt compose-go jobs and the container-spec layering 2026-09-21 16:35:20 +02:00
desktop.go refactor: drop Desktop beta-settings check; gate hint on LogsTab flag 2026-05-18 17:28:03 +02:00
docker_cli_providers.go
down.go fix(compose): share relay-link network removal and state its isolation precisely 2026-10-02 12:33:26 +02:00
down_test.go feat(compose): dedicated network for the provider relay link 2026-10-02 12:33:26 +02:00
envresolver.go
envresolver_test.go
events.go
exec.go feat(provider): publish-endpoint deploys a network relay for provider services 2026-09-16 17:03:23 +02:00
executor.go fix: share --parallel budget across down's ops and up's log-attach 2026-10-01 16:02:14 +02:00
executor_events.go executor: split into ops + events files 2026-06-08 20:14:38 +02:00
executor_ops.go feat: reconciliation plan creates pre_start hook runners 2026-09-30 12:03:10 +02:00
executor_test.go fix: share --parallel budget across down's ops and up's log-attach 2026-10-01 16:02:14 +02:00
export.go golangci-lint: enable perfsprint linter 2026-09-10 10:25:34 +02:00
filters.go feat(hooks): clean up retained pre_start containers on compose down 2026-08-20 18:57:02 +02:00
generate.go build(deps): adopt compose-go jobs and the container-spec layering 2026-09-21 16:35:20 +02:00
hash.go fix(hash): repair the tests after #14093 and #14215 merged in reverse order 2026-09-22 11:03:06 +02:00
hash_test.go fix(hash): repair the tests after #14093 and #14215 merged in reverse order 2026-09-22 11:03:06 +02:00
hook.go feat(hooks): clean up retained pre_start containers on compose down 2026-08-20 18:57:02 +02:00
hook_test.go build(deps): adopt compose-go jobs and the container-spec layering 2026-09-21 16:35:20 +02:00
image_pruner.go fix: share --parallel budget across down's ops and up's log-attach 2026-10-01 16:02:14 +02:00
image_pruner_test.go fix: share --parallel budget across down's ops and up's log-attach 2026-10-01 16:02:14 +02:00
images.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
images_test.go build(deps): adopt compose-go jobs and the container-spec layering 2026-09-21 16:35:20 +02:00
kill.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
kill_test.go refactor: fix lint issues from cleanup changes 2026-05-12 11:31:40 +02:00
loader.go feat(compose): warn on unsupported compose-file attributes 2026-09-09 16:32:04 +02:00
loader_test.go fix mixed assertion libraries in tests 2026-03-31 17:32:51 +02:00
logs.go fix: bound compose cp's fan-out and panic-safe log slot release 2026-10-01 16:02:14 +02:00
logs_test.go fix: bound compose cp's fan-out and panic-safe log slot release 2026-10-01 16:02:14 +02:00
ls.go chore: explicit, unique, greppable names for internal identifiers 2026-08-20 11:17:11 +02:00
ls_test.go
model.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
monitor.go feat(provider): publish-endpoint deploys a network relay for provider services 2026-09-16 17:03:23 +02:00
monitor_test.go fix: detect externally stopped and removed containers in up monitor 2026-09-16 07:54:38 +02:00
observed_state.go fix: address the second round of copilot/docker-agent findings 2026-09-30 12:03:10 +02:00
observed_state_test.go fix: address the second round of copilot/docker-agent findings 2026-09-30 12:03:10 +02:00
pause.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
plan.go feat: reconciliation plan creates pre_start hook runners 2026-09-30 12:03:10 +02:00
plan_test.go tests: cover depends_on chaining and OpRunProvider stringer 2026-06-08 20:14:38 +02:00
plugins.go feat(provider): pull command and get-image protocol for image distribution 2026-10-02 17:35:20 +02:00
plugins_control_test.go feat(compose): dedicated network for the provider relay link 2026-10-02 12:33:26 +02:00
plugins_test.go feat(provider): pull command and get-image protocol for image distribution 2026-10-02 17:35:20 +02:00
port.go PRIVATE_PORT optional for docker compose port 2026-09-11 11:35:18 +02:00
port_test.go fix(port): preserve tie order for dual-stack port publishers 2026-09-14 10:48:03 +02:00
pre_start.go fix: address the second round of copilot/docker-agent findings 2026-09-30 12:03:10 +02:00
pre_start_test.go feat: reconciliation plan creates pre_start hook runners 2026-09-30 12:03:10 +02:00
printer.go
progress.go fix: restore stoppingEvent/stoppedEvent helpers for plugin stop hook 2026-05-18 15:12:39 +02:00
ps.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
ps_test.go refactor: fix lint issues from cleanup changes 2026-05-12 11:31:40 +02:00
publish.go publish, config --images: jobs are scanned and pinned like services 2026-09-21 16:35:20 +02:00
publish_test.go publish, config --images: jobs are scanned and pinned like services 2026-09-21 16:35:20 +02:00
pull.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
pull_test.go build(deps): adopt compose-go jobs and the container-spec layering 2026-09-21 16:35:20 +02:00
push.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
rebuild_scheduler.go fix(watch): interrupt stale rebuilds so watch converges 2026-09-14 10:47:07 +02:00
rebuild_scheduler_test.go fix(watch): interrupt stale rebuilds so watch converges 2026-09-14 10:47:07 +02:00
reconcile.go fix: address the second round of copilot/docker-agent findings 2026-09-30 12:03:10 +02:00
reconcile_start_test.go feat: reconciliation plan creates pre_start hook runners 2026-09-30 12:03:10 +02:00
reconcile_test.go fix: address the second round of copilot/docker-agent findings 2026-09-30 12:03:10 +02:00
relay.go docs(compose): state that a relay-only endpoint also needs an interface-pinned bind 2026-10-02 12:33:26 +02:00
relay_test.go fix(compose): share relay-link network removal and state its isolation precisely 2026-10-02 12:33:26 +02:00
remove.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
restart.go fix: share --parallel budget across down's ops and up's log-attach 2026-10-01 16:02:14 +02:00
restart_test.go fix: close remaining --parallel gaps on down/stop/start 2026-10-01 16:02:14 +02:00
run.go fix(display): harden termWriter lifecycle against review findings on #14119 2026-09-09 16:50:05 +02:00
scale.go api: ScaleOptions carries the replica counts it always pretended to 2026-08-20 10:16:06 +02:00
scale_test.go api: ScaleOptions carries the replica counts it always pretended to 2026-08-20 10:16:06 +02:00
secrets.go chore: inline needless single-use helpers 2026-08-14 22:49:53 +02:00
service_containers.go fix: dry-run resolves service_completed_successfully immediately 2026-09-30 14:47:16 +02:00
service_containers_test.go fix: dry-run resolves service_completed_successfully immediately 2026-09-30 14:47:16 +02:00
shellout.go
start.go fix: close remaining --parallel gaps on down/stop/start 2026-10-01 16:02:14 +02:00
start_test.go fix: close remaining --parallel gaps on down/stop/start 2026-10-01 16:02:14 +02:00
stop.go fix: bound compose cp's fan-out and panic-safe log slot release 2026-10-01 16:02:14 +02:00
stop_test.go fix: close remaining --parallel gaps on down/stop/start 2026-10-01 16:02:14 +02:00
top.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00
unsupported_attributes.go feat(compose): warn on unsupported compose-file attributes 2026-09-09 16:32:04 +02:00
unsupported_attributes_test.go feat(compose): warn on unsupported compose-file attributes 2026-09-09 16:32:04 +02:00
up.go fix: share --parallel budget across down's ops and up's log-attach 2026-10-01 16:02:14 +02:00
up_test.go fix: share --parallel budget across down's ops and up's log-attach 2026-10-01 16:02:14 +02:00
viz.go chore: explicit, unique, greppable names for internal identifiers 2026-08-20 11:17:11 +02:00
viz_test.go build(deps): adopt compose-go jobs and the container-spec layering 2026-09-21 16:35:20 +02:00
volumes.go chore: explicit, unique, greppable names for internal identifiers 2026-08-20 11:17:11 +02:00
volumes_test.go
wait.go fix: close remaining --parallel gaps on down/stop/start 2026-10-01 16:02:14 +02:00
wait_test.go fix: wait rejects dry-run with a clear error 2026-09-30 14:47:16 +02:00
watch.go fix: drop dead x-develop/x-initialSync extension handling 2026-10-01 17:35:05 +02:00
watch_test.go fix: honor --parallel across all bulk engine-call fan-outs 2026-10-01 16:02:14 +02:00