Skip to content

docs(opa): the OPA surface on its own engines-only port - #70

Merged
viethqb merged 4 commits into
mainfrom
docs/opa-listener
Nov 8, 2026
Merged

viethqb merged 4 commits into
mainfrom
docs/opa-listener

Conversation

@viethqb

@viethqb viethqb commented Nov 8, 2026

Copy link
Copy Markdown
Member

Summary

These are the user docs for egret-data/platform#843. That PR moves egret's OPA decision surface off API port 8080 onto its own listener, which only engines can reach.

Pages

  • platform/data-governance/engines-and-policy/trino-on-opa.md:
    • the OPA port and how the engine URL is derived;
    • the start-up re-apply, which runs in the background, and the query outage until each coordinator restarts;
    • external engines must re-install their plugin files;
    • the NetworkPolicy.
  • platform/reference/configuration-keys.md: governance.opa.listen and governance.opa.engine_url, which are checked only while OPA is on.
  • platform/deploy-operate/kubernetes.md: opa.enabled, opa.port, opa.extraFrom, and the egret-ingress policy. This describes what the chart renders; it was not run on a live cluster.
  • platform/deploy-operate/upgrade.md:
    • provisioned OPA engines are re-applied at start;
    • queries are refused until then, so upgrade in a maintenance window;
    • external engines must re-install their plugin files;
    • firewalls must allow the OPA port from engines.

npm run build passes, for en and vi.

🤖 Generated with Claude Code

viethqb and others added 4 commits November 8, 2026 10:32
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Queries on provisioned OPA engines are refused from the moment the new
egret serves until each coordinator is re-applied and restarted, also
during a rolling update with old and new pods serving; recommend a
maintenance window. The listen/engine_url checks apply only with OPA
enabled, and engine_url must be an absolute http(s) URL.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@viethqb
viethqb merged commit 3130be4 into main Nov 8, 2026
2 checks passed
@viethqb
viethqb deleted the docs/opa-listener branch November 8, 2026 07:40
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