Add ai-ml/gke-ray/kueue-concurrent-admission: ephemeral RayJobs with Kueue Concurrent Admission

[gangli113]

Description

This PR adds a new sample under ai-ml/gke-ray/kueue-concurrent-admission that demonstrates how to run
ephemeral RayJobs across multiple resource flavors using Kueue's Concurrent Admission feature on GKE.

Concurrent Admission lets a ClusterQueue evaluate multiple ResourceFlavors at the same time, so an
ephemeral RayJob can start on whichever flavor has capacity first (for example, a reservation-backed GPU
node pool or a DWS Flex-Start node pool) instead of waiting on strict flavor ordering. This reduces
RayJob start latency for bursty, short-lived GPU workloads.

These manifests back the user guide
Start RayJobs faster across multiple resource flavors.

Files added

File	Purpose
ai-ml/gke-ray/kueue-concurrent-admission/kueue-setup.yaml	Two ResourceFlavors (reservation-flavor, dws-flex-flavor), a ClusterQueue with concurrentAdmissionPolicy (migration.mode: TryPreferredFlavors, constraints.lastAcceptableFlavorName: reservation-flavor), and a LocalQueue (user-queue).
ai-ml/gke-ray/kueue-concurrent-admission/ephemeral-rayjob.yaml	An ephemeral RayJob (shutdownAfterJobFinishes: true) labeled with kueue.x-k8s.io/queue-name: user-queue, running 3 single-GPU Ray tasks on 3 worker replicas.
ai-ml/gke-ray/kueue-concurrent-admission/README.md	Sample overview, manifest descriptions, and quickstart commands.

Notes

• Uses the Kueue kueue.x-k8s.io/v1beta2 API, which is required for concurrentAdmissionPolicy.
• Queue targeting uses the kueue.x-k8s.io/queue-name label (not an annotation), consistent with Fix kueue.x-k8s.io/queue-name metadata field  #2052.
• Region tags added: gke_ai_ml_gke_ray_kueue_concurrent_admission_kueue_setup and
  gke_ai_ml_gke_ray_kueue_concurrent_admission_ephemeral_rayjob.

Tasks

• The contributing guide has been read and followed.
• The samples added / modified have been fully tested.
• Workflow files have been added / modified, if applicable.
• Region tags have been properly added, if new samples.
• Editable variables have been used, where applicable.
• All dependencies are set to up-to-date versions, as applicable.
• Merge this pull-request for me once it is approved.

[snippet-bot]

Here is the summary of changes.

You are about to add 2 region tags.

• ai-ml/gke-ray/kueue-concurrent-admission/ephemeral-rayjob.yaml:15, tag gke_ai_ml_gke_ray_kueue_concurrent_admission_ephemeral_rayjob
• ai-ml/gke-ray/kueue-concurrent-admission/kueue-setup.yaml:15, tag gke_ai_ml_gke_ray_kueue_concurrent_admission_kueue_setup

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment