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

# Guía de actualización

> Actualiza tu despliegue Helm de Midaz a v5.x — quick start, rutas de migración por versión, cambios incompatibles y verificaciones posteriores.

Esta guía te acompaña durante la actualización de tu despliegue de Midaz Helm a la última versión (v5.x.x).

Encontrarás un inicio rápido para operadores experimentados, seguido de rutas de migración desde versiones anteriores, cambios importantes detallados y verificaciones post-actualización.

<Tip>
  ¿Necesitas un repaso sobre la instalación de Midaz con Helm? Consulta la guía [Instalar Midaz con Helm](/es/platform/helm/midaz/midaz-installation) en **Estrategias de despliegue** antes de comenzar tu actualización.
</Tip>

## Inicio rápido

***

### 1. Verifica los requisitos previos

* **Helm v3.8+** instalado y disponible (helm version).
* **Kubernetes v1.20+** clúster en ejecución.
* **Respaldo** de tu instalación existente.

### 2. Identifica tu versión actual

<CodeGroup>
  ```bash Shell theme={null}
  helm list -n midaz
  ```
</CodeGroup>

### 3. Ejecuta el comando de actualización

<CodeGroup>
  ```bash Shell theme={null}
  helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm --version 5.x.x -n midaz
  ```
</CodeGroup>

### 4. Verifica la actualización

<CodeGroup>
  ```bash Shell theme={null}
  helm list -n midaz
  kubectl get pods -n midaz
  ```
</CodeGroup>

## Compatibilidad de versiones

***

| Componente | v3.x  | v4.x  | v5.x  |
| :--------- | :---- | :---- | :---- |
| Kubernetes | 1.20+ | 1.20+ | 1.20+ |
| Helm       | 3.8+  | 3.8+  | 3.8+  |
| PostgreSQL | 13+   | 13+   | 13+   |
| MongoDB    | 4.4+  | 4.4+  | 4.4+  |
| Valkey     | 7.x   | 7.x   | 7.x   |

## Actualización de Midaz core

***

<Warning>
  Al actualizar Midaz o cualquier plugin, siempre actualiza el chart de Helm correspondiente.

  Actualizar versiones de aplicaciones sin actualizar el chart de Helm puede provocar fallos en el despliegue o entornos inconsistentes.
</Warning>

### 1. Verificar versiones disponibles

Lista las versiones de charts disponibles desde el registro OCI:

* **Listar versiones disponibles**

```bash theme={null}
helm search repo lerianstudio/midaz-helm --versions
```

* **o revisa las etiquetas de GitHub:**
  * Visita [https://github.com/LerianStudio/helm/tags](https://github.com/LerianStudio/helm/tags)
  * Filtra por el prefijo "midaz-v"

### 2. Revisar cambios (opcional)

Compara tus valores actuales con los valores por defecto del nuevo chart:

```bash theme={null}
helm show values oci://registry-1.docker.io/lerianstudio/midaz-helm --version 5.7.0 > new-defaults.yaml
```

### 3. Ejecutar la actualización

Actualiza a tu versión objetivo:

* **Actualizar con valores existentes**

```bash theme={null}
helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
  --version 5.7.0 \
  -n midaz \
  -f midaz-values-backup.yaml
```

* **Actualizar con nuevos valores**

```bash theme={null}
helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
  --version 5.7.0 \
  -n midaz \
  -f my-custom-values.yaml
```

<Warning>
  Si tienes valores personalizados, siempre pásalos con `-f` para evitar perder tu configuración durante la actualización.
</Warning>

### 4. Verificar la actualización

* **Verificar estado del release**

```bash theme={null}
helm list -n midaz
```

* **Verificar si los pods están en ejecución**

```bash theme={null}
kubectl get pods -n midaz
```

* **Revisar logs de los pods en busca de errores**

<Tabs>
  <Tab title="Ledger (v5.x)">
    ```bash theme={null}
    kubectl logs -n midaz deployment/midaz-ledger --tail=50
    kubectl logs -n midaz deployment/midaz-crm --tail=50
    ```
  </Tab>

  <Tab title="Legacy (v4.x)">
    ```bash theme={null}
    kubectl logs -n midaz deployment/midaz-onboarding --tail=50
    kubectl logs -n midaz deployment/midaz-transaction --tail=50
    ```
  </Tab>
</Tabs>

Todos los pods deben mostrar estado `Running` y estado `READY`.

## Actualización de plugins

***

<Note>
  Siempre actualiza Midaz Core **antes** de actualizar los plugins. Los plugins dependen de las APIs de Midaz Core.
</Note>

### CRM

<Note>
  A partir de Midaz v5.x, CRM está integrado en el chart de Helm principal de Midaz. El chart standalone plugin-crm solo es necesario para despliegues v4.x.
</Note>

<Tabs>
  <Tab title="Integrado (v5.x)">
    CRM está incluido en el chart principal de Midaz. No se necesita actualización separada.

    * **Verificar pods de CRM**

    ```bash theme={null}
    kubectl get pods -n midaz -l app=midaz-crm
    ```
  </Tab>

  <Tab title="Standalone (v4.x)">
    * **Actualizar plugin CRM**

    ```bash theme={null}
    helm upgrade plugin-crm oci://registry-1.docker.io/lerianstudio/plugin-crm \
      --version 4.0.0 \
      -n midaz \
      -f plugin-crm-values-backup.yaml
    ```

    * **Verificar pods de CRM**

    ```bash theme={null}
    kubectl get pods -n midaz -l app=plugin-crm
    ```
  </Tab>
</Tabs>

### Fees Engine

* **Actualizar Fees Engine**

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

* **Verificar pods de Fees Engine**

```bash theme={null}
kubectl get pods -n midaz -l app=plugin-fees
```

### Pix

* **Actualizar plugin Pix**

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

* **Verificar pods de Pix**

```bash theme={null}
kubectl get pods -n midaz -l app=plugin-pix
```