feat(RHOAIENG-29330):Deny RayCluster creation with Ray Version mismatches

[LilyLinh]

Issue link

Jira

What changes have been made

This PR implements Ray version validation to prevent compatibility issues between the CodeFlare SDK and user-specified runtime images.

Solution: Added automatic Ray version detection and validation during cluster configuration:

• Version Detection: New utility function extract_ray_version_from_image() parses Ray versions from various image name formats (e.g., ray:2.47.1, quay.io/modh/ray:2.47.1-py311-cu121)
• Validation Logic: validate_ray_version_compatibility() compares runtime image Ray version against SDK version (2.47.1)
• Integration: Validation automatically runs during ClusterConfiguration.__post_init__()
• User Experience: Clear error messages guide users to fix version mismatches; warnings for undetectable versions
• Documentation: Updated cluster configuration docs with Ray version requirements and best practices

Verification steps

Build the SDK, test its functionality in a notebook.

• In Cluster create and configure step, when using runtime image with correct Ray version image="quay.io/modh/ray:2.47.1-py311-cu121", the cluster is created and up successfully; when using a different Ray version ( e.g., image="quay.io/modh/ray:2.46.1-py311-cu121"), it should show an error message.

Checks

• I've made sure the tests are passing.
• Testing Strategy
  • Unit tests
  • Manual tests
  • Testing is not required for this change

[codecov]

Codecov Report

❌ Patch coverage is 91.22807% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 93.57%. Comparing base (5a77f7b) to head (8761510).
⚠️ Report is 3 commits behind head on ray-jobs-feature.

Files with missing lines	Patch %	Lines
src/codeflare_sdk/common/utils/validation.py	85.71%	5 Missing ⚠️

Additional details and impacted files

@@                 Coverage Diff                  @@
##           ray-jobs-feature     #881      +/-   ##
====================================================
- Coverage             93.65%   93.57%   -0.08%     
====================================================
  Files                    20       21       +1     
  Lines                  1717     1774      +57     
====================================================
+ Hits                   1608     1660      +52     
- Misses                  109      114       +5     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[kryanbeane]

Only small changes but this is great work @LilyLinh well done :)

[kryanbeane]

/hold

[kryanbeane]

Great thanks for making those changes @LilyLinh ! Fantastic work :) lgtm

[openshift-ci]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: kryanbeane

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

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [kryanbeane]

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

[kryanbeane]

/unhold