Políticas de exclusão de hooks

Por padrão, um recurso de gancho permanece no cluster depois de ser executado. Sem limpeza, Jobs de migração antigos e pods se acumulam a cada nova versão.

Você controla a limpeza com a anotação helm.sh/hook-delete-policy. Ela informa ao Helm exatamente quando excluir um recurso de gancho que ele criou.

A opção mais comum é hook-succeeded. O Helm exclui o recurso de gancho logo depois que ele é concluído com sucesso, mantendo o namespace organizado.

Com hook-succeeded, um gancho que falhou é deixado para trás de propósito. Você pode ler seus registros para descobrir por que a migração falhou antes de fazer a limpeza manualmente. 🔍

A política oposta é hook-failed. O Helm exclui o recurso de gancho somente quando ele falha, o que é adequado para ganchos que você prefere não deixar quebrados.

A terceira opção é before-hook-creation. O Helm exclui uma instância anterior logo antes de criar a nova, evitando conflitos com nomes imutáveis.

Se você não definir nenhuma política, o Helm usará before-hook-creation por padrão. O gancho antigo é excluído logo antes de ser recriado na próxima execução.

As políticas podem ser combinadas em uma lista separada por vírgulas. Combinar before-hook-creation com hook-succeeded remove as execuções antigas e faz a limpeza depois de cada sucesso.

A especificação de um Job não pode ser alterada depois que ele é criado. before-hook-creation evita esse problema ao excluir primeiro o Job antigo, para que cada atualização receba um novo.

Escolha a política de acordo com seu objetivo: fazer a limpeza em caso de sucesso, manter evidências das falhas ou sempre começar do zero. Cada anotação apenas define quando excluir.

Essas políticas só se aplicam a recursos que o Helm criou como ganchos. O Helm os acompanha e os exclui para você, evitando executar manualmente kubectl delete depois de cada versão.

Você quer que um Job de migração seja excluído automaticamente assim que terminar com sucesso.

A anotação hook-delete-policy define quando o Helm exclui um gancho: em caso de sucesso, em caso de falha ou antes da próxima criação. O padrão é before-hook-creation. 🧹