Skip to content

docs: v1.5.2 / operator v1.5.4 documentation updates#194

Open
jordigilh wants to merge 5 commits into
mainfrom
docs/v1.5.2-operator-v1.5.4-updates
Open

docs: v1.5.2 / operator v1.5.4 documentation updates#194
jordigilh wants to merge 5 commits into
mainfrom
docs/v1.5.2-operator-v1.5.4-updates

Conversation

@jordigilh

Copy link
Copy Markdown
Owner

Summary

  • OpenAI provider support for AF: Update AF supported providers from 3 to 4. Document endpoint requirement and openai_compatible translation across operator-cr, configuration, apifrontend architecture, and disconnected-install pages.
  • Remove stale v1.5 GA banners: AF, interactive sessions, and apifrontend-api are GA since v1.5.0.
  • Remove allowInsecureIssuers/allowInsecureJWKS: Not needed in operator-managed deployments. Remove from CR reference, examples, and guidance tables.
  • Installation page overhaul (aligned with authoritative airgapped guide):
    • Remove deprecated Helm chart section (prereqs, install, uninstall)
    • Add direct manifest install path alongside OLM/CatalogSource
    • Add full Console OIDC Keycloak client registration (4-step scripted flow)
    • Add OCP 4.18/kagenti v0.5.1 dual-path (SPIRE disabled) coverage with tabbed UI
    • Add tool personas reference table (6 personas with full tool grants)
    • Add custom ClusterRoles with clusterRoleName examples
    • Add Valkey secret format validation warning
    • Add PostgreSQL env var mapping note (POSTGRES_*POSTGRESQL_*)
    • Add StorageClass discovery tips per platform (AWS, vSphere, bare metal, ODF, Azure)
    • Add comprehensive troubleshooting section (8 scenarios)
    • Fix component count: 11 → 14 workloads, 9 → 11 CRDs
    • Add PSA enforce=privileged label documentation for SPIRE
    • Document spire.enabled pointer behavior (explicit false now works)
    • Update verification section with OCP 4.18 vs 4.19+ tabs
  • Fix broken cross-references: Redirect signal-source-authentication links after Helm section removal.
  • Add console + oauth2-proxy images to disconnected-install image table (17 → 19 images).
  • Bump version macros: image_tag v1.5.1 → v1.5.2, operator_image_tag 1.5.1 → 1.5.4.

Test plan

  • Verify mkdocs serve builds without warnings
  • Review installation page structure (operator section, kagenti tabs, troubleshooting)
  • Verify Console OIDC registration flow matches production deployment
  • Verify AF provider table shows openai as AF-supported
  • Verify version macros render correctly on operator image tag references

Made with Cursor

jordigilh and others added 5 commits June 30, 2026 08:59
Update AF supported providers from 3 to 4 (openai, vertex_ai, gemini,
anthropic). Document endpoint requirement and openai_compatible
translation by the operator. Update provider tables, descriptions, and
AF LLM Limitations section across operator-cr, configuration,
apifrontend architecture, and disconnected-install pages.

Co-authored-by: Cursor <cursoragent@cursor.com>
AF, interactive sessions, and apifrontend-api pages are GA since v1.5.0.
Remove the "under active development" warning banners.

Co-authored-by: Cursor <cursoragent@cursor.com>
Redirect signal-source-authentication links from installation.md to
configuration.md where the content now lives.

Co-authored-by: Cursor <cursoragent@cursor.com>
Major changes driven by authoritative airgapped guide alignment:

- Remove deprecated Helm chart section (prereqs, install, uninstall)
- Add direct manifest install path alongside OLM/CatalogSource
- Add full Console OIDC Keycloak client registration (4-step flow)
- Add OCP 4.18/kagenti v0.5.1 dual-path (SPIRE disabled) coverage
- Add tool personas reference table (6 personas with tool grants)
- Add custom ClusterRoles with clusterRoleName examples
- Add Valkey secret format validation warning
- Add PostgreSQL env var mapping note (POSTGRES_* → POSTGRESQL_*)
- Add StorageClass discovery tips per platform
- Add comprehensive troubleshooting section (ImagePullBackOff,
  CrashLoopBackOff, 401 audience, 403 RBAC, authbridge client
  identity, OVN routing, PG data loss, migration failures)
- Fix component count: 11 → 14 workloads, 9 → 11 CRDs
- Remove allowInsecureIssuers from CR examples and docs
- Remove stale OCP Helm chart deprecation banner
- Update verification section with OCP 4.18 vs 4.19+ tabs

Co-authored-by: Cursor <cursoragent@cursor.com>
Update chart_version, image_tag, and operator_image_tag in mkdocs.yml
to reflect the current release versions.

Co-authored-by: Cursor <cursoragent@cursor.com>
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