Skip to content

[Tracking] Promote CEL policies to v1

Problem Statement

The migration involves moving all new policy types from alpha to beta versions to provide better stability and API guarantees. This includes both policies.kyverno.io APIs and the GlobalContextEntry API.

APIs to Migrate

1. policies.kyverno.io APIs (v1alpha1 → v1beta1 → v1)

D = deprecated S = stored X = not served A = available

policies.kyverno.io

  • Cluster-wide Policies CRDs: ValidatingPolicy, MutatingPolicy, GeneratingPolicy, DeletingPolicy, ImageValidatingPolicy
version 1.15 1.16 1.17 1.18 1.19
v1alpha1 S S D X
v1beta1 A S D X
v1 A S S
  • Namespaced Policies CRDs: NamespacedValidatingPolicy(1.16+), NamespacedDeletingPolicy (1.16+), NamespacedImageValidatingPolicy (1.16+), NamespacedGeneratingPolicy (1.17+), NamespacedMutatingPolicy (1.17+)
version 1.15 1.16 1.17 1.18 1.19
v1beta1 - A S D X
v1 - - A S S
  • CRD: PolicyException
version 1.15 1.16 1.17 1.18 1.19
v2alpha1 S S D X
v2beta1 A S D X
v2 A S S

kyverno.io

  • CRD: GlobalContextEntry
version 1.16 1.17 1.18 1.19
v1alpha1 S D X
v1beta1 A S D X
v1 A S S

Version Alignment Strategy

CEL Libraries Alignment

  • start with 1.0.0 (major, minor, patch)
  • changed signatures, breaking changes, bump major
  • new functions, bump minor
  • fixed functionalities, bump patch

OpenReports Version Alignment

Currently on alpha version, releases https://github.com/openreports/reports-api/releases.

Solution Description

See above.

Alternatives

No response

Additional Context

No response

Slack discussion

No response

Research

  • I have read and followed the documentation AND the troubleshooting guide.
  • I have searched other issues in this repository and mine is not recorded.