Skip to content
KEP Brain

KEP-277keps/sig-node/277-ephemeral-containers

Ephemeral Containers

implementedstablesig-nodelatest v1.25
This proposal adds to Kubernetes a mechanism to run a container with a temporary duration that executes within namespaces of an existing pod. Ephemeral Containers are initiated by a user and intended to observe the state of other pods and containers for troubleshooting and debugging purposes. Ephemeral Containers unlock the possibility for a new command, ku… Full summary

This proposal adds to Kubernetes a mechanism to run a container with a temporary duration that executes within namespaces of an existing pod. Ephemeral Containers are initiated by a user and intended to observe the state of other pods and containers for troubleshooting and debugging purposes. Ephemeral Containers unlock the possibility for a new command, kubectl debug, which parallels the existing, kubectl exec. Whereas kubectl exec runs a process in a container, kubectl debug could run a container in a pod. For example, the following command would attach to a newly created container in a pod: kubectl debug -it --image=debian target-pod -- bash

Facts

Authors
@verb
Reviewers
@dchen1107
PRR approvers
@johnbelamaricalpha@johnbelamaricbeta@johnbelamaricstable
Tracking issue
#277(opens GitHub in a new tab) closedcompletedclosed 2023-01-29 01:40 UTCmilestone v1.25sig/nodesig/clistage/stablekind/featurekind/api-change
Milestones
alpha v1.16beta v1.23stable v1.25
Participating SIGs
sig-auth
Feature gates
EphemeralContainers
Created / last updated
2019-02-12 / none
Loading decisions and status history

Keyboard shortcuts

Everywhere

?
Show or hide this list
/
Focus the question box on Ask, otherwise the page search
Ctrl Kor⌘ K
Focus the KEP search in the top bar
t
Switch the theme (system, light, dark)
Esc
Close a dialog, a search list or a menu

Go to a page

Press g, then the letter

g h
Home
g a
Ask
g e
Explore
g u
Audit
g m
Memory
g b
About

Ask

Enter
Send the question
Shift Enter
New line in the question
Esc
Cancel the running question

Search lists

KEP search and Explore search

↓or↑
Move through the results
HomeorEnd
First or last result (Explore)
Enter
Open the highlighted result, or KEP-n when the query is a number

KEP page

o
Open the KEP on GitHub
y
Open kep.yaml on GitHub
a
Ask about this KEP
←or→
Previous or next tab, when a tab is focused

Findings table

With a finding row focused (Tab into the table or click a row)

jork
Next or previous finding
EnterorSpace
Expand or collapse the finding
o
Open the finding's KEP page
d
Draft the fix as an issue text (nothing is posted)
]or[
Next or previous page of findings

Shortcuts pause while you type in a field. Press ? or Esc to close.