Skip to content

fix(images): tolerate containers whose image record is gone - #14028

Merged
glours merged 1 commit into
mainfrom
fix-images-missing-image-record
Aug 14, 2026
Merged

fix(images): tolerate containers whose image record is gone#14028
glours merged 1 commit into
mainfrom
fix-images-missing-image-record

Conversation

@ndeloof

@ndeloofndeloof commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

What I did
Make compose images tolerate containers whose image record no longer exists, instead of failing the whole listing with No such image.

A running container can legitimately reference a gone image record: under the containerd image store, up --build with identical content produces a new index digest (provenance attestation churn), the tag moves, and the daemon drops the old dangling index the container was created from; docker rmi -f of a running container's image produces the same state. Images() now degrades such entries to what the container itself knows (image ID, plus repository/tag when the recorded reference is not a raw ID) rather than propagating the NotFound.

Interaction with #14011 — and why this fix shape
Same root family (image-identity digests under the containerd store), but a surface #14011 doesn't touch: the failure reproduces identically with #14011's build. Not recreating the container when only the index digest changes is by design (#13636), an invariant #14011 locks in (TestUpIdempotentContainerdStore) — so a container running a vanished image record is a legitimate, durable state, and "recreate when the record is gone" would reintroduce the rebuild churn #13636/#14011 eliminate. Making the listing resilient is the only fix shape consistent with #14011. Overlap is textual only (both touch images.go); whichever merges second has a trivial rebase.

Covered by a unit test and an e2e test (up then rmi -f of the running container's image — the deterministic way to reach the state). The e2e test only bites under the containerd image store: it needs the CI matrix from #14027 (or #14011's containerd job) to be exercised in CI.

Related issue
Fixes#14014

A running container may reference an image record that no longer
exists: under the containerd image store, `up --build` with identical
content moves the tag to a new index digest (provenance attestation
churn) and the daemon drops the old index the container was created
from — without compose recreating the container, by design (#13636).
`docker rmi -f` of a running container's image produces the same state.
`compose images` used to fail the whole listing on the resulting
NotFound. Degrade to what the container itself knows (image ID, and
repository/tag when the reference is not a raw ID) instead of failing.
Fixes#14014
Signed-off-by: Nicolas De Loof <nicolas.deloof@gmail.com>
@ndeloof
ndeloofforce-pushed the fix-images-missing-image-record branch from 4f8bf6a to 1e7fcfdCompareAugust 13, 2026 11:52

@gloursglours left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM

@glours
glours merged commit df094b0 into mainAug 14, 2026
90 of 91 checks passed
@glours
glours deleted the fix-images-missing-image-record branch August 14, 2026 13:20
tmeijn pushed a commit to tmeijn/dotfiles that referenced this pull request Aug 19, 2026
This MR contains the following updates:
| Package | Update | Change |
|---|---|---|
| [docker/compose](https://github.com/docker/compose) | minor | `v5.4.0` → `v5.5.0` |
MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot).
**Proposed changes to behavior should be submitted there as MRs.**
---
### Release Notes
<details>
<summary>docker/compose (docker/compose)</summary>
### [`v5.5.0`](https://github.com/docker/compose/releases/tag/v5.5.0)
[Compare Source](docker/compose@v5.4.0...v5.5.0)
#### What's Changed
> ℹ️ This release overhauls image digest reconciliation to prevent unnecessary container recreation.\
> Existing containers may be recreated the first time you run `compose up` after upgrading, as image digests are re-evaluated using the new logic.
>
> `compose pull` now honors `pull_policy` refresh windows (`daily`, `weekly`, `every_N`).
##### ✨ Improvements
- New image digest reconciliation process by [@&#8203;glours](https://github.com/glours) & [@&#8203;ndeloof](https://github.com/ndeloof) [#&#8203;14011](docker/compose#14011) [#&#8203;14041](docker/compose#14041)
##### 🐛 Fixes
- Fix(bridge): skip pulling default image references for build-only ser… by [@&#8203;ericwyles](https://github.com/ericwyles) in [#&#8203;14010](docker/compose#14010)
- Fix(watch): stop pruning every dangling image of the project by [@&#8203;glours](https://github.com/glours) in [#&#8203;14012](docker/compose#14012)
- Fix(config): resolve service environment when computing --hash by [@&#8203;glours](https://github.com/glours) in [#&#8203;14002](docker/compose#14002)
- Fix(watch): skip unreadable directories instead of failing the watch by [@&#8203;Endika](https://github.com/Endika) in [#&#8203;13992](docker/compose#13992)
- Fix: ignore one-off container events in up monitor by [@&#8203;brano-osif](https://github.com/brano-osif) in [#&#8203;14038](docker/compose#14038)
- Fix(bridge): validate arguments of bridge subcommands by [@&#8203;glours](https://github.com/glours) in [#&#8203;14003](docker/compose#14003)
- Fix(images): tolerate containers whose image record is gone by [@&#8203;ndeloof](https://github.com/ndeloof) in [#&#8203;14028](docker/compose#14028)
##### 🔧 Internal
- Test: Set stop\_signal to SIGTERM in nginx-based services by [@&#8203;ricardobranco777](https://github.com/ricardobranco777) in [#&#8203;13881](docker/compose#13881)
- Chore: inline needlessly extracted single-use helpers by [@&#8203;ndeloof](https://github.com/ndeloof) in [#&#8203;14048](docker/compose#14048)
- Add ENGINE column driven by label by [@&#8203;nicksieger](https://github.com/nicksieger) in [#&#8203;13959](docker/compose#13959)
##### ⚙️ Dependencies
- Build(deps): bump github.com/moby/moby/client from 0.5.0 to 0.5.1 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;13999](docker/compose#13999)
- Build(deps): bump github/codeql-action/upload-sarif from 4.37.3 to 4.37.4 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;14009](docker/compose#14009)
- Build(deps): bump github/codeql-action/upload-sarif from 4.37.4 to 4.37.5 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;14019](docker/compose#14019)
- Build(deps): bump github.com/moby/buildkit from 0.32.1 to 0.32.2 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;14033](docker/compose#14033)
- Build(deps): bump github.com/docker/buildx from 0.36.0 to 0.36.1 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;14034](docker/compose#14034)
- Build(deps): bump docker/github-builder/.github/workflows/bake.yml from 1.15.0 to 1.16.0 in the docker-actions group by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;14035](docker/compose#14035)
- Build(deps): bump github.com/moby/go-archive from 0.3.2 to 0.3.3 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;14043](docker/compose#14043)
- Build(deps): bump github/codeql-action/upload-sarif from 4.37.5 to 4.37.6 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;14022](docker/compose#14022)
- Build(deps): bump github.com/docker/cli from 29.6.2+incompatible to 29.7.2+incompatible by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;14042](docker/compose#14042)
- Build(deps): bump google.golang.org/grpc from 1.82.1 to 1.83.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;14008](docker/compose#14008)
- Bump golang to version 1.26.6 by [@&#8203;glours](https://github.com/glours) in [#&#8203;14045](docker/compose#14045)
#### New Contributors
- [@&#8203;ericwyles](https://github.com/ericwyles) made their first contribution in [#&#8203;14010](docker/compose#14010)
- [@&#8203;Endika](https://github.com/Endika) made their first contribution in [#&#8203;13992](docker/compose#13992)
- [@&#8203;brano-osif](https://github.com/brano-osif) made their first contribution in [#&#8203;14038](docker/compose#14038)
**Full Changelog**: <docker/compose@v5.4.0...v5.5.0>
</details>
---
### Configuration
📅 **Schedule**: (UTC)
- Branch creation
- At any time (no schedule defined)
- Automerge
- At any time (no schedule defined)
🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.
♻ **Rebasing**: Whenever MR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 **Ignore**: Close this MR and you won't be reminded about this update again.
---
- [ ] <!-- rebase-check -->If you want to rebase/retry this MR, check this box
---
This MR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My4yODguMCIsInVwZGF0ZWRJblZlciI6IjQzLjI4OC4wIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJSZW5vdmF0ZSBCb3QiLCJhdXRvbWF0aW9uOmJvdC1hdXRob3JlZCIsImRlcGVuZGVuY3ktdHlwZTo6bWlub3IiXX0=-->
Sign up for freeto 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.

[BUG] docker compose up --build does not restart containers if image ID changes, making docker compose images fail

2 participants

@ndeloof@glours