Skip to content

Add warning and documentation for crictl rmi multi-tag behavior#1974

Merged
k8s-ci-robot merged 1 commit into
kubernetes-sigs:masterfrom
saschagrunert:fix-1911-rmi-multi-tag-warning
Jan 13, 2026
Merged

Add warning and documentation for crictl rmi multi-tag behavior#1974
k8s-ci-robot merged 1 commit into
kubernetes-sigs:masterfrom
saschagrunert:fix-1911-rmi-multi-tag-warning

Conversation

@saschagrunert

@saschagrunert saschagrunert commented Jan 13, 2026

Copy link
Copy Markdown
Member

What type of PR is this?

/kind documentation

What this PR does / why we need it:

The CRI API's RemoveImage call removes the entire image including all tags, not just the specified tag. This differs from docker, nerdctl, and ctr which only remove the specified tag.

Which issue(s) this PR fixes:

Fixes #1911

Special notes for your reviewer:

None

Does this PR introduce a user-facing change?

crictl rmi now warns when removing multi-tagged images, as the CRI API removes all tags (not just the specified one). Documentation added with workarounds using runtime-native tools.

@k8s-ci-robot k8s-ci-robot added the kind/documentation Categorizes issue or PR as related to documentation. label Jan 13, 2026
@k8s-ci-robot
k8s-ci-robot requested a review from feiskyer January 13, 2026 10:13
@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jan 13, 2026
@k8s-ci-robot
k8s-ci-robot requested a review from klueska January 13, 2026 10:13
@k8s-ci-robot k8s-ci-robot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Jan 13, 2026
@saschagrunert
saschagrunert force-pushed the fix-1911-rmi-multi-tag-warning branch from 0d6f1a0 to dc946ad Compare January 13, 2026 10:13
The CRI API's RemoveImage call removes the entire image including
all tags, not just the specified tag. This differs from docker, nerdctl,
and ctr which only remove the specified tag.

Signed-off-by: Sascha Grunert <[email protected]>
@saschagrunert
saschagrunert force-pushed the fix-1911-rmi-multi-tag-warning branch from dc946ad to be5cd06 Compare January 13, 2026 10:15
@k8s-ci-robot k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Jan 13, 2026
@saschagrunert

Copy link
Copy Markdown
Member Author

@kubernetes-sigs/cri-tools-maintainers PTAL

@SergeyKanzhelev SergeyKanzhelev left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jan 13, 2026
@k8s-ci-robot

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: saschagrunert, SergeyKanzhelev

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot
k8s-ci-robot merged commit fc85e2f into kubernetes-sigs:master Jan 13, 2026
30 of 31 checks passed
@saschagrunert
saschagrunert deleted the fix-1911-rmi-multi-tag-warning branch January 13, 2026 18:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. kind/documentation Categorizes issue or PR as related to documentation. lgtm "Looks good to me", indicates that a PR is ready to be merged. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

crictl rmi removes all images with the same image id instead of the specified tag

3 participants