Como actualizar Apps en Portainer

Introducción

En esta lección aprenderás a mantener tus aplicaciones siempre actualizadas a la última versión de manera sencilla usando Portainer. Este proceso te permitirá disfrutar de las últimas características y mejoras de seguridad sin complicaciones.

Acceso a Portainer

1. Entra a tu Environment: Cuando accedas a Portainer, verás tu entorno de trabajo (tu servidor básicamente)
2. Navega a Stacks: Una vez dentro, dirígete a la sección Stacks donde encontrarás todas las aplicaciones instaladas

Proceso de Actualización

Actualización a la Última Versión

Usaremos N8n como ejemplo, ya que es una aplicación que se actualiza frecuentemente:

1. Selecciona la aplicación: Haz clic en el Stack de N8n (o la aplicación que desees actualizar)
2. Ve al Editor: Haz clic en la pestaña «Editor» en la parte superior
3. Observa el código: Verás un archivo de configuración Docker (no te preocupes, solo seguirás las instrucciones)
4. Actualiza: Desplázate hacia abajo y presiona el botón «Update Stack»
5. Confirma: Deja la opción marcada por defecto y presiona «Update»

Verificación de la Actualización

Después de actualizar:

• Los servicios mostrarán temporalmente «0 de 1»
• Espera pacientemente hasta que todos los servicios muestren «1 de 1»
• Esto puede tomar entre 3-5 minutos
• Una vez que veas «1 de 1» en los tres servicios, podrás acceder a la aplicación actualizada

Solución a Problemas de Actualización

¿Qué hacer si la nueva versión tiene errores?

Ocasionalmente, las actualizaciones pueden introducir bugs que afecten tus flujos de trabajo. Para regresar a una versión anterior:

Paso 1: Accede a Docker Hub

• Ve a hub.docker.com
• Guarda esta página en favoritos para acceso fácil

Paso 2: Busca la imagen oficial

1. En tu código de Portainer, localiza la línea que dice image:
2. Copia la parte antes de los dos puntos (ejemplo: n8nio/n8n)
3. Busca esta imagen en Docker Hub
4. Selecciona el repositorio oficial (reconocible por su alto número de descargas)

Paso 3: Selecciona la versión

1. Ve a la pestaña «Tags»
2. Verás el historial completo de versiones
3. Evita versiones beta: Ignora las marcadas como «nightly», «next» o «beta»
4. Busca la versión estable anterior que funcionaba correctamente

Paso 4: Modifica el código

1. Regresa al Editor en Portainer
2. Reemplaza latest por el número de versión específico (ejemplo: 1.89.2)
3. Importante: Debes hacer este cambio en tres lugares del código:
   • Editor
   • Webhook
   • Worker
4. Presiona «Update Stack»

Verificación del Downgrade

• Espera a que los servicios vuelvan a «1 de 1»
• Accede a la aplicación para verificar que funciona
• En configuraciones podrás confirmar la versión instalada

Regreso a la Última Versión

Para volver a utilizar siempre la versión más reciente:

1. Cambia los números de versión específicos por latest en los tres servicios
2. Actualiza el Stack
3. Esto garantiza que siempre tengas la versión más nueva disponible

Puntos Importantes a Recordar

• No pierdas datos: El proceso de actualización/downgrade no borra información
• Paciencia: Los servicios pueden tardar unos minutos en estar completamente operativos
• Errores temporales: Si ves errores al acceder inmediatamente después de la actualización, espera 1-2 minutos adicionales
• Estados de servicio: Es normal ver algunos servicios en rojo (apagados) o fallidos durante el proceso de cambio
• Secuencia: Los servicios se levantan en orden específico, por lo que algunos pueden fallar temporalmente hasta que otros estén listos

Resumen del Flujo de Trabajo

Portainer → Stacks → Seleccionar App → Editor → Update Stack → Esperar → Verificar

Con este proceso simple, podrás mantener todas tus aplicaciones actualizadas y solucionar cualquier problema que pueda surgir con las nuevas versiones.