Repository navigation
Conversation
Codecov Report❌ Patch coverage is 📢 Thoughts on this report? Let us know! |
7c99af5 to
a4adc90
Compare
docker-agent
left a comment
There was a problem hiding this comment.
Assessment: 🟢 APPROVE
| s.hub = hub | ||
| } | ||
|
|
||
| ctx, cancel := context.WithTimeout(context.Background(), s.timeout) |
There was a problem hiding this comment.
[low] Shared 5-second context split across two sequential RPC calls
fetch() creates a single context.WithTimeout(context.Background(), s.timeout) (5 s) and passes it to both GetDefaultSession and — when userSession.Claims.Username is empty — a subsequent GetDefaultProfile call. If the first call consumes the majority of the budget the second call gets only the remainder and may time out immediately, causing a spurious failure and a 1-minute retry backoff.
In practice the benchmarks show lookups take 2–15 ms (far below 5 s), so both calls complete well within the budget under normal conditions. The consequence of a timeout is also graceful: auth() sets retryAt and falls back to the CLI's own credentials. Consider using two separate timeouts (one per call) to make the intent explicit and to avoid a theoretical starvation when the engine is under load.
| Confidence | Score |
|---|---|
| 🟡 moderate | 62/100 |
|
|
||
| userSession, err := s.hub.GetDefaultSession(ctx) | ||
| if err != nil { | ||
| return types.AuthConfig{}, time.Time{}, err |
There was a problem hiding this comment.
[low] Stale s.hub client is never reset after a connection failure
s.hub is set once in fetch() and never cleared when GetDefaultSession returns an error. After the 1-minute retryAt window elapses, fetch() skips the if s.hub == nil { s.connect() } branch and retries on the same client object.
For the common case of a Docker Desktop restart at the same socket path, the existing HTTP/1.1 keep-alive transport will auto-redial and the retry succeeds. However, if the socket path were to change (e.g., Docker Desktop is reinstalled at a different path), the stale transport continues dialling the old path and retries will keep failing until the process restarts.
Resetting s.hub = nil on the error path inside auth() (or inside fetch() when a *seclient.ConnectError is returned) would guarantee a clean reconnect on every retry:
| return types.AuthConfig{}, time.Time{}, err | |
| userSession, err := s.hub.GetDefaultSession(ctx) | |
| if err != nil { | |
| s.hub = nil | |
| return types.AuthConfig{}, time.Time{}, err | |
| } |
| Confidence | Score |
|---|---|
| 🟡 moderate | 62/100 |
| for _, item := range resp.Msg.GetEnvelopes() { | ||
| id, err := secrets.ParseID(item.GetId()) | ||
| if err != nil { | ||
| continue |
There was a problem hiding this comment.
[low] ParseID errors are silently swallowed in resolverClient.GetSecrets
When the server returns envelopes whose IDs cannot be parsed by secrets.ParseID, the loop continues without logging or propagating the error. If every envelope in the response has an unparseable ID, the function returns (nil, nil) — an empty slice with no error — instead of surfacing the failure.
Callers in desktopauth treat an empty/nil result as "no session found" and fall through to the next credential source, hiding a potential protocol mismatch between the client library and the secrets engine.
In normal operation the server serializes IDs that were previously validated, so this path should not trigger. However, a format change or server/client version mismatch would silently degrade rather than report an actionable error. Consider logging at debug level when an ID cannot be parsed, or returning a partial-result error.
| Confidence | Score |
|---|---|
| 🟡 moderate | 62/100 |
Add the Docker secrets engine client, used to read the Docker Desktop session for Docker Hub. It brings in github.com/docker/secrets-engine/secrets v1.0.0. The client module requires go1.26.11, which raises the go directive in vendor.mod from 1.26.10. Signed-off-by: Alano Terblanche <18033717+Benehiko@users.noreply.github.com>
Add an auth provider that reads the Docker Desktop session from the secrets engine and returns it as the credentials for Docker Hub (docker.io) and Docker Hardened Images (dhi.io), keeping the production and staging sessions apart. The session is cached until it expires. When no session is usable (no socket, nothing listening, signed out, or no answer within 5 seconds), the provider falls back to the given provider and retries after a minute. Add registry.DefaultRegistryHost, so the Docker Hub registry host is defined once. Signed-off-by: Alano Terblanche <18033717+Benehiko@users.noreply.github.com>
When Docker Desktop is running and signed in, send its Docker Hub session as the registry credentials for Docker Hub (docker.io) and Docker Hardened Images (dhi.io) when pulling or pushing images through the daemon: docker pull, push, run, create, plugin install and push, service create and update, and stack deploy. The lookup goes through the new internal/registryauth package. Credentials in DOCKER_AUTH_CONFIG take precedence for the registries they cover. Without a usable Docker Desktop session, the CLI uses its credential store, credential helpers, and configuration file as before. docker login and stored credentials are not changed. FakeCli returns its configuration file as the auth provider, so tests never reach the Docker Desktop of the machine they run on. Signed-off-by: Alano Terblanche <18033717+Benehiko@users.noreply.github.com>
a4adc90 to
5e1a655
Compare
Warning
Work in progress. This is a draft to share the approach and the measurements. See Open items for what is left.
Note
This PR was created with alki, an AI coding agent, running Claude Opus 5.5: the code, the tests, the benchmarks, and this description.
Summary
When Docker Desktop is running and signed in, use its Docker Hub session as the first source of registry credentials for Docker Hub and Docker Hardened Images, as docker/compose does.
A new
internal/secretsenginepackage reads the default Docker Hub session from the Docker Desktop secrets engine, throughgithub.com/docker/secrets-engine/client.The commands that pull and push call the new
internal/registryauth.EncodedAuth, which asks for credentials in this order:DOCKER_AUTH_CONFIG, for the registries it defines.This covers
docker pull,push,run,create,plugin installandpush,service createandupdate, andstack deploy.command.RetrieveAuthTokenFromImageis exported and imported by other projects, so it is unchanged and still reads only the configuration file.Each
DockerCliowns its Docker Desktop sessions throughDockerCli.RegistryAuthProvider, created on first use. There is no package-level state. Acommand.Clithat does not implementRegistryAuthProvideruses only its configuration file and never contacts Docker Desktop.Registries:
docker.io,index.docker.io, andregistry-1.docker.iouse the Docker Hub session.dhi.iouses the Docker Hub session, withServerAddressset todhi.io.registry-1-stage.docker.iouses the staging session.docker login,docker logout, and stored credentials are not changed. A Docker Desktop token is never written to the credential store.Falling back to the CLI's own credentials:
os.Lstat, no client is created.On macOS, Docker Desktop does not prompt Docker-signed binaries. Binaries that are not signed by Docker, such as local builds and test binaries, would prompt.
test.FakeClireturns its configuration file as the auth provider, so that unit tests never reach the Docker Desktop of the machine they run on.Tests:
testing/synctestinstead of a fake clock.DOCKER_AUTH_CONFIG, whichconfigfilereads from the process environment.Commits:
vendor: github.com/docker/secrets-engine/client v1.0.0: the client module requires go1.26.11, which raises the go directive invendor.modfrom 1.26.10.internal/secretsengine: read the Docker Hub session from Docker Desktopcli/command: use the Docker Desktop session for Docker HubLatency
Extra time per
docker pullof a Docker Hub ordhi.ioimage (p50, this branch minusmaster), and the cost of one lookup against the engine:DOCKER_AUTH_CONFIGset for Docker Hubdocker --version(p50, before → after)¹
ghcr.io, which never contacts the engine, differs by +0.58 to +0.79 ms in the same runs.² A lookup makes two requests to the engine. The VMs oversleep: a fake engine that sleeps 10 ms per request takes 44.7 ms per lookup on Linux and 62.0 ms on Windows, against 22.8 ms on macOS.
³ The cost is in the engine, not the CLI. On Linux the engine verifies the binary of every connecting process, and the cost grows with the size of that binary. Signed out costs the same as signed in.
Every case sent the expected credentials: the Docker Desktop session for Docker Hub and
dhi.io,DOCKER_AUTH_CONFIGover Docker Desktop, and the configuration file everywhere else.How this was measured:
masterand this branch were built withCGO_ENABLED=0.127.0.0.1recorded theX-Registry-Authof every pull.HOME, the Docker config, and the Docker Desktop socket path were isolated in a temporary directory.BenchmarkExternalEngine, against the same engine. It was used for these measurements and is not part of this PR.github.com/docker/secrets-engine/clientv0.2.2, before the package was renamed frominternal/desktopauthtointernal/secretsengineand before the lookup moved tointernal/registryauth. They have not been repeated since. Client v1.0.0 replacesconnectwith its own RPC client, so these numbers may have changed.Binary size
dockerbuilt frommasterand from this branch with-tags grpcnotraceandCGO_ENABLED=0, both with Go 1.26.11; stripped means-ldflags "-s -w". 1 MB = 1,000,000 bytes.github.com/docker/secrets-engine/clientv1.0.0 andgithub.com/docker/secrets-engine/secretsv1.0.0. Protobuf andnet/httpwere already linked.client/dockerhub(0.023 MB) and the plugin management messages inclient/api/plugins/v1(0.013 MB), which the CLI never calls.internal/secretsengineitself is 0.005 MB andinternal/registryauth0.001 MB.connectrpc.com/connect,github.com/docker/secrets-engine/x, andgolang.org/x/mod, the increase was +1.27 MB unstripped and +0.85 MB stripped on linux/arm64. v1.0.0 drops all three, which reduces the increase by about 70%.masterof that time.-buildmode=pieon Linux and macOS, which these builds did not.Open items
.golangci.yml, and the GitHub workflows, which client v1.0.0 requires.docker pull).wsarecv: The I/O operation has been abortedand fell back to the CLI's credentials. This was not reproduced in 10 further runs, and nodocker pullfailed.DockerCli.RegistryAuthProvidermay stay an exported method onDockerCli. Its return type is internal, so other projects can call it but cannot name the type.Release notes (optional)