> ## 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.

# Deploy do Lerian Console via Helm

> Referência de instalação do Helm chart e de compatibilidade de versões para o deploy do Lerian Console em Kubernetes, com valores de configuração e orientação de atualização.

O Lerian Console é a interface web unificada para gerenciar produtos Lerian. Ele oferece dashboards para operações de ledger, gerenciamento de contas, monitoramento de transações e configuração de plugins em uma única interface.

## O que o chart instala

***

O chart instala uma carga de trabalho web: um Deployment, um Service, um ConfigMap, um Secret e um ServiceAccount. Ele adiciona um Ingress, um HorizontalPodAutoscaler e um PodDisruptionBudget quando você habilita cada um deles.

O chart empacota um subchart de MongoDB e o habilita por padrão. O Console guarda os próprios dados lá. Defina `mongodb.enabled: false` para apontar o Console para um MongoDB gerenciado externamente.

## Pré-requisitos

***

* Um deploy do Midaz rodando. Os caminhos de serviço de exemplo abaixo supõem que você instala o Midaz no namespace `midaz`. Se você usa outro namespace, sobrescreva os FQDNs conforme necessário.
* Access Manager com deploy feito (para autenticação).
* Helm 3.8 ou posterior para suporte a registry OCI. Use uma [minor release do Kubernetes com suporte atual](https://kubernetes.io/releases/) em produção.

## Configuração principal

***

O chart traz caminhos de API padrão que apontam para os serviços `midaz-onboarding` e `midaz-transaction`. O chart do Midaz removeu os dois serviços na v7.0.0, então você deve definir os caminhos por conta própria. Aponte-os para o serviço Ledger:

```yaml theme={null}
configmap:
  MIDAZ_BASE_PATH: "http://midaz-ledger.midaz.svc.cluster.local:3002/v1"
  MIDAZ_TRANSACTION_BASE_PATH: "http://midaz-ledger.midaz.svc.cluster.local:3002/v1"
```

Defina as credenciais no bloco `secrets` ou aponte o release para o seu próprio Secret com `useExistingSecret`. O chart traz `NEXTAUTH_SECRET`, `MONGODB_PASS` e `PLUGIN_AUTH_CLIENT_SECRET` vazios.

## Valores públicos de configuração

***

O chart atual expõe estes valores `NEXT_PUBLIC_*` no ConfigMap dele. Defina-os no seu arquivo de values para o ambiente do deploy.

| Valor                                             | Padrão do chart    |
| :------------------------------------------------ | :----------------- |
| `NEXT_PUBLIC_MIDAZ_CONSOLE_AVATAR_ALLOWED_FORMAT` | `jpeg,jpg,png,svg` |
| `NEXT_PUBLIC_PLUGIN_AUTH_ENABLED`                 | `false`            |
| `NEXT_PUBLIC_MIDAZ_VERSION`                       | vazio              |

## Registry OCI

***

```bash theme={null}
oci://registry-1.docker.io/lerianstudio/product-console-helm
```

## Instalação

***

Antes de instalar, leia a versão atual do chart e a versão da aplicação que ele entrega:

```bash theme={null}
helm show chart oci://registry-1.docker.io/lerianstudio/product-console-helm
```

```bash theme={null}
helm install console oci://registry-1.docker.io/lerianstudio/product-console-helm --version <version> -n console --create-namespace -f my-values.yaml
```

## Atualização e desinstalação

***

```bash theme={null}
helm upgrade console oci://registry-1.docker.io/lerianstudio/product-console-helm \
  --version <new-version> -n console -f my-values.yaml
```

```bash theme={null}
helm uninstall console -n console
```

Desinstalar remove os recursos do Kubernetes. Confira as configurações de armazenamento do subchart empacotado de MongoDB antes de desinstalar, e faça backup dos dados que você quer manter.

## Recursos

***

* [Documentação do Lerian Console](/pt/platform/console/about-lerian-console)
* [Repositório dos Helm charts](https://github.com/LerianStudio/helm)