Skip to content

Sync APIs from volcano-sh/volcano@83a654ff2#228

Open
volcano-sh-bot wants to merge 1 commit intomasterfrom
sync-83a654ff2
Open

Sync APIs from volcano-sh/volcano@83a654ff2#228
volcano-sh-bot wants to merge 1 commit intomasterfrom
sync-83a654ff2

Conversation

@volcano-sh-bot
Copy link
Copy Markdown
Collaborator

Automated API Sync

This PR was automatically created to sync API changes from the main volcano repository.

Source Information

Item Value
Repository volcano-sh/volcano
Branch master
Commit 83a654ff2
PR #5000

Triggered by

Item Value
Actor @volcano-sh-bot
Event push
Run #5

🤖 This PR was generated by sync-apis workflow

Original commit: Merge pull request #5000 from guoqinwill/adapt-1.35

Automated sync from staging directory.
Source: volcano-sh/volcano@83a654f

Signed-off-by: Volcano Bot <volcano-bot@users.noreply.github.com>
@volcano-sh-bot
Copy link
Copy Markdown
Collaborator Author

[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 thor-wl for approval. For more information see the Kubernetes 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

@gemini-code-assist
Copy link
Copy Markdown

Summary of Changes

Hello @volcano-sh-bot, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request performs an automated synchronization of API definitions and updates the project's Go module dependencies. The changes include an upgrade to Go 1.25.0, a significant bump in Kubernetes API versions to v0.35.0, and a comprehensive refresh of other Go modules. A key aspect of this update is the addition of detailed documentation comments to numerous API types, which greatly enhances the clarity and understanding of the project's custom resources. These updates collectively ensure the project's dependencies are current and its API surface is well-documented.

Highlights

  • Go Version Upgrade: The Go language version used in the project has been updated from 1.24.0 to 1.25.0 in go.mod.
  • Kubernetes API Dependency Update: Core Kubernetes API dependencies, including k8s.io/api, k8s.io/apimachinery, k8s.io/client-go, and k8s.io/code-generator, have been upgraded from v0.34.1 to v0.35.0.
  • General Go Module Dependency Updates: Numerous other Go module dependencies across the project have been updated to their latest versions, ensuring compatibility and incorporating recent improvements. Some indirect dependencies like github.com/gogo/protobuf and github.com/pkg/errors were removed or updated.
  • Enhanced API Documentation: Extensive documentation comments have been added to various ApplyConfiguration structs and their fields across multiple Volcano API groups (batch, bus, config, datadependency, flow, nodeinfo, scheduling, shard, topology), providing clearer explanations of their purpose and usage.
  • Informer WatchList Semantics Improvement: The informer factory functions (NewFiltered*Informer) have been updated to utilize cache.ToListWatcherWithWatchListSemantics, which refines how watch-list operations are handled for better efficiency and correctness.
  • Fake Clientset Modernization: The fake clientset for testing now explicitly marks NewSimpleClientset as deprecated and includes a new method IsWatchListSemanticsUnSupported, reflecting updated practices for testing server-side apply configurations.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • go.mod
    • Updated Go version from 1.24.0 to 1.25.0.
    • Upgraded Kubernetes API dependencies (e.g., k8s.io/api, k8s.io/apimachinery) from v0.34.1 to v0.35.0.
    • Removed indirect dependencies github.com/gogo/protobuf and github.com/pkg/errors.
    • Updated various other indirect Go module dependencies to newer versions.
  • go.sum
    • Updated checksums for all modified and newly added Go module dependencies.
  • pkg/client/applyconfiguration/batch/v1alpha1/cronjob.go
    • Added detailed documentation comments to CronJobApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/cronjobspec.go
    • Added detailed documentation comments to CronJobSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/cronjobstatus.go
    • Added detailed documentation comments to CronJobStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/dependson.go
    • Added detailed documentation comments to DependsOnApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/job.go
    • Added detailed documentation comments to JobApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/jobcondition.go
    • Added detailed documentation comments to JobConditionApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/jobspec.go
    • Added detailed documentation comments to JobSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/jobstate.go
    • Added detailed documentation comments to JobStateApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/jobstatus.go
    • Added detailed documentation comments to JobStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/jobtemplatespec.go
    • Added detailed documentation comments to JobTemplateSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/lifecyclepolicy.go
    • Added detailed documentation comments to LifecyclePolicyApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/networktopologyspec.go
    • Added detailed documentation comments to NetworkTopologySpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/partitionpolicyspec.go
    • Added detailed documentation comments to PartitionPolicySpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/taskspec.go
    • Added detailed documentation comments to TaskSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/taskstate.go
    • Added detailed documentation comments to TaskStateApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/batch/v1alpha1/volumespec.go
    • Added detailed documentation comments to VolumeSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/bus/v1alpha1/command.go
    • Added detailed documentation comments to CommandApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/config/v1alpha1/colocationconfiguration.go
    • Added detailed documentation comments to ColocationConfigurationApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/config/v1alpha1/colocationconfigurationspec.go
    • Added detailed documentation comments to ColocationConfigurationSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/config/v1alpha1/colocationconfigurationstatus.go
    • Added detailed documentation comments to ColocationConfigurationStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/config/v1alpha1/configuration.go
    • Added detailed documentation comments to ConfigurationApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/config/v1alpha1/memoryqos.go
    • Added detailed documentation comments to MemoryQosApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/datadependency/v1alpha1/datasource.go
    • Added detailed documentation comments to DataSourceApplyConfiguration struct.
  • pkg/client/applyconfiguration/datadependency/v1alpha1/datasourceclaim.go
    • Added detailed documentation comments to DataSourceClaimApplyConfiguration struct.
  • pkg/client/applyconfiguration/datadependency/v1alpha1/datasourceclaimspec.go
    • Added detailed documentation comments to DataSourceClaimSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/datadependency/v1alpha1/datasourceclaimstatus.go
    • Added detailed documentation comments to DataSourceClaimStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/datadependency/v1alpha1/datasourcelocality.go
    • Added detailed documentation comments to DataSourceLocalityApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/datadependency/v1alpha1/datasourcespec.go
    • Added detailed documentation comments to DataSourceSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/datadependency/v1alpha1/datasourcestatus.go
    • Added detailed documentation comments to DataSourceStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/datadependency/v1alpha1/workloadref.go
    • Added detailed documentation comments to WorkloadRefApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/flow/v1alpha1/flow.go
    • Added detailed documentation comments to FlowApplyConfiguration struct.
  • pkg/client/applyconfiguration/flow/v1alpha1/jobflow.go
    • Added detailed documentation comments to JobFlowApplyConfiguration struct.
  • pkg/client/applyconfiguration/flow/v1alpha1/jobflowspec.go
    • Added detailed documentation comments to JobFlowSpecApplyConfiguration struct.
  • pkg/client/applyconfiguration/flow/v1alpha1/jobflowstatus.go
    • Added detailed documentation comments to JobFlowStatusApplyConfiguration struct.
  • pkg/client/applyconfiguration/flow/v1alpha1/jobtemplate.go
    • Added detailed documentation comments to JobTemplateApplyConfiguration struct.
  • pkg/client/applyconfiguration/flow/v1alpha1/jobtemplatestatus.go
    • Added detailed documentation comments to JobTemplateStatusApplyConfiguration struct.
  • pkg/client/applyconfiguration/nodeinfo/v1alpha1/cpuinfo.go
    • Added detailed documentation comments to CPUInfoApplyConfiguration struct.
  • pkg/client/applyconfiguration/nodeinfo/v1alpha1/numatopology.go
    • Added detailed documentation comments to NumatopologyApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/nodeinfo/v1alpha1/numatopospec.go
    • Added detailed documentation comments to NumatopoSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/nodeinfo/v1alpha1/resourceinfo.go
    • Added detailed documentation comments to ResourceInfoApplyConfiguration struct.
  • pkg/client/applyconfiguration/scheduling/v1beta1/affinity.go
    • Added detailed documentation comments to AffinityApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/cluster.go
    • Added detailed documentation comments to ClusterApplyConfiguration struct.
  • pkg/client/applyconfiguration/scheduling/v1beta1/guarantee.go
    • Added detailed documentation comments to GuaranteeApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/networktopologyspec.go
    • Added detailed documentation comments to NetworkTopologySpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/podgroup.go
    • Added detailed documentation comments to PodGroupApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/podgroupcondition.go
    • Added detailed documentation comments to PodGroupConditionApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/podgroupspec.go
    • Added detailed documentation comments to PodGroupSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/podgroupstatus.go
    • Added detailed documentation comments to PodGroupStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/queue.go
    • Added detailed documentation comments to QueueApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/queuespec.go
    • Added detailed documentation comments to QueueSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/queuestatus.go
    • Added detailed documentation comments to QueueStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/reservation.go
    • Added detailed documentation comments to ReservationApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/scheduling/v1beta1/subgrouppolicyspec.go
    • Added detailed documentation comments to SubGroupPolicySpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/shard/v1alpha1/nodeshard.go
    • Added detailed documentation comments to NodeShardApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/shard/v1alpha1/nodeshardspec.go
    • Added detailed documentation comments to NodeShardSpecApplyConfiguration struct.
  • pkg/client/applyconfiguration/shard/v1alpha1/nodeshardstatus.go
    • Added detailed documentation comments to NodeShardStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/topology/v1alpha1/exactmatch.go
    • Added detailed documentation comments to ExactMatchApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/topology/v1alpha1/hypernode.go
    • Added detailed documentation comments to HyperNodeApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/topology/v1alpha1/hypernodespec.go
    • Added detailed documentation comments to HyperNodeSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/topology/v1alpha1/hypernodestatus.go
    • Added detailed documentation comments to HyperNodeStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/topology/v1alpha1/memberselector.go
    • Added detailed documentation comments and examples to MemberSelectorApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/topology/v1alpha1/memberspec.go
    • Added detailed documentation comments to MemberSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/topology/v1alpha1/regexmatch.go
    • Added detailed documentation comments to RegexMatchApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/training/v1alpha1/hyperjob.go
    • Added a blank line for formatting.
  • pkg/client/applyconfiguration/training/v1alpha1/hyperjobspec.go
    • Added detailed documentation comments to HyperJobSpecApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/training/v1alpha1/hyperjobstatus.go
    • Added detailed documentation comments to HyperJobStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/training/v1alpha1/replicatedjob.go
    • Added detailed documentation comments to ReplicatedJobApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/training/v1alpha1/replicatedjobstatus.go
    • Added detailed documentation comments to ReplicatedJobStatusApplyConfiguration struct and its fields.
  • pkg/client/applyconfiguration/training/v1alpha1/splitpolicy.go
    • Added detailed documentation comments to SplitPolicyApplyConfiguration struct and its fields.
  • pkg/client/clientset/versioned/fake/clientset_generated.go
    • Deprecated NewSimpleClientset with a comment.
    • Corrected variable name from watchActcion to watchAction.
    • Added IsWatchListSemanticsUnSupported method to signal lack of WatchList semantics support.
  • pkg/client/informers/externalversions/batch/v1alpha1/cronjob.go
    • Updated NewFilteredCronJobInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/batch/v1alpha1/job.go
    • Updated NewFilteredJobInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/bus/v1alpha1/command.go
    • Updated NewFilteredCommandInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/config/v1alpha1/colocationconfiguration.go
    • Updated NewFilteredColocationConfigurationInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/datadependency/v1alpha1/datasource.go
    • Updated NewFilteredDataSourceInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/datadependency/v1alpha1/datasourceclaim.go
    • Updated NewFilteredDataSourceClaimInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/factory.go
    • Added a blank line before the deprecated comment for NewFilteredSharedInformerFactory.
    • Updated comment for NewSharedInformerFactory to suggest context.WithCancel.
  • pkg/client/informers/externalversions/flow/v1alpha1/jobflow.go
    • Updated NewFilteredJobFlowInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/flow/v1alpha1/jobtemplate.go
    • Updated NewFilteredJobTemplateInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/nodeinfo/v1alpha1/numatopology.go
    • Updated NewFilteredNumatopologyInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/scheduling/v1beta1/podgroup.go
    • Updated NewFilteredPodGroupInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/scheduling/v1beta1/queue.go
    • Updated NewFilteredQueueInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/shard/v1alpha1/nodeshard.go
    • Updated NewFilteredNodeShardInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/topology/v1alpha1/hypernode.go
    • Updated NewFilteredHyperNodeInformer to use cache.ToListWatcherWithWatchListSemantics.
  • pkg/client/informers/externalversions/training/v1alpha1/hyperjob.go
    • Updated NewFilteredHyperJobInformer to use cache.ToListWatcherWithWatchListSemantics.
Activity
  • The pull request was automatically generated by @volcano-sh-bot.
  • The changes were triggered by a push event in the main volcano repository.
  • The automated workflow run can be found at #5.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request is an automated synchronization of API changes from the main volcano repository. The changes primarily consist of updating Go dependencies, including upgrading to Go 1.25 and updating various Kubernetes-related libraries. A significant portion of the changes involves regenerating client code, which has resulted in the addition of documentation comments to many API types and adaptations to new features in client-go. The changes appear to be correct and consistent with a dependency upgrade. I have a couple of minor suggestions regarding confusing comments in the generated code.

return c.tracker
}

// IsWatchListSemanticsSupported informs the reflector that this client
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

There's a typo in the comment. It should be IsWatchListSemanticsUnSupported to match the function name.

Suggested change
// IsWatchListSemanticsSupported informs the reflector that this client
// IsWatchListSemanticsUnSupported informs the reflector that this client

Comment on lines +23 to +24
// EDIT THIS FILE! THIS IS SCAFFOLDING FOR YOU TO OWN!
// NOTE: json tags are required. Any new fields you add must have json tags for the fields to be serialized.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

This generated file includes a comment (// EDIT THIS FILE! THIS IS SCAFFOLDING FOR YOU TO OWN!) that suggests it can be manually edited. This is confusing because the file is auto-generated and should not be modified directly. This comment is likely propagated from the source API type definition in pkg/apis/nodeinfo/v1alpha1/numatopo_types.go. To avoid confusion, it's recommended to remove this scaffolding comment from the source type definition in a follow-up change.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants