KEP-4639keps/sig-node/4639-oci-volume-source

OCI images as VolumeSource

implementedstablesig-nodelatest v1.36

KEP on GitHub kep.yaml Ask about this KEP

The proposed enhancement adds a new VolumeSource to Kubernetes that supports OCI images. This allows users to package files and share them among containers in a pod without including them in the main image, thereby reducing vulnerabilities and simplifying image creation.

Facts

Authors: @saschagrunert @sallyom
Approvers: @mrunalp @haircommander
Reviewers: @jsafrane @xing-yang @gnufied @mrunalp @haircommander @sergeykanzhelev @aojea @sftim @terrytangyuan @syed @sudo-bmitch @rchincha @mariasalcedo @liu-cong @ktarplee @kfox1111 @humblec @cgwalters @arewm @chaoyihuang @bigvan @samuelkarp @mikebrow @vsoch @smarterclayton
PRR approvers: @deads2kalpha@deads2kbeta@deads2kstable
Tracking issue: #4639(opens GitHub in a new tab) closedcompletedclosed 2026-05-18 07:07 UTCsig/nodesig/storagestage/stablekind/design
Milestones: alpha v1.31beta v1.34stable v1.36
Participating SIGs: sig-storage
Feature gates: ImageVolume
Created / last updated: 2024-05-17 / none

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2024-06-11 08:58 UTC	prr_approval deads2k gave the production readiness approval for KEP-4639 at alpha on 2024-06-11.	@deads2k prr_approver	Document 4639.yaml(opens GitHub in a new tab)
2024-06-21 15:20 UTC	stage_graduation KEP-4639 set milestone.alpha to v1.31 in PR #4642, approved by mrunalp, soltysh; merged by automation (k8s-ci-robot) on 2024-06-21.	@mrunalp approve_command @haircommander lgtm @sergeykanzhelev lgtm @soltysh approve_command @sallyom author @k8s-ci-robot merger	Commit kubernetes/enhancements@0ea6a012caba44df85dd217b7ba751583ebac942(opens GitHub in a new tab) StatusChange milestone.alpha ∅ → v1.31 (2024-05-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4642 KEP-4639: adding OCI VolumeSource(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/2131479263(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/2182956376(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/2182882225(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/2182774728
2024-06-21 15:20 UTC	stage_graduation KEP-4639 set milestone.beta to v1.32 in PR #4642, approved by mrunalp, soltysh; merged by automation (k8s-ci-robot) on 2024-06-21.	@mrunalp approve_command @haircommander lgtm @sergeykanzhelev lgtm @soltysh approve_command @sallyom author @k8s-ci-robot merger	Commit kubernetes/enhancements@0ea6a012caba44df85dd217b7ba751583ebac942(opens GitHub in a new tab) StatusChange milestone.beta ∅ → v1.32 (2024-05-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4642 KEP-4639: adding OCI VolumeSource(opens GitHub in a new tab)
2024-06-21 15:20 UTC	stage_graduation KEP-4639 set milestone.stable to v1.33 in PR #4642, approved by mrunalp, soltysh; merged by automation (k8s-ci-robot) on 2024-06-21.	@mrunalp approve_command @haircommander lgtm @sergeykanzhelev lgtm @soltysh approve_command @sallyom author @k8s-ci-robot merger	Commit kubernetes/enhancements@0ea6a012caba44df85dd217b7ba751583ebac942(opens GitHub in a new tab) StatusChange milestone.stable ∅ → v1.33 (2024-05-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4642 KEP-4639: adding OCI VolumeSource(opens GitHub in a new tab)
2024-06-21 15:20 UTC	stage_graduation KEP-4639 graduated to alpha in PR #4642, approved by mrunalp, soltysh; merged by automation (k8s-ci-robot) on 2024-06-21.	@mrunalp approve_command @haircommander lgtm @sergeykanzhelev lgtm @soltysh approve_command @sallyom author @k8s-ci-robot merger	Commit kubernetes/enhancements@0ea6a012caba44df85dd217b7ba751583ebac942(opens GitHub in a new tab) StatusChange stage ∅ → alpha (2024-05-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4642 KEP-4639: adding OCI VolumeSource(opens GitHub in a new tab)
2024-06-21 15:20 UTC	status_transition KEP-4639 status set to provisional in PR #4642, approved by mrunalp, soltysh; merged by automation (k8s-ci-robot) on 2024-06-21.	@mrunalp approve_command @haircommander lgtm @sergeykanzhelev lgtm @soltysh approve_command @sallyom author @k8s-ci-robot merger	Commit kubernetes/enhancements@0ea6a012caba44df85dd217b7ba751583ebac942(opens GitHub in a new tab) StatusChange status ∅ → provisional (2024-05-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4642 KEP-4639: adding OCI VolumeSource(opens GitHub in a new tab)
2024-06-21 15:20 UTC	status_transition KEP-4639 status changed from provisional to implementable in PR #4642, approved by mrunalp, soltysh; merged by automation (k8s-ci-robot) on 2024-06-21.	@mrunalp approve_command @haircommander lgtm @sergeykanzhelev lgtm @soltysh approve_command @sallyom author @k8s-ci-robot merger	Commit kubernetes/enhancements@83c667005d5c2ad7a7878a689c104dfa59c89d92(opens GitHub in a new tab) StatusChange status provisional → implementable (2024-06-11)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4642 KEP-4639: adding OCI VolumeSource
2025-01-20 13:44 UTC	prr_approval deads2k gave the production readiness approval for KEP-4639 at beta on 2025-01-20.	@deads2k prr_approver	Document 4639.yaml(opens GitHub in a new tab)
2025-02-12 21:08 UTC	milestone_retarget KEP-4639 latest-milestone moved from v1.31 to v1.32 in PR #4897, approved by mikebrow, mrunalp, deads2k; merged by automation (k8s-ci-robot) on 2025-02-12.	@kannon92 lgtm @mrunalp approver @haircommander author @sergeykanzhelev lgtm @deads2k approve_command @mikebrow approver @carlory lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@af29113b56b80e6d3533f7e5cd3ce105bb1b9b93(opens GitHub in a new tab) StatusChange latest_milestone v1.31 → v1.32 (2024-10-02)(opens GitHub in a new tab)
2025-02-12 21:08 UTC	milestone_retarget KEP-4639 latest-milestone moved from v1.32 to v1.33 in PR #4897, approved by mikebrow, mrunalp, deads2k; merged by automation (k8s-ci-robot) on 2025-02-12.	@kannon92 lgtm @mrunalp approver @haircommander author @sergeykanzhelev lgtm @deads2k approve_command @mikebrow approver @carlory lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@e5653bd9453153596c8dae69a4183a50236da3df(opens GitHub in a new tab) StatusChange latest_milestone v1.32 → v1.33 (2025-01-20)(opens GitHub in a new tab)
2025-02-12 21:08 UTC	milestone_retarget KEP-4639 milestone.beta moved from v1.32 to v1.33 in PR #4897, approved by mikebrow, mrunalp, deads2k; merged by automation (k8s-ci-robot) on 2025-02-12.	@kannon92 lgtm @mrunalp approver @haircommander author @sergeykanzhelev lgtm @deads2k approve_command @mikebrow approver @carlory lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@af29113b56b80e6d3533f7e5cd3ce105bb1b9b93(opens GitHub in a new tab) StatusChange milestone.beta v1.32 → v1.33 (2024-10-02)(opens GitHub in a new tab)
2025-02-12 21:08 UTC	milestone_retarget KEP-4639 milestone.stable moved from v1.33 to v1.34 in PR #4897, approved by mikebrow, mrunalp, deads2k; merged by automation (k8s-ci-robot) on 2025-02-12.	@kannon92 lgtm @mrunalp approver @haircommander author @sergeykanzhelev lgtm @deads2k approve_command @mikebrow approver @carlory lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@af29113b56b80e6d3533f7e5cd3ce105bb1b9b93(opens GitHub in a new tab) StatusChange milestone.stable v1.33 → v1.34 (2024-10-02)(opens GitHub in a new tab)
2025-02-12 21:08 UTC	stage_graduation KEP-4639 graduated to beta from alpha in PR #4897, approved by mikebrow, mrunalp, deads2k; merged by automation (k8s-ci-robot) on 2025-02-12.	@kannon92 lgtm @mrunalp approver @haircommander author @sergeykanzhelev lgtm @deads2k approve_command @mikebrow approver @carlory lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@e5653bd9453153596c8dae69a4183a50236da3df(opens GitHub in a new tab) StatusChange stage alpha → beta (2025-01-20)(opens GitHub in a new tab) PullRequest
2025-06-17 20:34 UTC	milestone_retarget KEP-4639 latest-milestone moved from v1.33 to v1.34 in PR #5417, approved by mrunalp; merged by automation (k8s-ci-robot) on 2025-06-17.	@mrunalp approver @mrunalp lgtm @haircommander author @k8s-ci-robot merger	Commit kubernetes/enhancements@25886d391d64c853b918f58b31ff920598fbe8b7(opens GitHub in a new tab) StatusChange latest_milestone v1.33 → v1.34 (2025-06-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5417 4639: bump to 1.34 and document noexec drop(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/2937012292
2025-06-17 20:34 UTC	milestone_retarget KEP-4639 milestone.beta moved from v1.33 to v1.34 in PR #5417, approved by mrunalp; merged by automation (k8s-ci-robot) on 2025-06-17.	@mrunalp approver @mrunalp lgtm @haircommander author @k8s-ci-robot merger	Commit kubernetes/enhancements@25886d391d64c853b918f58b31ff920598fbe8b7(opens GitHub in a new tab) StatusChange milestone.beta v1.33 → v1.34 (2025-06-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5417 4639: bump to 1.34 and document noexec drop(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/2937012292
2025-07-15 08:13 UTC	prr_approval deads2k gave the production readiness approval for KEP-4639 at stable on 2025-07-15.	@deads2k prr_approver	Document 4639.yaml(opens GitHub in a new tab)
2025-10-07 16:41 UTC	milestone_retarget KEP-4639 latest-milestone moved from v1.34 to v1.35 in PR #5450, approved by mrunalp, deads2k, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2025-10-07.	@saschagrunert author @mrunalp approver @haircommander lgtm @sergeykanzhelev approve_command @deads2k approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@810569c56e1dd388eb4956d00dc9e1cc6307a94e(opens GitHub in a new tab) StatusChange latest_milestone v1.34 → v1.35 (2025-07-15)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5450 [KEP-4639] Graduate image volumes to GA
2025-10-07 16:41 UTC	stage_graduation KEP-4639 set milestone.stable to v1.35 in PR #5450, approved by mrunalp, deads2k, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2025-10-07.	@saschagrunert author @mrunalp approver @haircommander lgtm @sergeykanzhelev approve_command @deads2k approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@810569c56e1dd388eb4956d00dc9e1cc6307a94e(opens GitHub in a new tab) StatusChange milestone.stable ∅ → v1.35 (2025-07-15)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5450 [KEP-4639] Graduate image volumes to GA
2025-10-07 16:41 UTC	stage_graduation KEP-4639 graduated to stable from beta in PR #5450, approved by mrunalp, deads2k, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2025-10-07.	@saschagrunert author @mrunalp approver @haircommander lgtm @sergeykanzhelev approve_command @deads2k approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@810569c56e1dd388eb4956d00dc9e1cc6307a94e(opens GitHub in a new tab) StatusChange stage beta → stable (2025-07-15)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5450 [KEP-4639] Graduate image volumes to GA
2026-02-02 18:10 UTC	milestone_retarget KEP-4639 latest-milestone moved from v1.35 to v1.36 in PR #5814, approved by haircommander; merged by automation (k8s-ci-robot) on 2026-02-02.	@kannon92 lgtm @saschagrunert author @haircommander approve_command @haircommander lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@fec00b660f2cd150d4bfaf5947989994c446dd56(opens GitHub in a new tab) StatusChange latest_milestone v1.35 → v1.36 (2026-01-20)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5814 [KEP-4639] Graduate image volume source to GA(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/3836819017
2026-02-02 18:10 UTC	milestone_retarget KEP-4639 milestone.stable moved from v1.35 to v1.36 in PR #5814, approved by haircommander; merged by automation (k8s-ci-robot) on 2026-02-02.	@kannon92 lgtm @saschagrunert author @haircommander approve_command @haircommander lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@fec00b660f2cd150d4bfaf5947989994c446dd56(opens GitHub in a new tab) StatusChange milestone.stable v1.35 → v1.36 (2026-01-20)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5814 [KEP-4639] Graduate image volume source to GA(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/3836819017
2026-10-13 17:24 UTC	milestone_retarget KEP-4639 latest-milestone moved from v1.35 to v1.36 in PR #5960, approved by sergeykanzhelev, haircommander; merged by automation (kubernetes-prow) on 2026-10-13.	@kannon92 lgtm @saschagrunert author @haircommander approve_command @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @kubernetes-prow merger	Commit kubernetes/enhancements@df4d96df028e351b156a631406810c2fd4d89768(opens GitHub in a new tab) StatusChange latest_milestone v1.35 → v1.36 (2026-03-12)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5960 KEP-4639: Mark as implemented with disable-supported false
2026-10-13 17:24 UTC	milestone_retarget KEP-4639 milestone.stable moved from v1.35 to v1.36 in PR #5960, approved by sergeykanzhelev, haircommander; merged by automation (kubernetes-prow) on 2026-10-13.	@kannon92 lgtm @saschagrunert author @haircommander approve_command @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @kubernetes-prow merger	Commit kubernetes/enhancements@df4d96df028e351b156a631406810c2fd4d89768(opens GitHub in a new tab) StatusChange milestone.stable v1.35 → v1.36 (2026-03-12)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5960 KEP-4639: Mark as implemented with disable-supported false
2026-10-13 17:24 UTC	status_transition KEP-4639 status changed from implementable to implemented in PR #5960, approved by sergeykanzhelev, haircommander; merged by automation (kubernetes-prow) on 2026-10-13.	@kannon92 lgtm @saschagrunert author @haircommander approve_command @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @kubernetes-prow merger	Commit kubernetes/enhancements@df4d96df028e351b156a631406810c2fd4d89768(opens GitHub in a new tab) StatusChange status implementable → implemented (2026-03-12)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5960 KEP-4639: Mark as implemented with disable-supported false

Metadata, label and milestone changes, oldest first.Showing 1–10 of 100Rows

Status history
At	Kind	Field	Change	Actor	Evidence
2024-05-16 16:35 UTC	label	needs-sig added	none → needs-sig	@k8s-ci-robot	source(opens GitHub in a new tab)
2024-05-16 16:53 UTC	label	sig/node added	none → sig/node	@k8s-ci-robot	source

Relationships as stored, Person → KEP, from kep.yaml(opens GitHub in a new tab)
Person	Relationship
@saschagrunert GitHub(opens GitHub in a new tab)	—AUTHORED→
@sallyom GitHub(opens GitHub in a new tab)	—AUTHORED→
@jsafrane GitHub(opens GitHub in a new tab)	—REVIEWS→
@xing-yang

How they connect

Shortest paths in the graph between this KEP and its SIG or one of its people, up to four hops.

OCI images as VolumeSource

Facts

How they connect

Impact of change

Keyboard shortcuts

Everywhere

Go to a page

Ask

Search lists

KEP page

Findings table

How they connect

Impact of change

Hop 1

Hop 2

Impact of change

Impact of change

Hop 1

Hop 2