Skip to content

Commit

Permalink
Merge pull request #3692 from aravindhp/KEP-2258-1.27
Browse files Browse the repository at this point in the history
KEP 2258: Update milestones to 1.27
  • Loading branch information
k8s-ci-robot committed Dec 13, 2022
2 parents 306a505 + 59496a9 commit 4a1b8e0
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 12 deletions.
18 changes: 9 additions & 9 deletions keps/sig-windows/2258-node-service-log-viewer/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -195,10 +195,10 @@ configured. Here are some examples:
The `/var/log/` endpoint is enabled using the `enableSystemLogHandler` kubelet
configuration options. To gain access to this new feature this option needs to
be enabled. In addition when introducing this feature it will be hidden behind a
`NodeLogViewer` feature gate in the kubelet that needs to be explicitly enabled. So
`NodeLogQuery` feature gate in the kubelet that needs to be explicitly enabled. So
you need to enable both options to get access to this new feature and disabling
`enableSystemLogHandler` will disable the new feature irrespective of the
`NodeLogViewer` feature gate.
`NodeLogQuery` feature gate.

A reference implementation of this feature is available
[here](https://github.com/kubernetes/kubernetes/pull/96120).
Expand Down Expand Up @@ -240,7 +240,6 @@ Examples:
Options:
-g, --grep='': Filter log entries by the provided regex pattern. Only applies to node journal logs.
-o, --output='': Display journal logs in an alternate format (short, cat, json, short-unix). Only applies to node journal logs.
--raw=false: Perform no transformation of the returned data.
--role='': Set a label selector by node role.
-l, --selector='': Selector (label query) to filter on.
Expand Down Expand Up @@ -302,13 +301,13 @@ e2e tests. For Windows a new set of tests will be added to the existing

### Graduation Criteria

The plan is to introduce the feature as alpha in the v1.26 time frame behind the
`NodeLogViewer` kubelet feature gate and using the `kubectl alpha node-logs`
The plan is to introduce the feature as alpha in the v1.27 time frame behind the
`NodeLogQuery` kubelet feature gate and using the `kubectl alpha node-logs`
sub-command.

#### Alpha -> Beta Graduation

The plan is to graduate the feature to beta in the v1.27 time frame. At that
The plan is to graduate the feature to beta in the v1.28 time frame. At that
point we would have collected feedback from cluster administrators and
developers who have enabled the feature. Based on this feedback and issues
opened we should consider adding a kubelet side throttle for the viewing the
Expand All @@ -320,7 +319,7 @@ The kubectl implementation will move from `kubectl alpha node-logs` to
`kubectl node-logs`.
#### Beta -> GA Graduation

The plan is to graduate the feature to GA in the v1.28 time frame at which point
The plan is to graduate the feature to GA in the v1.29 time frame at which point
any major issues should have been surfaced and addressed during the alpha and
beta phases.

Expand All @@ -338,13 +337,13 @@ viewer, the result should be "feature not supported".

* **How can this feature be enabled / disabled in a live cluster?**
- [x] Feature gate
- Feature gate name: NodeLogViewer
- Feature gate name: NodeLogQuery
- Components depending on the feature gate: kubelet

* **Does enabling the feature change any default behavior?** No

* **Can the feature be disabled once it has been enabled (i.e. can we roll back
the enablement)?** Yes. It can be disabled by disabling the `NodeLogViewer` feature
the enablement)?** Yes. It can be disabled by disabling the `NodeLogQuery` feature
gate in the kubelet.

* **What happens if we reenable the feature if it was previously rolled back?**
Expand Down Expand Up @@ -408,6 +407,7 @@ resource usage (CPU, RAM, disk, IO, ...) in any components?**

- Created on Jan 14, 2021
- Updated on May 5th, 2021
- Updated on Dec 13th, 2022

## Drawbacks

Expand Down
6 changes: 3 additions & 3 deletions keps/sig-windows/2258-node-service-log-viewer/kep.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -23,16 +23,16 @@ stage: alpha
# The most recent milestone for which work toward delivery of this KEP has been
# done. This can be the current (upcoming) milestone, if it is being actively
# worked on.
latest-milestone: "v1.26"
latest-milestone: "v1.27"

# The milestone at which this feature was, or is targeted to be, at each stage.
milestone:
alpha: "v1.26"
alpha: "v1.27"

# The following PRR answers are required at alpha release
# List the feature gate name and the components for which it must be enabled
feature-gates:
- name: NodeLogViewer
- name: NodeLogQuery
components:
- kubelet
disable-supported: true
Expand Down

0 comments on commit 4a1b8e0

Please sign in to comment.