Pod Compatibility for Joulie

Joulie uses Kubernetes scheduling constraints as the single source of truth for workload placement intent.

Power profile supply is exposed on node label:

  • joulie.io/power-profile=performance
  • joulie.io/power-profile=eco
  • joulie.io/draining=true|false (independent transition flag)

Workload behavior:

  • performance workload (recommended): require joulie.io/power-profile NotIn ["eco"]
  • eco workload: require joulie.io/power-profile=eco
  • unconstrained workload: no power-profile affinity, can run on either profile

Best-effort Pod (unconstrained, starting point)

This is the default and recommended starting spec. Do not set power-profile affinity: Kubernetes can schedule the pod on either eco or performance nodes.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-workload
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-workload
  template:
    metadata:
      labels:
        app: my-workload
    spec:
      containers:
      - name: app
        image: ghcr.io/example/app:latest
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-workload
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-workload
  template:
    metadata:
      labels:
        app: my-workload
    spec:
      affinity:
        nodeAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
            - matchExpressions:
              - key: joulie.io/power-profile
                operator: NotIn
                values: ["eco"]
      containers:
      - name: app
        image: ghcr.io/example/app:latest

Why this is recommended:

  • it avoids eco nodes while still allowing high-performance nodes which are not managed by Joulie;
  • explicitly requiring performance can exclude unlabeled nodes that are still valid for performance workloads and are managed by Joulie.

Eco-only Pod (advanced, lines to add)

This is an advanced/rare pattern. Use it only when you explicitly need jobs to run on eco supply. In most cases, users should either:

  • use NotIn ["eco"] for performance-sensitive pods, or
  • keep pods unconstrained (best-effort) and let Joulie manage power behavior.

If you choose eco-only, adding joulie.io/draining=false avoids nodes in transition from performance to eco, which are labelled with joulie.io/power-profile=eco but still have a performance power profile (DrainingPerformance state).

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-workload
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-workload
  template:
    metadata:
      labels:
        app: my-workload
    spec:
      affinity:
        nodeAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
            - matchExpressions:
              - key: joulie.io/power-profile
                operator: In
                values: ["eco"]
              - key: joulie.io/draining
                operator: In
                values: ["false"]
      containers:
      - name: app
        image: ghcr.io/example/app:latest

Reference manifests: