Afeta
Equipes que usam a documentação de deploy com Helm. Esta atualização se aplica ao portal público de documentação. Ela não muda o comportamento da API em runtime, a menos que a documentação do produto vinculada diga o contrário.
O que mudou
A documentação do Helm passou por uma reestruturação completa nesta semana. O que antes era um punhado de páginas monolíticas agora é uma referência organizada por produto, cobrindo instalação, upgrade, migração, solução de problemas e configuração de produção.
Nova estrutura: Helm por produto
A seção de Helm foi reorganizada sob a aba Plataforma e agrupada por produto, para você ir direto à referência do que está fazendo deploy.
- Visão geral do Helm — Hub central com links para toda a documentação de Helm específica de cada produto
- Compatibilidade de versões — Matriz atualizada com a documentação do registry OCI e o esclarecimento sobre versionamento de charts
Midaz (16 novas páginas)
A documentação de Helm do Midaz foi dividida de duas páginas grandes em seções focadas e navegáveis:- Instalar e configurar — Instalação, Referência de configuração, Dependências, Ingress, Referência de componentes
- Upgrade — Guia de upgrade, Checklist de upgrade
- Migração — v3 → v4, v4 → v5, v3 → v5
- Operações — Solução de problemas, Rollback e solução de problemas, Observabilidade, Desinstalação
- Produção — Referência de valores de produção — values.yaml completo e comentado para deploys de produção
Plugins (7 novas páginas)
Cada plugin agora tem sua própria página de referência de Helm:Outros produtos (4 novas páginas)
Novo: página de modelos de deploy
Uma nova página SaaS e BYOC explica os dois modelos de deploy (SaaS totalmente gerenciado vs. Bring Your Own Cloud), incluindo quando usar cada um, o que Helm significa no contexto BYOC e links para toda a documentação de Helm específica de cada produto.
Páginas removidas
As páginas monolíticas a seguir foram removidas e seu conteúdo foi redistribuído na nova estrutura:helm-overview.mdx(antiga seção do Midaz) — substituída pela Visão geral do Helm na Plataforma e pela Visão geral do Helm do Midazhelm-upgrade-guide.mdx— substituída pelo Guia de upgrade dedicado e pelas páginas de migraçãoupgrading-helm.mdx— conteúdo incorporado ao guia de upgrade e ao checklist
Melhorias de conteúdo
- Contexto de negócio — As páginas de Helm agora incluem contexto de decisão e a explicação de “por que isso importa”, não apenas instruções de configuração
- Orientação de produção — Nova referência de valores de produção, com valores comentados e recomendações de recursos
- Solução de problemas — Solução de problemas completa, baseada em sintomas, cobrindo pods, ingress, bancos de dados, RabbitMQ e operações de Helm
- Caminhos de migração — Guias de migração detalhados, passo a passo, para cada transição de versão suportada (v3→v4, v4→v5, v3→v5), com breaking changes e procedimentos de rollback
- Navegação — Sentence case aplicado a todos os cabeçalhos de Helm, links duplicados removidos das páginas de deploy
- Portas de rede — Referência de portas de rede padrão atualizada
Impacto
Esta é uma atualização de documentação. As integrações existentes não precisam de migração apenas por esta nota de release.
O que você precisa fazer
1
Use a documentação de Helm organizada por produto ao planejar instalação, upgrade, migração, solução de problemas ou configuração de produção.