Skip to content

docs: add installation instructions to README (#96) - #704

Open
iacker wants to merge 1 commit into
project-codeflare:mainfrom
iacker:docs/96-installation-instructions
Open

docs: add installation instructions to README (#96)#704
iacker wants to merge 1 commit into
project-codeflare:mainfrom
iacker:docs/96-installation-instructions

Conversation

@iacker

@iacker iacker commented Aug 8, 2026

Copy link
Copy Markdown

Description

The README documents development, testing and release workflows, but it never explains how to actually install the operator — the gap tracked in #96 ("can we use codeflare operator without ODH? Answer is yes. We may want to write down the instruction").

This adds an Installation section (between the compatibility matrix and Development) covering the paths raised in the issue:

  • Prerequisite: KubeRay and Kueue installed/configured first (with a pointer to the compatibility matrix for validated versions).
  • OpenShift: install from OperatorHub (OLM Subscription).
  • Kubernetes: make deploy IMG=quay.io/project-codeflare/codeflare-operator:stable using the existing config/default kustomize overlay, with make undeploy to remove it.

Docs-only change.

Fixes #96

How Has This Been Tested?

Instructions cross-checked against the repo, not invented:

  • make deploy builds config/${ENV} (ENV ?= default) and honours IMGMakefile deploy/undeploy targets.
  • config/default/kustomization.yaml exists.
  • Image quay.io/project-codeflare/codeflare-operator publishes the stable tag (and per-release tags like v1.16.0).
  • OperatorHub path mirrors the sibling project-codeflare operators' install story.

AI disclosure: drafted with AI assistance and verified against the Makefile, kustomize overlays and the published image tags by the author.

The README covered development, testing and release flows but never
documented how to install the operator on its own (without the wider
Open Data Hub stack), which is the question raised in project-codeflare#96.

Add an Installation section with:
- the KubeRay + Kueue prerequisite,
- OpenShift install via OperatorHub (OLM Subscription),
- Kubernetes install via 'make deploy IMG=...' with the config/default
  kustomize overlay, plus 'make undeploy'.

Fixes project-codeflare#96

Signed-off-by: iacker <iacker@users.noreply.github.com>
@openshift-ci

openshift-ci Bot commented Aug 8, 2026

Copy link
Copy Markdown

[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 jbusche for approval. For more information see the Code Review Process.

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

Details Needs approval from an approver in each of these files:

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

@openshift-ci
openshift-ci Bot requested review from dimakis and szaher August 8, 2026 00:27
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.

Add installation instructions to README

1 participant