Troubleshooting

Troubleshooting common Cluster Orchestrator issues

DaemonSet pods not scheduling on Harness-managed nodes

Cluster Orchestrator does not automatically manage DaemonSet scheduling. You must add tolerations to your DaemonSets manually.

Option 1: Run DaemonSet on ALL Nodes

If you want your DaemonSet to run on every node in the cluster (including Harness-managed nodes), add a universal toleration:

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: my-daemonset
  namespace: my-namespace
spec:
  selector:
    matchLabels:
      app: my-daemonset
  template:
    metadata:
      labels:
        app: my-daemonset
    spec:
      tolerations:
        - operator: Exists
      containers:
        - name: my-container
          image: my-image:latest

The `operator: Exists` toleration matches any taint, ensuring the DaemonSet runs on all nodes regardless of taints.

Option 2: Run DaemonSet ONLY on Harness-Managed Nodes

If you want your DaemonSet to run exclusively on Harness-managed nodes, add a specific toleration:

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: my-daemonset
  namespace: my-namespace
spec:
  selector:
    matchLabels:
      app: my-daemonset
  template:
    metadata:
      labels:
        app: my-daemonset
    spec:
      tolerations:
        - key: ccm.harness.io/spot-ready
          operator: Exists
          effect: NoSchedule
      containers:
        - name: my-container
          image: my-image:latest

This toleration only matches the Harness taint, so the DaemonSet will only schedule on nodes with this specific taint.

Option 3: Run DaemonSet on Specific Node Types

If you want your DaemonSet to run only on specific Harness-managed node types, use tolerations with explicit values:

Spot Nodes Only

tolerations:
  - key: ccm.harness.io/spot-ready
    operator: Equal
    value: Ready
    effect: NoSchedule

On-Demand Nodes Only

tolerations:
  - key: ccm.harness.io/spot-ready
    operator: Equal
    value: NotReady
    effect: NoSchedule

Both Spot and On-Demand (exclude Disabled)

tolerations:
  - key: ccm.harness.io/spot-ready
    operator: Equal
    value: Ready
    effect: NoSchedule
  - key: ccm.harness.io/spot-ready
    operator: Equal
    value: NotReady
    effect: NoSchedule