Run Plain Pod in Multi-Cluster

Before you begin

1. Check the MultiKueue installation guide on how to properly setup MultiKueue clusters.

2. Follow steps in Run Plain Pods to learn how to enable and configure the pod integration.

Pods created on the manager cluster are automatically gated and receive live status updates from their remote counterparts

Example

Once the setup is complete you can test it by running the examples below:

1. Single plain pod

   kueue-pod.yaml

   apiVersion: v1
   kind: Pod
   metadata:
     generateName: kueue-sleep-
     labels:
       kueue.x-k8s.io/queue-name: user-queue
   spec:
     containers:
       - name: sleep
         image: busybox
         command:
           - sleep
         args:
           - 3s
         resources:
           requests:
             cpu: 3
     restartPolicy: OnFailure

2. Group of pods

   kueue-pod-group.yaml

   ---
   apiVersion: v1
   kind: Pod
   metadata:
     generateName: sample-leader-
     labels:
       kueue.x-k8s.io/queue-name: user-queue
       kueue.x-k8s.io/pod-group-name: "sample-group"
     annotations:
       kueue.x-k8s.io/pod-group-total-count: "2"
   spec:
     restartPolicy: Never
     containers:
     - name: sleep
       image: busybox
       command: ["sh", "-c", 'echo "hello world from the leader pod" && sleep 3']
       resources:
         requests:
           cpu: 3
   ---
   apiVersion: v1
   kind: Pod
   metadata:
     generateName: sample-worker-
     labels:
       kueue.x-k8s.io/queue-name: user-queue
       kueue.x-k8s.io/pod-group-name: "sample-group"
     annotations:
       kueue.x-k8s.io/pod-group-total-count: "2"
   spec:
     restartPolicy: Never
     containers:
     - name: sleep
       image: busybox
       command: ["sh", "-c", 'echo "hello world from the worker pod" && sleep 2']
       resources:
         requests:
           cpu: 3