Kueue Alpha API

Generated API reference documentation for kueue.x-k8s.io/v1alpha1.

Resource Types

Topology

`Topology`

Appears in:

Topology is the Schema for the topology API

Field	Description
`apiVersion` string	`kueue.x-k8s.io/v1alpha1`
`kind` string	`Topology`
`spec` [Required] `TopologySpec`	No description provided.

`Cohort`

Appears in:

Cohort is the Schema for the cohorts API. Using Hierarchical Cohorts (any Cohort which has a parent) with Fair Sharing results in undefined behavior in 0.9

Field	Description
`spec` [Required] `CohortSpec`	No description provided.

`CohortSpec`

Appears in:

Cohort

CohortSpec defines the desired state of Cohort

Field Description

Field	Description
`parent` [Required] `string`	Parent references the name of the Cohort's parent, if any. It satisfies one of three cases: Unset. This Cohort is the root of its Cohort tree. References a non-existent Cohort. We use default Cohort (no borrowing/lending limits). References an existent Cohort. If a cycle is created, we disable all members of the Cohort, including ClusterQueues, until the cycle is removed. We prevent further admission while the cycle exists.
`resourceGroups` [Required] `[]ResourceGroup`	ResourceGroups describes groupings of Resources and Flavors. Each ResourceGroup defines a list of Resources and a list of Flavors which provide quotas for these Resources. Each Resource and each Flavor may only form part of one ResourceGroup. There may be up to 16 ResourceGroups within a Cohort. BorrowingLimit limits how much members of this Cohort subtree can borrow from the parent subtree. LendingLimit limits how much members of this Cohort subtree can lend to the parent subtree. Borrowing and Lending limits must only be set when the Cohort has a parent. Otherwise, the Cohort create/update will be rejected by the webhook.

parent [Required]
string

Parent references the name of the Cohort's parent, if any. It satisfies one of three cases:

Unset. This Cohort is the root of its Cohort tree.
References a non-existent Cohort. We use default Cohort (no borrowing/lending limits).
References an existent Cohort.

If a cycle is created, we disable all members of the Cohort, including ClusterQueues, until the cycle is removed. We prevent further admission while the cycle exists.

resourceGroups [Required]
[]ResourceGroup

ResourceGroups describes groupings of Resources and Flavors. Each ResourceGroup defines a list of Resources and a list of Flavors which provide quotas for these Resources. Each Resource and each Flavor may only form part of one ResourceGroup. There may be up to 16 ResourceGroups within a Cohort.

BorrowingLimit limits how much members of this Cohort subtree can borrow from the parent subtree.

LendingLimit limits how much members of this Cohort subtree can lend to the parent subtree.

Borrowing and Lending limits must only be set when the Cohort has a parent. Otherwise, the Cohort create/update will be rejected by the webhook.

`TopologyLevel`

Appears in:

TopologySpec

TopologyLevel defines the desired state of TopologyLevel

Field Description

Field	Description
`nodeLabel` [Required] `string`	nodeLabel indicates the name of the node label for a specific topology level. Examples: cloud.provider.com/topology-block cloud.provider.com/topology-rack

nodeLabel [Required]
string

nodeLabel indicates the name of the node label for a specific topology level.

Examples:

cloud.provider.com/topology-block
cloud.provider.com/topology-rack

`TopologySpec`

Appears in:

Topology

TopologySpec defines the desired state of Topology

Field	Description
`levels` [Required] `[]TopologyLevel`	levels define the levels of topology.

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Last modified October 25, 2024: HierarchicalCohort: Remove unused status field (#3311) (a9e198c2)