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

# Actualizando Midaz

> Actualiza tu entorno Midaz con seguridad — upgrades locales con Docker y rollouts vía Helm para mantener tu instalación segura y al día.

Mantener Midaz actualizado significa que siempre estás trabajando con las últimas funciones, parches de seguridad y mejoras. Las actualizaciones regulares también mantienen todo funcionando sin problemas con otros componentes y ayudan a prevenir problemas causados por dependencias desactualizadas.

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

## Actualizando Midaz localmente

***

Si estás ejecutando 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 realizar actualizaciones. Esto asegura un reinicio limpio con las últimas actualizaciones.

Para detener los contenedores a través de la terminal, sigue estos pasos:

<Steps>
  <Step>
    Abre tu terminal y navega al 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 no utilizados

Limpiar recursos no utilizados ayuda a mantener tu entorno eficiente:

* **Liberar espacio en disco**: Evita que imágenes, contenedores y volúmenes antiguos consuman almacenamiento.
* **Evitar conflictos con dependencias desactualizadas**: Asegura que estás trabajando con las últimas configuraciones.
* **Mejorar el rendimiento**: Reduce capas de caché innecesarias de Docker y optimiza la gestión de recursos.
* **Prevenir dolores de cabeza al depurar**: Elimina inconsistencias causadas por datos obsoletos que permanecen en el sistema.
* **Mantener tu espacio de trabajo ordenado**: Mantén una configuración de desarrollo organizada, especialmente al cambiar entre proyectos.

Para eliminar imágenes y contenedores no utilizados:

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

Para eliminar volúmenes de Docker no utilizados:

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

### 3. Actualiza tu código base local

Obtén los últimos cambios del repositorio para asegurarte de que estás trabajando con la versión más reciente:

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

### 4. Reconstruye y reinicia Midaz

Reconstruye las imágenes de Docker necesarias y reinicia la aplicación localmente con las últimas actualizaciones:

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

## Actualizando Midaz con Helm

***

Para despliegues usando Helm, usa los siguientes comandos según tus necesidades. Helm simplifica los despliegues basados en Kubernetes, facilitando la instalación, actualización o eliminación de Midaz.

### Instalación nueva

Realiza una instalación nueva al configurar Midaz por primera vez o cuando se requiera un despliegue limpio.

#### Instalar Midaz Helm con un archivo de valores 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>

#### Instalar Midaz Helm con valores predeterminados

Usa este método para instalar Midaz usando 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>

### Actualizando un despliegue existente

Si Midaz ya está desplegado, usa estos comandos para actualizar a una nueva versión mientras preservas las configuraciones.

#### Actualizar Midaz Helm con un archivo de valores personalizado

Asegura que las configuraciones personalizadas permanezcan intactas mientras aplicas 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>

#### Actualizar Midaz Helm con 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>

## Gestionando la versión de Helm

***

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

### Listar versiones instaladas

Lista todas las versiones de Helm en el namespace `midaz`, junto con su estado y versión:

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

### Eliminar la versión de Midaz Helm

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

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

Al mantener Midaz actualizado, garantizas un entorno estable, seguro y de alto rendimiento, mientras te beneficias de las últimas mejoras y buenas prácticas.

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

Al mantener Midaz actualizado, aseguras un entorno estable, seguro y de alto rendimiento mientras te beneficias de las últimas mejoras y mejores prácticas.