Skip to content

docs: clarify Helm hook delete-policy semantics#26828

Open
Vedant-Mhatre wants to merge 2 commits intoargoproj:masterfrom
Vedant-Mhatre:docs-hook-delete-policy-semantics
Open

docs: clarify Helm hook delete-policy semantics#26828
Vedant-Mhatre wants to merge 2 commits intoargoproj:masterfrom
Vedant-Mhatre:docs-hook-delete-policy-semantics

Conversation

@Vedant-Mhatre
Copy link

Fixes #26702

Summary

Clarify that Helm hook annotations are mapped onto Argo CD hooks at the annotation level, but hook delete-policy evaluation still follows Argo CD sync phases and sync result semantics rather than Helm's per-hook-event lifecycle.

What Changed

  • clarified the Helm hook mapping docs for helm.sh/hook-delete-policy
  • updated the hook cleanup docs so HookSucceeded reflects overall sync semantics
  • documented why passive resources such as ServiceAccount can behave differently from terminal hook resources such as Job or Workflow

Verification

  • docs-only change
  • reviewed against the current issue discussion and existing hook lifecycle documentation

@bunnyshell
Copy link

bunnyshell bot commented Mar 14, 2026

🔴 Preview Environment stopped on Bunnyshell

See: Environment Details | Pipeline Logs

Available commands (reply to this comment):

  • 🔵 /bns:start to start the environment
  • 🚀 /bns:deploy to redeploy the environment
  • /bns:delete to remove the environment

Signed-off-by: Vedant-Mhatre <vedantmh@gmail.com>
@Vedant-Mhatre Vedant-Mhatre force-pushed the docs-hook-delete-policy-semantics branch from f2aea30 to c5f4af4 Compare March 14, 2026 00:58
Copy link
Member

@ishitasequeira ishitasequeira left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!!

Copy link
Contributor

@pjiang-dev pjiang-dev left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Hook delete policy annotation evaluation behavior discrepancy between helm/argo

3 participants