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

# Actualización de Midaz

> Actualiza tu entorno de Midaz de forma segura con actualizaciones locales de Docker y despliegues basados en Helm para mantener tu instalación segura y actualizada.

Mantener Midaz actualizado significa que trabajas con las funciones, los parches de seguridad y las mejoras más recientes. Las actualizaciones periódicas también mantienen a Midaz compatible con otros componentes y ayudan a evitar problemas causados por dependencias obsoletas.

A continuación se muestran los pasos para actualizar Midaz en tu entorno local y usando Helm.

<Note>
  A partir de Midaz 3.x, las imágenes dedicadas de migration-runner (`midaz-ledger-migrations`, `midaz-tracer-migrations`) aplican las migraciones de esquema **antes** del despliegue de la aplicación. Las aplicaciones ya no migran al iniciar. El `make up` local y el chart oficial de Helm configuran esto automáticamente. Consulta [Migraciones de base de datos](/es/products/midaz/database-migrations) para más detalles.
</Note>

## Actualización local de Midaz

***

Si ejecutas Midaz localmente para desarrollo o pruebas, sigue estos pasos para actualizar tu entorno:

### 1. Detén los contenedores en ejecución

Apaga todos los servicios en ejecución antes de hacer las actualizaciones. Esto garantiza un reinicio limpio con las actualizaciones más recientes.

Para detener los contenedores mediante la terminal, sigue estos pasos:

<Steps>
  <Step>
    Abre tu terminal y navega hasta el directorio `midaz`.
  </Step>

  <Step>
    Ejecuta el comando de detención:

    <CodeGroup>
      ```Shell Shell theme={null}
      make down
      ```
    </CodeGroup>
  </Step>
</Steps>

### 2. (Opcional) Limpia los recursos de Docker sin usar

Limpiar los recursos sin usar libera espacio en disco, elimina las capas de caché obsoletas de Docker y evita conflictos por imágenes, contenedores y volúmenes desactualizados.

Para eliminar las imágenes y los contenedores sin usar:

<CodeGroup>
  ```Shell Shell theme={null}
  docker system prune --all
  ```
</CodeGroup>

Para eliminar los volúmenes de Docker sin usar:

<CodeGroup>
  ```Shell Shell theme={null}
  docker volume prune
  ```
</CodeGroup>

### 3. Actualiza tu código local

Descarga los cambios más recientes del repositorio para asegurarte de trabajar con la versión más actualizada:

<CodeGroup>
  ```Shell Shell theme={null}
  git pull origin main
  ```
</CodeGroup>

### 4. Reconstruye y reinicia Midaz

Reconstruye las imágenes de Docker necesarias y vuelve a lanzar la aplicación localmente con las actualizaciones más recientes:

<CodeGroup>
  ```Shell Shell theme={null}
  make up
  ```
</CodeGroup>

## Actualización de Midaz con Helm

***

Para los despliegues que usan Helm, usa los siguientes comandos según tus necesidades.

### Instalación nueva

Haz una instalación nueva cuando configuras Midaz por primera vez o cuando necesitas un despliegue limpio.

#### Instala el Helm de Midaz con un archivo values personalizado

Usa este método si tienes requisitos de configuración específicos definidos en `values.yaml`:

<CodeGroup>
  ```Shell Shell theme={null}
  helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
    --values values.yaml --version <version> -n midaz --create-namespace
  ```
</CodeGroup>

#### Instala el Helm de Midaz con los valores predeterminados

Usa este método para instalar Midaz con los valores predeterminados del chart de Helm:

<CodeGroup>
  ```Shell Shell theme={null}
  helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
    --version <version> -n midaz --create-namespace
  ```
</CodeGroup>

### Actualización de un despliegue existente

Si ya desplegaste Midaz, usa estos comandos para actualizar a una versión nueva conservando las configuraciones.

#### Actualización del Helm de Midaz con un archivo values personalizado

Verifica que las configuraciones personalizadas permanezcan intactas al aplicar la actualización:

<CodeGroup>
  ```Shell Shell theme={null}
  helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
    --values values.yaml --version <new-version> -n midaz --create-namespace
  ```
</CodeGroup>

#### Actualización del Helm de Midaz con los valores predeterminados

Usa este comando si no necesitas aplicar configuraciones personalizadas:

<CodeGroup>
  ```Shell Shell theme={null}
  helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
    --version <new-version> -n midaz --create-namespace
  ```
</CodeGroup>

## Gestión del release de Helm

***

Usa estos comandos para revisar y gestionar tu despliegue de Helm de Midaz.

### Lista los releases instalados

Enumera todos los releases de Helm en el namespace `midaz`, junto con su estado y versión:

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

### Elimina el release de Helm de Midaz

Si necesitas eliminar Midaz por completo de tu clúster, ejecuta:

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

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