From ddeb67cba8b59a2a78ab85b6b7c12ae30b684dc3 Mon Sep 17 00:00:00 2001 From: antoniocali Date: Fri, 22 May 2026 12:10:16 +0100 Subject: [PATCH] docs: document CONNECTOR_DISCOVERY_ENABLED for Fusion-only deployments Surface the new olake-ui config flag through the chart's values.yaml comments and README. No template change is needed since olakeUI.env is already a passthrough; this is purely a discoverability improvement so operators of Fusion-only / air-gapped deployments can find the knob. Companion to datazip-inc/olake-ui#382 and datazip-inc/olake-ui#380. --- helm/olake/README.md | 15 +++++++++++++++ helm/olake/values.yaml | 8 ++++++++ 2 files changed, 23 insertions(+) diff --git a/helm/olake/README.md b/helm/olake/README.md index 5174e93..0b7bd98 100644 --- a/helm/olake/README.md +++ b/helm/olake/README.md @@ -321,6 +321,21 @@ When set, **all** container images are automatically prefixed with this registry > - Pass registry credentials as environment variables under `olakeUI.env` (e.g., `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` for ECR), or > - Attach the required read-only registry permissions to the IAM role referenced by `global.jobServiceAccount`. +### Disabling Connector Discovery (Fusion-only / Air-gapped) + +By default the `olake-ui` server queries the upstream container registry on every `/versions`, `/spec`, and `/test-connection` call to enumerate available CDC connector image tags. In Fusion-only deployments (Iceberg maintenance against an existing catalog, no CDC connectors used) this generates avoidable outbound traffic, log noise, and — when the registry rate-limits or 504s — user-facing slowness in the UI. + +Set `CONNECTOR_DISCOVERY_ENABLED: "false"` to skip those registry queries entirely. When discovery is disabled, `DEFAULT_CONNECTOR_VERSION` must be set; it's returned as the single available version for any connector type. + +```yaml +olakeUI: + env: + CONNECTOR_DISCOVERY_ENABLED: "false" + DEFAULT_CONNECTOR_VERSION: "v0.3.18" +``` + +This is also useful in air-gapped clusters where the chart's private-registry mirror does not expose a Docker Registry HTTP API v2 (or where the listing API is intentionally locked down). + ## Monitoring and Troubleshooting ### View Logs diff --git a/helm/olake/values.yaml b/helm/olake/values.yaml index a012404..f64f591 100644 --- a/helm/olake/values.yaml +++ b/helm/olake/values.yaml @@ -157,6 +157,14 @@ olakeUI: # env: # CUSTOM_VAR: "value" # FEATURE_FLAG: "true" + # + # Fusion-only / air-gapped deployments: disable upstream container registry + # queries used to enumerate CDC connector versions. With discovery off, the + # /versions and /spec endpoints return DEFAULT_CONNECTOR_VERSION directly + # without contacting Docker Hub / ECR / GCR. + # env: + # CONNECTOR_DISCOVERY_ENABLED: "false" + # DEFAULT_CONNECTOR_VERSION: "v0.3.18" env: {} # -- Ingress configuration for external access