Skip to content

[APIP] Update Operator helm-chart#2749

Draft
DDH13 wants to merge 11 commits into
wso2:mainfrom
DDH13:main.helm-1.2
Draft

[APIP] Update Operator helm-chart#2749
DDH13 wants to merge 11 commits into
wso2:mainfrom
DDH13:main.helm-1.2

Conversation

@DDH13

@DDH13 DDH13 commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Related to #2765

This pull request introduces the new v1 API group for the gateway-operator, adding first-class CRD types for API Gateway, API Key, and Certificate resources. It also establishes common type definitions, conversion hub methods, and updates the project configuration to register the v1 resources. These changes lay the groundwork for stable CRD APIs, improving extensibility and future compatibility.

New v1 API Resource Definitions:

  • Added APIGateway, ApiKey, and Certificate types and their associated spec/status fields in the new kubernetes/gateway-operator/api/v1 package, providing CRD schemas for API management resources. [1] [2] [3]

Common Types and Utilities:

  • Introduced common type definitions such as SecretValueSource and ResourceStatus in common_types.go for consistent handling of secrets and resource status across CRDs.
  • Implemented the conversion hub marker methods for all v1 root types in conversion.go, enabling CRD version conversion via webhooks.
  • Added groupversion_info.go to register the new v1 API group and scheme.

Project Configuration:

  • Updated kubernetes/gateway-operator/PROJECT to register APIGateway and RestApi resources for both v1 and v1alpha1 versions, ensuring the new types are recognized by the operator. [1] [2]

@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: fd668fa3-b271-49a6-86e5-c2f127da15b9

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@DDH13 DDH13 changed the title [APIP] Add Subscription CRDs with webhook support and Helm chart updates [APIP] Add Subscription CRDs and promote gateway-operator CRDs to v1 Jul 20, 2026
@DDH13 DDH13 changed the title [APIP] Add Subscription CRDs and promote gateway-operator CRDs to v1 [APIP] Update Operator helm-chart Jul 20, 2026
DDH13 added 8 commits July 21, 2026 13:37
- Introduced CustomResourceDefinitions for SubscriptionPlan and Subscription, enabling management of subscription plans and subscriptions within the WSO2 API Gateway.
- Implemented a conversion webhook for the CRDs, allowing for seamless versioning and updates.
- Enhanced the operator deployment to support webhook functionality, including dynamic port configuration and certificate management.
- Added a service for the webhook to facilitate communication between the operator and the Kubernetes API.
- Updated Helm chart values to include configuration options for enabling/disabling the webhook and setting certificate validity.
The v1alpha1/v1 schemas are field-identical today (see
api/v1alpha1/conversion.go), and the management API's 0.9->1.0 /
v1alpha2->v1 bump was a pure version-label change with no schema drift,
so a live conversion webhook isn't earning its operational cost yet
(cert lifecycle, and coupling CRD read/write availability to operator
pod health). Keep the Hub()/ConvertTo()/ConvertFrom() Go types as-is so
switching to a real webhook later is a small, isolated change if a
genuine breaking schema change is ever planned.

- cmd/main.go: remove conversion webhook registration, ENABLE_WEBHOOKS
  gating, webhook readyz check, and the webhook TLS server/CertDir.
- subscriptionplan_controller.go: make plan recovery-by-name reactive
  (only after the gateway returns 409 on create), matching
  subscription_controller.go, instead of proactively adopting any
  gateway-wide plan with a matching (non-unique) planName.
- operator-crds.yaml: replace direct CRD-as-template rendering (which
  breaks `helm upgrade` for any CRD previously installed via the
  chart's native crds/ directory, since that path never carries Helm's
  ownership annotations) with a pre-install/pre-upgrade hook ConfigMap
  + Job that kubectl-applies the CRDs directly, bypassing Helm's
  ownership tracking entirely. Conversion strategy is now
  unconditionally None.
- crd-manager-rbac.yaml: cluster-scoped RBAC for the apply-crds Job
  (CRDs aren't namespaced, so this can't ride on the namespace-scoped
  Role path).
- Remove webhook-service.yaml and the webhook.* values/deployment
  wiring (port, cert volume/mount, ENABLE_WEBHOOKS env).
- Chart.yaml: bump version for the CRD packaging/lifecycle change.
crd-manager-rbac.yaml was a plain (non-hook) resource, so on helm upgrade
it only applied AFTER pre-install/pre-upgrade hooks ran — the apply-crds
Job (a pre-upgrade hook) tried to use a ClusterRoleBinding that didn't
exist yet on the very upgrade that introduces it, failing with:

  customresourcedefinitions.apiextensions.k8s.io "..." is forbidden:
  User "system:serviceaccount:<ns>:controller-manager" cannot get
  resource "customresourcedefinitions" in API group "apiextensions.k8s.io"
  at the cluster scope

Reproduced by installing the pre-PR chart (CRDs in crds/, v1alpha1 only)
then helm upgrade --install to this chart, against a real rancher-desktop
cluster. Fix: make the ClusterRole/ClusterRoleBinding pre-install,pre-upgrade
hooks too, weighted before the ConfigMap (0) and apply-crds Job (1).

Re-ran the same install-old/upgrade-to-new repro after the fix: upgrade
succeeded, apply-crds Job completed and self-cleaned, all 12 CRDs ended up
served at v1+v1alpha1 with conversion strategy None and v1 as storage, and
a v1alpha1 SubscriptionPlan CR applied post-upgrade reconciled correctly.
… RestApi CRDs; enhance RBAC and cleanup job definitions
DDH13 added 3 commits July 21, 2026 15:07
- Introduced CRDs for Subscription and SubscriptionPlan under the group gateway.api-platform.wso2.com.
- Each CRD includes detailed specifications, status fields, and validation rules.
- Updated NOTES.txt to reflect the installation method of CRDs.
- Modified cleanup finalizer job to use a configurable service account name.
- Removed deprecated RBAC configurations and CRD apply job templates to streamline the chart.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant