Skip to content

Conversation

@ibihim
Copy link
Contributor

@ibihim ibihim commented Dec 16, 2025

Description

Add beta graduation criteria, design principles from SIG API Machinery, and testing requirements

Issue link

#3926

Other comments:

This PR updates KEP-3926 with:

  • Design Principles: Documents the SIG API Machinery consensus on watch cache behavior
    during corrupt object deletion (watch history cannot be preserved, performance
    degradation is acceptable, recovery priorities)

  • Watch Event Propagation and Client Recovery: Explains the deliberate recovery
    sequence when corrupt objects are deleted

  • Alternative Approaches Considered: Documents why shallow object representations
    (DeletedFinalStateUnknown, PartialObjectMetadata, newFunc Object) were
    not pursued

  • Beta Graduation Criteria:

    • Feature enabled by default
    • Dry-run support (#134037)
    • Comprehensive testing requirements including CRD support, bit-flip deserialization,
      and KAS health recovery verification
  • Integration Tests: Updated to reflect both Alpha and Beta testing requirements
    with links to open PRs (#129129, #128726)

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: ibihim
Once this PR has been reviewed and has the lgtm label, please assign micahhausler 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

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Dec 16, 2025
@k8s-ci-robot k8s-ci-robot added kind/kep Categorizes KEP tracking issues and PRs modifying the KEP directory sig/auth Categorizes an issue or PR as relevant to SIG Auth. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Dec 16, 2025
@ibihim ibihim changed the title KEP-3926: Add beta graduation criteria and design principles KEP-3926: Add beta graduation criteria Dec 16, 2025
@ibihim
Copy link
Contributor Author

ibihim commented Dec 17, 2025

/sig api-machinery

@k8s-ci-robot k8s-ci-robot added the sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. label Dec 17, 2025
@enj enj added this to SIG Auth Dec 17, 2025
@enj enj moved this to Needs Triage in SIG Auth Dec 17, 2025
@ibihim ibihim force-pushed the ibihim/2025-12-16_kep-3926-update-beta-requirements branch from 9ebd69d to 22825eb Compare December 19, 2025 12:55
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. kind/kep Categorizes KEP tracking issues and PRs modifying the KEP directory sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. sig/auth Categorizes an issue or PR as relevant to SIG Auth. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

Status: Needs Triage

Development

Successfully merging this pull request may close these issues.

2 participants