Saltar al contenido principal
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:
1

Abre tu terminal y navega al directorio midaz.
2

Ejecuta el comando de detención:
make down

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:
docker system prune --all
Para eliminar volúmenes de Docker no utilizados:
docker volume prune

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:
git pull origin main

4. Reconstruye y reinicia Midaz

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

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:
helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
  --values values.yaml --version <version> -n midaz --create-namespace

Instalar Midaz Helm con valores predeterminados

Usa este método para instalar Midaz usando los valores predeterminados del chart de Helm:
helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
  --version <version> -n midaz --create-namespace

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:
helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
  --values values.yaml --version <new-version> -n midaz --create-namespace

Actualizar Midaz Helm con valores predeterminados

Usa este comando si no necesitas aplicar configuraciones personalizadas:
helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
  --version <new-version> -n midaz --create-namespace

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:
helm ls -n midaz

Eliminar la versión de Midaz Helm

Si necesitas eliminar completamente Midaz de tu clúster, ejecuta:
helm delete midaz -n midaz
Al mantener Midaz actualizado, aseguras un entorno estable, seguro y de alto rendimiento mientras te beneficias de las últimas mejoras y mejores prácticas.
I