Skip to content

[Feature][RayCluster]: Deprecate the RayCluster .Status.State field #2288

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

rueian
Copy link
Contributor

@rueian rueian commented Aug 6, 2024

Why are these changes needed?

In the progress of ray-project/enhancements#54, we have added the new .Status.Conditions field to replace the single .Status.State and we are planning not to make further changes to the .Status.State anymore. So mark it deprecated to prevent future changes on the field.

Related issue number

Checks

  • I've made sure the tests are passing.
  • Testing Strategy
    • Unit tests
    • Manual tests
    • This PR is not tested :(

@@ -1,3 +1,5 @@
//nolint:SA1019
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Skip the deprecation usage lints.
image

@@ -121,6 +121,8 @@ type RayClusterStatus struct {
// INSERT ADDITIONAL STATUS FIELD - define observed state of cluster
// Important: Run "make" to regenerate code after modifying this file
// Status reflects the status of the cluster
//
// Deprecated: the State field is replaced by the Conditions field.
Copy link
Member

Choose a reason for hiding this comment

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

Should we include the name of the conditions that replace the existing states here?

Copy link
Member

Choose a reason for hiding this comment

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

Or will there be public docs on the new conditions? If so we can just link to that in a follow-up PR

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, we plan to make a public doc to introduce the new conditions and changes to the .status.state in the following weeks.
image

@rueian
Copy link
Contributor Author

rueian commented Aug 7, 2024

Sorry for the delay. I am still working on the linter issue.

@rueian rueian marked this pull request as ready for review August 10, 2024 00:14
@kevin85421 kevin85421 self-assigned this Aug 10, 2024
@kevin85421
Copy link
Member

@rueian would you mind opening an issue to track the progress of the deprecation timeline of this field? (ex: add a comment, update doc, use condition instead of state in KubeRay codebase, delete the field ... etc)

@kevin85421 kevin85421 merged commit 5231dbf into ray-project:master Sep 3, 2024
26 of 27 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants