Estrutura de Helm Chart

Orientação abrangente para criar, organizar e gerenciar Helm charts para empacotar e implantar aplicações Kubernetes.

Propósito

Esta habilidade fornece instruções passo a passo para construir Helm charts prontos para produção, incluindo estrutura de chart, padrões de templating, gerenciamento de valores e estratégias de validação.

Quando Usar Esta Habilidade

Use esta habilidade quando precisar:

• Criar novos Helm charts do zero
• Empacotar aplicações Kubernetes para distribuição
• Gerenciar implantações multi-ambiente com Helm
• Implementar templating para manifestos Kubernetes reutilizáveis
• Configurar repositórios de Helm charts
• Seguir as melhores práticas e convenções do Helm

Padrões Detalhados e Exemplos Práticos

A documentação detalhada dos padrões está em references/details.md. Leia esse arquivo quando o nível de navegação acima for insuficiente.

Melhores Práticas

1. Use versionamento semântico para versões de chart e de aplicativo
2. Documente todos os valores em values.yaml com comentários
3. Use helpers de template para lógica repetida
4. Valide os charts antes de empacotar
5. Fixe as versões de dependência explicitamente
6. Use condições para recursos opcionais
7. Siga as convenções de nomenclatura (minúsculas, hifens)
8. Inclua NOTES.txt com instruções de uso
9. Adicione labels consistentemente usando helpers
10. Teste as instalações em todos os ambientes

Solução de Problemas

Erros de renderização de template:

helm template my-app ./my-app --debug

Problemas de dependência:

helm dependency update
helm dependency list

Falhas na instalação:

helm install my-app ./my-app --dry-run --debug
kubectl get events --sort-by='.lastTimestamp'

Habilidades Relacionadas

• k8s-manifest-generator - Para criar manifestos Kubernetes base
• gitops-workflow - Para implantações automatizadas de Helm charts