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
- Entra a tu Environment: Cuando accedas a Portainer, verás tu entorno de trabajo (tu servidor básicamente)
- 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:
- Selecciona la aplicación: Haz clic en el Stack de N8n (o la aplicación que desees actualizar)
- Ve al Editor: Haz clic en la pestaña «Editor» en la parte superior
- Observa el código: Verás un archivo de configuración Docker (no te preocupes, solo seguirás las instrucciones)
- Actualiza: Desplázate hacia abajo y presiona el botón «Update Stack»
- 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
- En tu código de Portainer, localiza la línea que dice
image:
- Copia la parte antes de los dos puntos (ejemplo:
n8nio/n8n
) - Busca esta imagen en Docker Hub
- Selecciona el repositorio oficial (reconocible por su alto número de descargas)
Paso 3: Selecciona la versión
- Ve a la pestaña «Tags»
- Verás el historial completo de versiones
- Evita versiones beta: Ignora las marcadas como «nightly», «next» o «beta»
- Busca la versión estable anterior que funcionaba correctamente
Paso 4: Modifica el código
- Regresa al Editor en Portainer
- Reemplaza
latest
por el número de versión específico (ejemplo:1.89.2
) - Importante: Debes hacer este cambio en tres lugares del código:
- Editor
- Webhook
- Worker
- 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:
- Cambia los números de versión específicos por
latest
en los tres servicios - Actualiza el Stack
- 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.