github/kubernetes
1
0
Fork 0
mirror of https://github.com/k3s-io/kubernetes.git synced 2026-07-17 20:00:07 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #135710 from SergeyKanzhelev/removeImageClarification

Browse Source 
clarify RemoveImage CRI API call
This commit is contained in:
Kubernetes Prow Robot
2025-12-20 15:48:38 -08:00
committed by GitHub
parent 99e77f8c46 76af576cc7
commit 6ec02c3061
2 changed files with 24 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
staging/src/k8s.io/cri-api/pkg/apis/runtime/v1/api.proto
View File

@@ -152,8 +152,16 @@ service ImageService {
// RemoveImage removes the image.
// This call is idempotent, and must not return an error if the image has
// already been removed.
// Note that if the image is referenced by multiple tags (even across different repositories
// if they resolve to the same image digest), removing the image by a single tag
// will remove all of its tags. For example, if `repo/image:v1` and `another_repo/image:latest`
// point to the same image, removing `repo/image:v1` will also remove `another_repo/image:latest`.
// The next call to ListImages, ImageStatus, ImageFsInfo will not return this image.
// The resources (e.g. disk space) may be cleaned asynchronously
// and not guaranteed to be cleaned up by the time this method returns.
rpc RemoveImage(RemoveImageRequest) returns (RemoveImageResponse) {}
// ImageFSInfo returns information of the filesystem that is used to store images.
// Usage information may include images that were removed, but are still being cleaned up.
rpc ImageFsInfo(ImageFsInfoRequest) returns (ImageFsInfoResponse) {}
}

16
staging/src/k8s.io/cri-api/pkg/apis/runtime/v1/api_grpc.pb.go
View File

@@ -1432,8 +1432,16 @@ type ImageServiceClient interface {
// RemoveImage removes the image.
// This call is idempotent, and must not return an error if the image has
// already been removed.
// Note that if the image is referenced by multiple tags (even across different repositories
// if they resolve to the same image digest), removing the image by a single tag
// will remove all of its tags. For example, if `repo/image:v1` and `another_repo/image:latest`
// point to the same image, removing `repo/image:v1` will also remove `another_repo/image:latest`.
// The next call to ListImages, ImageStatus, ImageFsInfo will not return this image.
// The resources (e.g. disk space) may be cleaned asynchronously
// and not guaranteed to be cleaned up by the time this method returns.
RemoveImage(ctx context.Context, in *RemoveImageRequest, opts ...grpc.CallOption) (*RemoveImageResponse, error)
// ImageFSInfo returns information of the filesystem that is used to store images.
// Usage information may include images that were removed, but are still being cleaned up.
ImageFsInfo(ctx context.Context, in *ImageFsInfoRequest, opts ...grpc.CallOption) (*ImageFsInfoResponse, error)
}
@@ -1512,8 +1520,16 @@ type ImageServiceServer interface {
// RemoveImage removes the image.
// This call is idempotent, and must not return an error if the image has
// already been removed.
// Note that if the image is referenced by multiple tags (even across different repositories
// if they resolve to the same image digest), removing the image by a single tag
// will remove all of its tags. For example, if `repo/image:v1` and `another_repo/image:latest`
// point to the same image, removing `repo/image:v1` will also remove `another_repo/image:latest`.
// The next call to ListImages, ImageStatus, ImageFsInfo will not return this image.
// The resources (e.g. disk space) may be cleaned asynchronously
// and not guaranteed to be cleaned up by the time this method returns.
RemoveImage(context.Context, *RemoveImageRequest) (*RemoveImageResponse, error)
// ImageFSInfo returns information of the filesystem that is used to store images.
// Usage information may include images that were removed, but are still being cleaned up.
ImageFsInfo(context.Context, *ImageFsInfoRequest) (*ImageFsInfoResponse, error)
mustEmbedUnimplementedImageServiceServer()
}