> ## 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 Fees via Helm

> Faça o deploy do serviço Fees standalone no Kubernetes com o chart plugin-fees-helm, incluindo os secrets obrigatórios e a dependência de MongoDB.

No Midaz v4, o Ledger unificado contém o Fees como módulo e o serve em `/v2`. O chart `plugin-fees-helm` faz o deploy do serviço Fees standalone que os releases de aplicação anteriores à v4 esperam. Faça o deploy deste chart apenas quando você operar um desses releases.

## O que o chart instala

***

O chart instala uma carga de trabalho do Fees: um Deployment, um Service, um ConfigMap, um Secret, uma ServiceAccount, um HorizontalPodAutoscaler, um PodDisruptionBudget e um Ingress opcional. Ele também roda um job de bootstrap do MongoDB.

O chart empacota um subchart MongoDB e o habilita por padrão. Defina `mongodb.enabled: false` para apontar o serviço para um MongoDB gerenciado externamente.

## Pré-requisitos

***

* Um deploy do Midaz em execução.
* O chart `plugin-access-manager`, quando você define `fees.configmap.PLUGIN_AUTH_ENABLED` como `true`. O chart desabilita essa flag por padrão.
* Uma licença Lerian Enterprise válida.
* Helm 3.8 ou posterior para o suporte a registry OCI.

## Instalação

***

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

Leia primeiro a versão atual do chart:

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

## Values que você deve definir

***

Coloque cada credencial em `fees.secrets`, ou aponte o release para o seu próprio Secret com `fees.useExistingSecret`. Defina estas chaves:

| Chave                          | Quando é obrigatória                                                            |
| :----------------------------- | :------------------------------------------------------------------------------ |
| `CLIENT_SECRET`                | Sempre. Ela forma par com `CLIENT_ID`, que fica ao lado dela em `fees.secrets`. |
| `LICENSE_KEY`                  | Sempre, em produção.                                                            |
| `ORGANIZATION_IDS`             | Sempre. Ela limita a licença às suas organizações.                              |
| `MULTI_TENANT_SERVICE_API_KEY` | Quando você habilita multi-tenancy.                                             |
| `MULTI_TENANT_REDIS_PASSWORD`  | Quando você habilita multi-tenancy.                                             |

Deixe a senha do MongoDB vazia enquanto o subchart empacotado estiver habilitado. O subchart a gera no próprio Secret, e o serviço a lê de lá. Defina `fees.secrets.MONGO_PASSWORD` apenas para um MongoDB externo que não tenha um Secret próprio.

## Upgrade e desinstalação

***

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

```bash theme={null}
helm uninstall plugin-fees -n midaz-plugins
```

A desinstalação remove os recursos do Kubernetes. Ela não apaga os PersistentVolumeClaims do MongoDB. Apague-os separadamente quando você quiser recuperar o armazenamento.

## Recursos

***

* [Charts Helm dos plugins](/pt/platform/deploy/plugins/plugins-helm-overview)
* [Repositório de charts Helm](https://github.com/LerianStudio/helm)