Skip to content

docs: add platform specific installation guide for RedHat OpenShift#775

Open
NomadXD wants to merge 2 commits into
openchoreo:mainfrom
NomadXD:main
Open

docs: add platform specific installation guide for RedHat OpenShift#775
NomadXD wants to merge 2 commits into
openchoreo:mainfrom
NomadXD:main

Conversation

@NomadXD

@NomadXD NomadXD commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Purpose

This PR adds a platform specific section for the OpenChoreo installation guide with a guide for OpenShift installation.

Related Issues

Checklist

  • Updated sidebars.ts if adding a new documentation page
  • Run npm run start to preview the changes locally
  • Run npm run build to ensure the build passes without errors
  • Verified all links are working (no broken links)

NomadXD added 2 commits July 19, 2026 19:48
Signed-off-by: Lahiru De Silva <lahirude@wso2.com>
Signed-off-by: Lahiru De Silva <lahirude@wso2.com>
@coderabbitai

coderabbitai Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Summary by CodeRabbit

  • Documentation
    • Added platform-specific installation guidance for Kubernetes distributions requiring additional adaptations.
    • Added a comprehensive Red Hat OpenShift guide covering prerequisites, installation, configuration, verification, and known limitations.
    • Documented optional workflow and observability plane setup for OpenShift.
    • Added the new guides to the documentation sidebar.

Walkthrough

Adds a platform-specific documentation section for OpenShift, covering prerequisites, infrastructure, OpenChoreo plane installation, verification, optional workflow and observability planes, limitations, and sidebar navigation.

Changes

OpenShift Platform Guide

Layer / File(s) Summary
Platform guide structure and navigation
docs/getting-started/try-it-out/enterprise/index.mdx, sidebars.ts
Adds the platform-guide landing page, OpenShift support details, shared guide structure, and sidebar navigation.
OpenShift prerequisites and infrastructure
docs/getting-started/try-it-out/enterprise/openshift.mdx
Documents SCC setup, Gateway API CRD handling, and installation of cert-manager, External Secrets Operator, kgateway, and OpenBao.
Control plane, data plane, and verification
docs/getting-started/try-it-out/enterprise/openshift.mdx
Documents control-plane and data-plane installation, OpenShift DNS configuration, gateway access, and sample workload verification.
Workflow and observability planes
docs/getting-started/try-it-out/enterprise/openshift.mdx
Adds optional workflow and observability installation steps, OpenShift-specific configuration, plane linking, verification, and limitations.

Estimated code review effort: 4 (Complex) | ~60 minutes

Possibly related PRs

Suggested reviewers: lakshanss

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: adding an OpenShift-specific installation guide.
Description check ✅ Passed The description follows the template with Purpose, Related Issues, and Checklist sections, though Related Issues is empty.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ 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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/getting-started/try-it-out/enterprise/openshift.mdx`:
- Around line 1-5: Run Prettier with --write on
docs/getting-started/try-it-out/enterprise/openshift.mdx (lines 1-5) and
docs/getting-started/try-it-out/enterprise/index.mdx (lines 1-5), correcting
table/code-fence spacing and line wrapping so both files pass the docs Prettier
check.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 873662f6-3c9b-46fb-987e-132dbbfbb219

📥 Commits

Reviewing files that changed from the base of the PR and between 5d2970d and ccac701.

⛔ Files ignored due to path filters (3)
  • versioned_docs/version-v1.1.x/getting-started/try-it-out/enterprise/index.mdx is excluded by !versioned_docs/**
  • versioned_docs/version-v1.1.x/getting-started/try-it-out/enterprise/openshift.mdx is excluded by !versioned_docs/**
  • versioned_sidebars/version-v1.1.x-sidebars.json is excluded by !versioned_sidebars/**
📒 Files selected for processing (3)
  • docs/getting-started/try-it-out/enterprise/index.mdx
  • docs/getting-started/try-it-out/enterprise/openshift.mdx
  • sidebars.ts

Comment on lines +1 to +5
---
title: Red Hat OpenShift
description: Install OpenChoreo's Control, Data, Workflow, and Observability planes on an existing Red Hat OpenShift cluster, with the OpenShift-specific workarounds for SCC, Gateway API CRDs, and DNS built into every step.
sidebar_position: 1
---

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Prettier check is failing for both new docs. The CI step prettier --check docs/**/*.{md,mdx} reports formatting issues in these files; run Prettier to fix and unblock the pipeline.

  • docs/getting-started/try-it-out/enterprise/openshift.mdx#L1-L5: run npx prettier --write on this file (check table/code-fence spacing and line wrapping).
  • docs/getting-started/try-it-out/enterprise/index.mdx#L1-L5: run npx prettier --write on this file (the supported-platforms table at L17-L19 is a likely culprit).
🧰 Tools
🪛 GitHub Actions: Test deployment / 0_Test deployment.txt

[warning] 1-1: Prettier --check reported a formatting/style issue in this file.

🪛 GitHub Actions: Test deployment / Test deployment

[warning] 1-1: Prettier formatting check reported a code style issue. (prettier --check docs/**/*.{md,mdx})

📍 Affects 2 files
  • docs/getting-started/try-it-out/enterprise/openshift.mdx#L1-L5 (this comment)
  • docs/getting-started/try-it-out/enterprise/index.mdx#L1-L5
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/getting-started/try-it-out/enterprise/openshift.mdx` around lines 1 - 5,
Run Prettier with --write on
docs/getting-started/try-it-out/enterprise/openshift.mdx (lines 1-5) and
docs/getting-started/try-it-out/enterprise/index.mdx (lines 1-5), correcting
table/code-fence spacing and line wrapping so both files pass the docs Prettier
check.

Source: Pipeline failures

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