✨ Add Bundle-Agnostic Configuration Validation Using JSON Schema

[camilamacedo86]

Bundle configuration is now validated using JSON Schema before installation. Configuration errors (typos, missing required fields, type mismatches) are caught immediately with clear error messages instead of failing during deployment.

Motivation

https://issues.redhat.com/browse/OPRUN-4112

Design

Introduced ConfigSchemaProvider interface to abstract schema source from validation logic:

Registry+v1 Bundle → buildSchemaForInstallModes() ──┐
Helm Chart        → Read values.schema.json       ──┤──→ UnmarshalConfig() ──→ bundle.Config
Registry+v2        → (Future) GetConfigSchema()   ──┘         ↑
                                                          JSON Schema
                                                          Validation

Detailed flow:

┌──────────────────┐
│ Registry+v1      │────┐
│ (implements      │    │
│ ConfigSchema-    │    │
│ Provider)        │    │
└──────────────────┘    │
                        │
┌──────────────────┐    │    ┌─────────────────────┐    ┌──────────────────┐
│ Helm Chart       │────┼───→│ UnmarshalConfig()   │───→│  bundle.Config   │
│ (implements      │    │    │                     │    │  {               │
│ ConfigSchema-    │    │    │ 1. Get schema       │    │    WatchNamespace│
│ Provider)        │    │    │ 2. Validate (JSON)  │    │  }               │
└──────────────────┘    │    │ 3. Parse YAML       │    └──────────────────┘
                        │    └─────────────────────┘
┌──────────────────┐    │            ↑
│ Any Bundle Type  │────┘     SAME FOR ALL
└────────────────── ┘

Do I Need to Configure watchNamespace?

Your Bundle Supports	Need to Configure watchNamespace?
AllNamespaces only	✅ No - optional
SingleNamespace only	❌ Yes - pick a different namespace
OwnNamespace only	❌ Yes - must be the install namespace
AllNamespaces + OwnNamespace	✅ No - optional
OwnNamespace + SingleNamespace	❌ Yes - pick a namespace

Examples

✅ Works: No config needed

kind: ClusterExtension
spec:
  packageName: my-operator
  # No config - works if bundle supports AllNamespaces

✅ Works: With config

kind: ClusterExtension
spec:
  packageName: my-operator
  config:
    watchNamespace: my-namespace

❌ Fails: Missing required field

kind: ClusterExtension
spec:
  packageName: my-operator
  # Error: required field "watchNamespace" is missing

❌ Fails: Typo in field name

kind: ClusterExtension
spec:
  packageName: my-operator
  config:
    watchNamespce: my-namespace  # Typo!
    # Error: unknown field "watchNamespce"

❌ Fails: Wrong namespace

kind: ClusterExtension
metadata:
  namespace: my-namespace
spec:
  packageName: my-operator
  config:
    watchNamespace: wrong-namespace
    # Error: must be install namespace (my-namespace)

[netlify]

✅ Deploy Preview for olmv1 ready!

Name	Link
🔨 Latest commit	b828f0b
🔍 Latest deploy log	https://app.netlify.com/projects/olmv1/deploys/69148367af00e1000838aa93
😎 Deploy Preview	https://deploy-preview-2316--olmv1.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[codecov]

Codecov Report

❌ Patch coverage is 76.38889% with 51 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.42%. Comparing base (d204888) to head (b828f0b).

Files with missing lines	Patch %	Lines
...ternal/operator-controller/rukpak/bundle/config.go	75.94%	33 Missing and 18 partials ⚠️

Additional details and impacted files

@@           Coverage Diff            @@
##             main    #2316    +/-   ##
========================================
  Coverage   74.42%   74.42%            
========================================
  Files          91       92     +1     
  Lines        7057     7233   +176     
========================================
+ Hits         5252     5383   +131     
- Misses       1393     1422    +29     
- Partials      412      428    +16     

Flag	Coverage Δ
e2e	44.68% <0.00%> (-1.19%)	⬇️
experimental-e2e	48.57% <50.92%> (+0.11%)	⬆️
unit	58.81% <75.92%> (+0.30%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

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

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

Needs approval from an approver in each of these files:

• OWNERS

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

[Copilot]

Pull Request Overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.