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

# Pix con Helm

> Despliega el plugin de Pix de participante directo en Kubernetes con el chart plugin-br-pix-direct-jd-helm, incluidos sus secrets obligatorios y su restricción de nombre de release.

El plugin de Pix procesa pagos instantáneos Pix brasileños como participante directo. El nombre del chart es `plugin-br-pix-direct-jd-helm`.

<Note>
  El plugin de Pix requiere una licencia Enterprise. Contacta a Lerian para obtener acceso a las imágenes del plugin y a las credenciales de despliegue.
</Note>

## Qué instala el chart

***

El chart instala tres componentes:

* **Pix**: el servicio de pagos, con un Deployment, un Service, un ConfigMap, un Secret, un HorizontalPodAutoscaler, un PodDisruptionBudget y un Ingress opcional.
* **QR Code**: un Deployment separado con el mismo conjunto de recursos, para la generación de códigos QR.
* **Job**: un CronJob con su propio ConfigMap, Secret y Service.

El chart incluye un subchart de PostgreSQL y lo habilita de forma predeterminada. Define `postgresql.enabled: false` para usar un PostgreSQL administrado externamente.

## Prerrequisitos

***

* Un despliegue de Midaz en ejecución.
* Conectividad a la infraestructura de pagos brasileña a través del canal de participante directo.
* Licencia Enterprise y credenciales del registry.
* Helm 3.8 o posterior para la compatibilidad con registries OCI.

## Instalación

***

Lee primero la versión actual del chart y luego instala:

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

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

<Warning>
  Instala el release como `plugin-br-pix-direct-jd` en el namespace `midaz-plugins`, o define tú mismo el host de la base de datos. Con el PostgreSQL incluido, `DATABASE_HOST` toma de forma predeterminada un nombre de Service construido a partir de ese nombre de release y ese namespace. Con cualquier otro nombre, define `pix.configmap.DATABASE_HOST` y el `DATABASE_HOST` del job con el Service de PostgreSQL.
</Warning>

## Values que debes definir

***

Pon cada credencial en `pix.secrets`, o apunta el release a tu propio Secret con `pix.useExistingSecret`. Define estas claves:

| Clave                                       | Propósito                                      |
| :------------------------------------------ | :--------------------------------------------- |
| `LICENSE_KEY`                               | Validación de la licencia Enterprise.          |
| `MIDAZ_CLIENT_ID` y `MIDAZ_CLIENT_SECRET`   | Acceso máquina a máquina a Midaz.              |
| `JD_CLIENT_ID` y `JD_SECRET`                | Acceso al canal de participante directo.       |
| `JD_PIX_CLIENT_ID` y `JD_PIX_CLIENT_SECRET` | Acceso al servicio de Pix en ese canal.        |
| `SECRET_KEY_BASE`                           | Firma los datos de sesión del propio servicio. |

Deja `DATABASE_PASSWORD` y `POSTGRES_PASSWORD` vacíos mientras el subchart incluido esté habilitado. El subchart genera la contraseña en su propio Secret, y tanto el Deployment como el CronJob la leen de ahí. Defínelos solo para un PostgreSQL externo que no tenga su propio Secret existente.

## Actualización y desinstalación

***

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

```bash theme={null}
helm uninstall plugin-br-pix-direct-jd -n midaz-plugins
```

## Recursos

***

* [Documentación de Pix](/es/interfaces/pix/pix-overview)
* [Helm charts de plugins](/es/platform/deploy/plugins/plugins-helm-overview)
* [Repositorio de Helm charts](https://github.com/LerianStudio/helm)