> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Melhoria na documentação do Helm

> A documentação do Helm agora fica na aba Plataforma, como uma referência organizada por produto que cobre instalação, upgrades, migração e configuração de produção.

10 de abril de 2026Atualização da documentaçãoRevisão recomendada

## 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**](https://github.com/LerianStudio/helm): Hub central com links para toda a documentação de Helm específica de cada produto
* [**Compatibilidade de versões**](https://github.com/LerianStudio/helm/blob/main/README.md#application-version-mapping): 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](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.md#install-midaz-helm-chart), [Referência de configuração](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.params.md), [Dependências](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.md#dependencies), [Ingress](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.md#configuring-ingress-for-different-controllers), [Referência de componentes](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.md#midaz-components)
* **Upgrade**: [Guia de upgrade](https://github.com/LerianStudio/helm/tree/main/charts/midaz/docs), Checklist de upgrade
* **Migração**: [v3 → v4](https://github.com/LerianStudio/helm/blob/main/charts/midaz/docs/UPGRADE-4.0.md), [v4 → v5](https://github.com/LerianStudio/helm/blob/main/charts/midaz/docs/UPGRADE-5.0.md), v3 → v5
* **Operações**: Solução de problemas, Rollback e solução de problemas, [Observabilidade](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.md#observability), Desinstalação
* **Produção**: [Referência de valores de produção](https://github.com/LerianStudio/helm/blob/main/charts/midaz/values.yaml) (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:

* [**Visão geral dos plugins**](https://github.com/LerianStudio/helm)
* [Pix](https://github.com/LerianStudio/helm/tree/main/charts/plugin-br-pix-jd), [Pix Indireto](https://github.com/LerianStudio/helm/tree/main/charts/plugin-br-pix-indirect-btg), [CRM](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.md#crm-customer-relationship-management), [Fees](https://github.com/LerianStudio/helm/tree/main/charts/plugin-fees), [Bank Transfer](https://github.com/LerianStudio/helm/tree/main/charts/plugin-br-bank-transfer)

### Outros produtos (4 novas páginas)

* [**Reporter**](https://github.com/LerianStudio/helm/tree/main/charts/reporter)
* [**Console**](https://github.com/LerianStudio/helm/tree/main/charts/product-console)
* [**Access Manager**](https://github.com/LerianStudio/helm/tree/main/charts/plugin-access-manager)
* [**Infraestrutura**](https://github.com/LerianStudio/helm/tree/main/charts/alloy-lerian)

### Novo: página de modelos de deploy

***

Uma nova página [SaaS e BYOC](https://docs.lerian.studio/pt/start-here/evaluate-and-deploy/deployment-models.md) 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](https://github.com/LerianStudio/helm) e pela [Visão geral do Helm do Midaz](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.md)
* `helm-upgrade-guide.mdx`: substituída pelo [Guia de upgrade](https://github.com/LerianStudio/helm/tree/main/charts/midaz/docs) dedicado e pelas páginas de migração
* `upgrading-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" além das 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 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](https://docs.lerian.studio/pt/reference/default-network-ports.md) 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

***

**Step 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.

### Prazo

Nenhum.

### Por quê

A documentação do Helm passou para a estrutura da Plataforma e foi reorganizada por produto.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.