You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: keps/sig-node/3288-separate-stdout-from-stderr/README.md
+19-16Lines changed: 19 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -131,20 +131,20 @@ checklist items _must_ be updated for the enhancement to be released.
131
131
132
132
Items marked with (R) are required *prior to targeting to a milestone / release*.
133
133
134
-
-[] (R) Enhancement issue in release milestone, which links to KEP dir in [kubernetes/enhancements] (not the initial KEP PR)
135
-
-[] (R) KEP approvers have approved the KEP status as `implementable`
136
-
-[] (R) Design details are appropriately documented
134
+
-[x] (R) Enhancement issue in release milestone, which links to KEP dir in [kubernetes/enhancements] (not the initial KEP PR)
135
+
-[x] (R) KEP approvers have approved the KEP status as `implementable`
136
+
-[x] (R) Design details are appropriately documented
137
137
-[ ] (R) Test plan is in place, giving consideration to SIG Architecture and SIG Testing input (including test refactors)
138
138
-[ ] e2e Tests for all Beta API Operations (endpoints)
139
-
-[ ] (R) Ensure GA e2e tests for meet requirements for [Conformance Tests](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/conformance-tests.md)
139
+
-[ ] (R) Ensure GA e2e tests for meet requirements for [Conformance Tests](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/conformance-tests.md)
140
140
-[ ] (R) Minimum Two Week Window for GA e2e tests to prove flake free
141
141
-[ ] (R) Graduation criteria is in place
142
-
-[ ] (R) [all GA Endpoints](https://github.com/kubernetes/community/pull/1806) must be hit by [Conformance Tests](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/conformance-tests.md)
142
+
-[ ] (R) [all GA Endpoints](https://github.com/kubernetes/community/pull/1806) must be hit by [Conformance Tests](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/conformance-tests.md)
143
143
-[ ] (R) Production readiness review completed
144
144
-[ ] (R) Production readiness review approved
145
-
-[] "Implementation History" section is up-to-date for milestone
145
+
-[x] "Implementation History" section is up-to-date for milestone
146
146
-[ ] User-facing documentation has been created in [kubernetes/website], for publication to [kubernetes.io]
147
-
-[] Supporting documentation—e.g., additional design documents, links to mailing list discussions/SIG meetings, relevant PRs/issues, release notes
147
+
-[x] Supporting documentation—e.g., additional design documents, links to mailing list discussions/SIG meetings, relevant PRs/issues, release notes
148
148
149
149
<!--
150
150
**Note:** This checklist is iterative and should be reviewed and updated every time this enhancement is being considered for a milestone.
@@ -157,7 +157,7 @@ Items marked with (R) are required *prior to targeting to a milestone / release*
157
157
158
158
## Summary
159
159
160
-
Currently, kubelet actually [has the potential](https://github.com/kubernetes/kubernetes/blob/69cabe778bccfc5f4fa9b6788c9def005e7d959d/pkg/kubelet/kuberuntime/logs/logs.go#L281)
160
+
Currently, kubelet actually [has the potential](https://github.com/kubernetes/kubernetes/blob/69cabe778bccfc5f4fa9b6788c9def005e7d959d/pkg/kubelet/kuberuntime/logs/logs.go#L281)
161
161
to return certain log stream of a container, but this ability is not exposed to the user.
162
162
This proposal enables users to view certain log stream of a container,
163
163
and aims to extend kubelet and api-server with the ability to return certain
@@ -167,8 +167,8 @@ container log stream.
167
167
168
168
Users could fetch logs of the container, but now kubelet always returns
169
169
combined stdout and stderr logs, which is not convenient for users who only want to
170
-
view certain log stream.
171
-
Meanwhile, [many users](https://github.com/kubernetes/kubernetes/issues/28167) have been interested in the ability to
170
+
view certain log stream.
171
+
Meanwhile, [many users](https://github.com/kubernetes/kubernetes/issues/28167) have been interested in the ability to
172
172
retrieve certain log stream of a container, so it is great to implement this long-wanted feature.
173
173
174
174
### Goals
@@ -235,7 +235,7 @@ type PodLogOptions struct {
235
235
...
236
236
// If set to "stdout" or "stderr", return the given log stream of the container.
237
237
// If set to "all" or not set, the combined stdout and stderr from the container is returned.
238
-
// Available values are: "stdout", "stderr", "all", "" (empty string).
238
+
// Available values are: "stdout", "stderr", "all", "" (empty string).
239
239
// +optional
240
240
StreamLogStreamType
241
241
}
@@ -333,7 +333,7 @@ function to make it be able to filter out the unwanted stream.
333
333
334
334
### Changes of kubectl
335
335
336
-
Add a new flag `--stream`, whose value defaults to "all", to `kubectl logs`, hence users are able to specify the
336
+
Add a new flag `--stream`, whose value defaults to "all", to `kubectl logs`, hence users are able to specify the
337
337
log stream to return.
338
338
339
339
### Test Plan
@@ -669,10 +669,10 @@ Recall that end users cannot usually observe component logs or access metrics.
669
669
-->
670
670
671
671
-[ ] Events
672
-
- Event Reason:
672
+
- Event Reason:
673
673
-[ ] API .status
674
-
- Condition name:
675
-
- Other field:
674
+
- Condition name:
675
+
- Other field:
676
676
-[ ] Other (treat as last resort)
677
677
- Details:
678
678
@@ -792,6 +792,9 @@ Major milestones might include:
792
792
- the version of Kubernetes where the KEP graduated to general availability
793
793
- when the KEP was retired or superseded
794
794
-->
795
+
2022-05-01: KEP opened
796
+
797
+
2022-06-08: KEP marked implementable
795
798
796
799
## Drawbacks
797
800
@@ -806,7 +809,7 @@ What other approaches did you consider, and why did you rule them out? These do
806
809
not need to be as detailed as the proposal, but should include enough
807
810
information to express the idea and why it was not acceptable.
808
811
-->
809
-
Instead of filtering log stream on the server side, we could return a stream of CRI-format logs,
812
+
Instead of filtering log stream on the server side, we could return a stream of CRI-format logs,
810
813
something like the following:
811
814
```
812
815
2016-10-06T00:17:09.669794202Z stdout P log content 1
0 commit comments