Flux Kustomize Patches Quick Fix - Strategic Merge Patches

Flux Kustomize patches modify Kubernetes resources during kustomize build. Incorrect patch syntax or target selection causes apply failures or wrong modifications. This guide covers the fix.

Quick Fix

Wrong

patches:
- path: patch.yaml

Using inline patch path without specifying target applies the patch to all resources, potentially modifying unintended objects. The patch file contains no target selector.

Right

patches:
- patch: |-
    - op: add
      path: /spec/replicas
      value: 3
    - op: replace
      path: /spec/template/spec/containers/0/image
      value: myapp:v2.0
  target:
    kind: Deployment
    name: my-app

# Expected output after applying the fix
# JSON patch applied to Deployment/my-app only
# Replicas set to 3, image updated to myapp:v2.0
# Other resources unaffected
# Kustomization applies with patched Deployment

Prevention

• Always specify target with kind and optionally name or labelSelector
• Use JSON patches (- op: replace) for precise modifications
• Use strategic merge patches for complex YAML merges
• Test patches with kustomize build . --dry-run before committing
• Order patches by specificity (specific patches before general ones)

DodaTech Tools

Doda Browser's patch preview shows before/after resource YAML. DodaZIP archives patch configurations for documentation. Durga Antivirus Pro validates patch operations.

FAQ