Skip to content
🎉 Launch sale:50% off everything over $22 — automatically applied at checkout· ends Aug 2Shop the sale →
DevOps AI ToolKit
Newsletter
All prompts
AI for Kubernetes & Helm Difficulty: Advanced ClaudeChatGPT

Kubernetes Server-Side Apply Field Manager Conflict Prompt

Resolve Server-Side Apply field ownership conflicts where controllers, GitOps tools, and kubectl fight over the same fields — understanding field managers, shared ownership, and when to force-apply safely.

Target user
Platform engineers running GitOps and controllers against shared Kubernetes objects
Difficulty
Advanced
Tools
Claude, ChatGPT

The prompt

You are a senior Kubernetes platform engineer who understands the managedFields machinery behind Server-Side Apply (SSA) and has untangled ownership wars between Argo CD, controllers, and ad-hoc kubectl edits.

I will provide:
- The conflict error (e.g. `Apply failed with N conflicts: conflict with "<manager>" using ...`)
- The object's `metadata.managedFields` (or a description of which actors touch it)
- Who should own which fields (controller vs GitOps vs human), and the apply command/tooling in use

Your job:

1. **Read managedFields** — explain which field manager currently owns the disputed paths and how SSA decides ownership per-field, not per-object.

2. **Classify the conflict** — distinguish a legitimate ownership dispute (two actors both claim a field) from accidental ownership grabbed by a one-off `kubectl edit`/`apply` with a default manager name.

3. **Decide the resolution** — choose between: relinquishing fields (remove them from one actor's manifest), forcing ownership (`--force-conflicts`), or splitting ownership so each actor manages distinct paths; state the consequence of each.

4. **Fix manager identity** — recommend stable `--field-manager` names per tool so ownership is intentional and auditable, and explain why default `kubectl-edit`/`kubectl-client-side-apply` managers cause recurring conflicts.

5. **Handle list/map merge keys** — call out where associative-list merge semantics (containers, ports, env) cause surprises and how `x-kubernetes-list-type` affects merges.

6. **Prevent recurrence** — propose guardrails (ban interactive edits on GitOps-managed objects, ignore-differences config, migration off client-side apply annotations).

Output as: (a) the ownership map of the disputed fields, (b) the specific command or manifest change to resolve it, (c) whether `--force-conflicts` is safe here and why, (d) the prevention guardrail.

Default to caution: do not blanket-recommend `--force-conflicts` in automation — it silently overwrites another controller's intent; prefer explicit ownership splits.

Run this prompt with AI

Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.

Related prompts

More Kubernetes & Helm prompts & error guides

Browse every Kubernetes & Helm prompt and troubleshooting guide in one place.

Free download · 368-page PDF

Reading prompts? Get all 500 in one free PDF

500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.

  • 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
  • Instant PDF download — yours free, forever
  • Plus one practical AI-workflow email a week (no spam)

Single opt-in · unsubscribe anytime · no spam.