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

# Referência de componentes do Midaz

> Configure as cargas de trabalho de Ledger, CRM e Tracer no Helm chart do Midaz.

<Warning>
  As orientações de CRM e Fees marcadas como legado nesta página valem apenas para um release legado existente. O Midaz v4 faz deploy do Ledger unificado e serve CRM e Fees em `/v2`.
</Warning>

O chart do Midaz tem as cargas de trabalho Ledger, CRM e Tracer. O chart habilita o Ledger por padrão. Ele desabilita CRM e Tracer por padrão. O CRM é um módulo dentro do chart `midaz-helm`. Você o habilita com o bloco de values `crm`. Não existe chart de CRM.

A tag de imagem de cada carga de trabalho usa por padrão a versão da aplicação de que o chart faz deploy. Leia os padrões atuais com `helm show values oci://registry-1.docker.io/lerianstudio/midaz-helm`.

## Ledger

***

O Ledger combina os módulos onboarding e transaction em um único deployment.

| Parâmetro                        | Padrão                      |
| :------------------------------- | :-------------------------- |
| `ledger.enabled`                 | `true`                      |
| `ledger.name`                    | `ledger`                    |
| `ledger.replicaCount`            | `2`                         |
| `ledger.image.repository`        | `lerianstudio/midaz-ledger` |
| `ledger.service.type`            | `ClusterIP`                 |
| `ledger.service.port`            | `3002`                      |
| `ledger.ingress.enabled`         | `false`                     |
| `ledger.autoscaling.enabled`     | `true`                      |
| `ledger.autoscaling.minReplicas` | `2`                         |
| `ledger.autoscaling.maxReplicas` | `9`                         |
| `ledger.useExistingSecret`       | `false`                     |

A probe de liveness do Ledger usa `/health` por padrão. A probe de readiness dele usa `/readyz` por padrão. Os dois blocos de probe aceitam overrides em `ledger.livenessProbe` e `ledger.readinessProbe`.

### Secret existente

Use um Secret do Kubernetes existente em vez de um Secret do Ledger gerenciado pelo chart:

```yaml theme={null}
ledger:
  useExistingSecret: true
  existingSecretName: midaz-ledger
```

O Secret deve conter as credenciais exigidas pelos serviços que você configura. Consulte a [Referência de configuração](/pt/platform/deploy/midaz/midaz-configuration-reference).

## CRM

***

O chart faz deploy do CRM como uma carga de trabalho opcional ao lado do Ledger.

| Parâmetro                     | Padrão                   |
| :---------------------------- | :----------------------- |
| `crm.enabled`                 | `false`                  |
| `crm.name`                    | `crm`                    |
| `crm.replicaCount`            | `1`                      |
| `crm.image.repository`        | `lerianstudio/midaz-crm` |
| `crm.service.type`            | `ClusterIP`              |
| `crm.service.port`            | `4003`                   |
| `crm.ingress.enabled`         | `false`                  |
| `crm.autoscaling.enabled`     | `true`                   |
| `crm.autoscaling.minReplicas` | `1`                      |
| `crm.autoscaling.maxReplicas` | `3`                      |
| `crm.useExistingSecret`       | `false`                  |

Habilite o CRM no seu arquivo de override:

```yaml theme={null}
crm:
  enabled: true
  useExistingSecret: true
  existingSecretName: midaz-crm
```

Crie `midaz-crm` antes do deploy e inclua `LCRYPTO_HASH_SECRET_KEY` e `LCRYPTO_ENCRYPT_SECRET_KEY`. O CRM usa `/health` para liveness e `/readyz` para readiness por padrão. Configure ingress, recursos, autoscaling e secrets dele na chave `crm`.

## Tracer

***

O Tracer é uma carga de trabalho opcional de validação de transações no chart do Midaz.

| Parâmetro                        | Padrão                      |
| :------------------------------- | :-------------------------- |
| `tracer.enabled`                 | `false`                     |
| `tracer.name`                    | `tracer`                    |
| `tracer.replicaCount`            | `1`                         |
| `tracer.image.repository`        | `lerianstudio/midaz-tracer` |
| `tracer.service.type`            | `ClusterIP`                 |
| `tracer.service.port`            | `4020`                      |
| `tracer.ingress.enabled`         | `false`                     |
| `tracer.autoscaling.enabled`     | `true`                      |
| `tracer.autoscaling.minReplicas` | `1`                         |
| `tracer.autoscaling.maxReplicas` | `5`                         |
| `tracer.migrations.enabled`      | `true`                      |
| `tracer.useExistingSecret`       | `false`                     |

Habilite a carga de trabalho e aponte o Ledger para ela quando quiser validação de transações no mesmo release:

```yaml theme={null}
tracer:
  enabled: true

ledger:
  configmap:
    TRACER_BASE_URL: http://midaz-tracer:4020
    TRACER_TRANSPORT: rest
```

O Tracer usa `/health` para liveness e `/readyz` para readiness por padrão. O Tracer expõe a porta do serviço gRPC apenas quando você define `tracer.configmap.TRACER_GRPC_PORT`. Configure os dois lados antes de mudar `TRACER_TRANSPORT` para `grpc`.

<Note>
  Leia a interface completa do chart a partir da versão de que você faz deploy:
  `helm show values oci://registry-1.docker.io/lerianstudio/midaz-helm --version <version>`. Ela traz campos não listados aqui.
</Note>