OSDOCS-18093: update our docs to use v1beta2 for kueue objects

Author: StephenJamesSmith

modules/kueue-clusterqueue-configuring-cohorts-reference.adoc

@@ -6,20 +6,20 @@
 [id="clusterqueue-configuring-cohorts-reference_{context}"]
 = Configuring cohorts within a cluster queue spec
 
-You can add a cluster queue to a cohort by specifying the name of the cohort in the `.spec.cohort` field of the `ClusterQueue` object, as shown in the following example:
+You can add a cluster queue to a cohort by specifying the name of the cohort in the `.spec.cohortName` field of the `ClusterQueue` object, as shown in the following example:
 
 [source,yaml]
 ----
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: ClusterQueue
 metadata:
   name: cluster-queue
 spec:
 # ...
-  cohort: example-cohort
+  cohortName: example-cohort
 # ...
 ----
 
-All cluster queues that have a matching `spec.cohort` are part of the same cohort.
+All cluster queues that have a matching `spec.cohortName` are part of the same cohort.
 
-If the `spec.cohort` field is omitted, the cluster queue does not belong to any cohort and cannot access borrowable resources.
+If the `spec.cohortName` field is omitted, the cluster queue does not belong to any cohort and cannot access borrowable resources.

modules/kueue-clusterqueue-share-value.adoc

@@ -15,7 +15,7 @@ The `weight` value, or share value, defines a comparative advantage for the clus
 .Example cluster queue with a fair sharing weight configured
 [source,yaml]
 ----
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: ClusterQueue
 metadata:
   name: cluster-queue
@@ -28,7 +28,7 @@ spec:
       resources:
       - name: cpu
         nominalQuota: 9
-  cohort: example-cohort
+  cohortName: example-cohort
   fairSharing:
     weight: 2
 ----

modules/kueue-configuring-clusterqueues.adoc

@@ -25,7 +25,7 @@ include::snippets/prereqs-snippet-yaml.adoc[]
 .Example of a basic `ClusterQueue` object using a single resource flavor
 [source,yaml]
 ----
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: ClusterQueue
 metadata:
   name: cluster-queue

modules/kueue-configuring-localqueue-defaults.adoc

@@ -28,7 +28,7 @@ include::snippets/prereqs-snippet-yaml-1.1.adoc[]
 .Example of a default `LocalQueue` object
 [source,yaml]
 ----
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: LocalQueue
 metadata:
   namespace: team-namespace

modules/kueue-configuring-localqueues.adoc

@@ -23,7 +23,7 @@ include::snippets/prereqs-snippet-yaml.adoc[]
 .Example of a basic `LocalQueue` object
 [source,yaml]
 ----
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: LocalQueue
 metadata:
   namespace: team-namespace

modules/kueue-configuring-resourceflavors.adoc

@@ -23,7 +23,7 @@ include::snippets/prereqs-snippet-yaml.adoc[]
 .Example of an empty `ResourceFlavor` object
 [source,yaml]
 ----
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: ResourceFlavor
 metadata:
   name: default-flavor
@@ -32,7 +32,7 @@ metadata:
 .Example of a custom `ResourceFlavor` object
 [source,yaml]
 ----
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: ResourceFlavor
 metadata:
   name: "x86"

modules/kueue-monitoring-pending-workloads-on-demand.adoc

@@ -26,12 +26,12 @@ The following procedure tells you how to install and test workload monitoring.
 ----
 cat <<EOF| oc create -f -
 ---
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: ResourceFlavor
 metadata:
   name: "default-flavor"
 ---
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: ClusterQueue
 metadata:
   name: "cluster-queue"
@@ -47,7 +47,7 @@ spec:
       - name: "memory"
         nominalQuota: 36Gi
 ---
-apiVersion: kueue.x-k8s.io/v1beta1
+apiVersion: kueue.x-k8s.io/v1beta2
 kind: LocalQueue
 metadata:
   namespace: "default"

modules/kueue-viewing-pending-workloads-clusterqueue.adoc

@@ -15,15 +15,15 @@ To view all pending workloads at the cluster level, administrators can use the `
 +
 [source,terminal]
 ----
-$ oc get --raw "/apis/visibility.kueue.x-k8s.io/v1beta1/clusterqueues/cluster-queue/pendingworkloads"
+$ oc get --raw "/apis/visibility.kueue.x-k8s.io/v1beta2/clusterqueues/cluster-queue/pendingworkloads"
 ----
 +
 .Example output
 [source,yaml]
 ----
 {
   "kind": "PendingWorkloadsSummary",
-  "apiVersion": "visibility.kueue.x-k8s.io/v1beta1",
+  "apiVersion": "visibility.kueue.x-k8s.io/v1beta2",
   "metadata": {
     "creationTimestamp": null
   },
@@ -99,5 +99,5 @@ You can pass the following optional query parameters:
 +
 [source,terminal]
 ----
-$ oc get --raw "/apis/visibility.kueue.x-k8s.io/v1beta1/clusterqueues/cluster-queue/pendingworkloads?limit=1&offset=0"
+$ oc get --raw "/apis/visibility.kueue.x-k8s.io/v1beta2/clusterqueues/cluster-queue/pendingworkloads?limit=1&offset=0"
 ----

modules/kueue-viewing-pending-workloads-localqueue.adoc

@@ -15,15 +15,15 @@ To view the pending workloads submitted by a specific tenant within their namesp
 +
 [source,terminal]
 ----
-$ oc get --raw /apis/visibility.kueue.x-k8s.io/v1beta1/namespaces/default/localqueues/user-queue/pendingworkloads
+$ oc get --raw /apis/visibility.kueue.x-k8s.io/v1beta2/namespaces/default/localqueues/user-queue/pendingworkloads
 ----
 +
 .Example output
 [source,yaml]
 ----
 {
   "kind": "PendingWorkloadsSummary",
-  "apiVersion": "visibility.kueue.x-k8s.io/v1beta1",
+  "apiVersion": "visibility.kueue.x-k8s.io/v1beta2",
   "metadata": {
     "creationTimestamp": null
   },
@@ -99,5 +99,5 @@ You can pass the following optional query parameters:
 +
 [source,terminal]
 ----
-$ oc get --raw "/apis/visibility.kueue.x-k8s.io/v1beta1/namespaces/default/localqueues/user-queue/pendingworkloads?limit=1&offset=0"
+$ oc get --raw "/apis/visibility.kueue.x-k8s.io/v1beta2/namespaces/default/localqueues/user-queue/pendingworkloads?limit=1&offset=0"
 ----