> ## 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 Bank Transfer (TED) via Helm

> Faça o deploy do plugin brasileiro de transferência bancária (TED) no Kubernetes com o chart plugin-br-bank-transfer-helm, incluindo as chaves de criptografia obrigatórias.

O plugin Bank Transfer envia e recebe transferências bancárias brasileiras (TED). Ele liquida as movimentações e as concilia com o ledger. O nome do chart é `plugin-br-bank-transfer-helm`.

<Note>
  O plugin Bank Transfer exige uma licença Enterprise. Entre em contato com a Lerian para obter acesso às imagens do plugin e às credenciais de deploy.
</Note>

## O que o chart instala

***

O chart instala um serviço: 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 migração de banco de dados com o próprio Secret, e jobs de bootstrap para PostgreSQL, MongoDB e RabbitMQ. O chart empacota os subcharts Valkey, PostgreSQL, MongoDB e RabbitMQ. Desabilite qualquer um deles para usar um serviço gerenciado externamente no lugar.

## Pré-requisitos

***

* Um deploy do Midaz em execução. Aponte `bankTransfer.configmap.MIDAZ_BASE_URL` para ele.
* O chart `plugin-access-manager`. O chart define `PLUGIN_AUTH_ENABLED` como `true` por padrão e chama o Access Manager para autenticar as requisições de entrada.
* Acesso ao canal do parceiro que transporta as transferências.
* Licença Enterprise e credenciais de registry.
* Helm 3.8 ou posterior para o suporte a registry OCI.

## Values que você deve definir

***

Em `bankTransfer.configmap`:

| Chave            | Finalidade                                                           |
| :--------------- | :------------------------------------------------------------------- |
| `JD_BASE_URL`    | O endpoint do parceiro que transporta as mensagens de transferência. |
| `JD_ORIGIN_ISPB` | O código ISPB de origem da sua instituição.                          |
| `CRM_BASE_URL`   | O endpoint do CRM que resolve as partes de uma transferência.        |
| `FEES_BASE_URL`  | O endpoint que precifica a transferência.                            |

Em `bankTransfer.secrets`, ou no seu próprio Secret por meio de `bankTransfer.useExistingSecret`:

| Chave                                  | Finalidade                                                                                            |
| :------------------------------------- | :---------------------------------------------------------------------------------------------------- |
| `JD_INCOMING_RAW_XML_ENCRYPTION_KEY`   | Criptografa as mensagens de entrada armazenadas. Use uma chave de 32 bytes codificada em hexadecimal. |
| `RECIPIENT_DETAILS_ENCRYPTION_KEY`     | Criptografa os dados do recebedor armazenados. Use uma chave de 32 bytes codificada em hexadecimal.   |
| `POSTGRES_PASSWORD` e `REDIS_PASSWORD` | Defina-os apenas para bancos de dados gerenciados externamente.                                       |
| `LICENSE_KEY`                          | Validação da licença Enterprise em produção.                                                          |

Deixe `MONGO_PASSWORD` vazio enquanto o subchart MongoDB empacotado estiver habilitado. O subchart gera a senha no próprio Secret.

<Warning>
  Mantenha as duas chaves de criptografia estáveis entre os upgrades. Uma chave alterada torna ilegíveis os registros que a chave anterior criptografou.
</Warning>

## Instalação

***

Leia primeiro a versão atual do chart e depois instale:

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

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

## Upgrade e desinstalação

***

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

```bash theme={null}
helm uninstall plugin-br-bank-transfer -n midaz-plugins
```

A desinstalação remove os recursos do Kubernetes. Ela não apaga o conteúdo dos bancos de dados nem os PersistentVolumeClaims.

## Recursos

***

* [Documentação do Bank Transfer](/pt/interfaces/ted/ted-overview)
* [Charts Helm dos plugins](/pt/platform/deploy/plugins/plugins-helm-overview)
* [Repositório de charts Helm](https://github.com/LerianStudio/helm)