Skip to content

KEP-6228: JSON Pointer extraction for Secret and ConfigMap data - #6229

Draft
aqeelat wants to merge 2 commits into
kubernetes:masterfrom
aqeelat:kep-6228-json-pointer-secret-configmap
Draft

KEP-6228: JSON Pointer extraction for Secret and ConfigMap data#6229
aqeelat wants to merge 2 commits into
kubernetes:masterfrom
aqeelat:kep-6228-json-pointer-secret-configmap

Conversation

@aqeelat

@aqeelat aqeelat commented Jul 10, 2026

Copy link
Copy Markdown

What type of PR is this?

/kind feature

What this PR does / why we need it:

Adds KEP-6228, proposing RFC 6901 JSON Pointer extraction from Secret/ConfigMap data for both environment variables and projected volume items.

Motivation: Applications frequently need only a small portion of a structured Secret or ConfigMap value. Today they must either receive the entire document (exposing unrelated credentials) or operators must duplicate fields into separate derived Secrets. This KEP enables selecting a JSON subtree directly, closing the least-privilege gap.

Key design decisions:

  • Nested jsonPointer: {key, pointer} selector, mutually exclusive with key, so older kubelets see an empty key and fail closed instead of delivering the whole document during version skew.
  • RFC 6901 JSON Pointer only (selection-only, not a transform engine). JSONPath/jq/CEL explicitly rejected.
  • Number-preserving decode (Decoder.UseNumber), exactly one JSON value (reject trailing data).
  • Scalar env var mapping defined: strings decoded, number/bool/null as compact JSON lexical values.
  • Feature gate: SecretConfigMapJSONPointer on kube-apiserver + kubelet.

Tracking issue: #6228

Which issue(s) this PR fixes:

Ref #6228

Special notes for your reviewer:

  • This is a provisional KEP seeking sig-storage sponsorship.
  • One open question remains: non-scalar (object/array) env var targets — reject vs. serialize (see UNRESOLVED block).
  • Participating SIGs: sig-node (kubelet env resolution), sig-auth (least-privilege review).

@kubernetes-prow kubernetes-prow Bot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. kind/feature Categorizes issue or PR as related to a new feature. labels Jul 10, 2026
@kubernetes-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: aqeelat
Once this PR has been reviewed and has the lgtm label, please assign jsafrane for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubernetes-prow kubernetes-prow Bot added the kind/kep Categorizes KEP tracking issues and PRs modifying the KEP directory label Jul 10, 2026
@kubernetes-prow
kubernetes-prow Bot requested review from saad-ali and xing-yang July 10, 2026 23:04
@kubernetes-prow kubernetes-prow Bot added the sig/storage Categorizes an issue or PR as relevant to SIG Storage. label Jul 10, 2026
@linux-foundation-easycla

linux-foundation-easycla Bot commented Jul 10, 2026

Copy link
Copy Markdown

CLA Signed
The committers listed above are authorized under a signed CLA.

  • ✅ login: aqeelat / name: Abdullah Alaqeel (7df5e85)

@kubernetes-prow

Copy link
Copy Markdown
Contributor

Welcome @aqeelat!

It looks like this is your first PR to kubernetes/enhancements 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/enhancements has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

@kubernetes-prow

Copy link
Copy Markdown
Contributor

Hi @aqeelat. Thanks for your PR.

I'm waiting for a kubernetes member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work.

Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@kubernetes-prow kubernetes-prow Bot added needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. cncf-cla: no Indicates the PR's author has not signed the CNCF CLA. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. and removed cncf-cla: no Indicates the PR's author has not signed the CNCF CLA. labels Jul 10, 2026
@aqeelat
aqeelat force-pushed the kep-6228-json-pointer-secret-configmap branch from c6359ec to cba57ad Compare July 10, 2026 23:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. kind/feature Categorizes issue or PR as related to a new feature. kind/kep Categorizes KEP tracking issues and PRs modifying the KEP directory needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. sig/storage Categorizes an issue or PR as relevant to SIG Storage. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant