Cómo Actualizar GLPI en Docker Entre Versiones

Guía paso a paso para actualizar GLPI en Docker de una versión minor o major a otra, con copia de seguridad, pruebas y rollback.

Actualizar GLPI en Docker es más seguro y rápido que en bare metal – basta con cambiar la etiqueta de la imagen y ejecutar la migración. Pero la copia de seguridad previa es innegociable.

Requisitos previos

  • Copia de seguridad completa de la base de datos y los volúmenes (ver guía de backup)
  • Verificar la compatibilidad de los plugins con la nueva versión
  • Probar en un entorno de pruebas primero

Paso a paso

1. Copia de seguridad

docker exec glpi-db mysqldump -u glpi -pSENHA glpi | gzip > /backup/pre-update.sql.gz
tar -czf /backup/pre-update-volumes.tar.gz /opt/glpi/

2. Detener los contenedores

docker compose down

3. Actualizar la imagen

En docker-compose.yml, cambie la etiqueta:

# De:
image: glpi/glpi:10.0.17
# A:
image: glpi/glpi:11.0

4. Iniciar con la nueva versión

docker compose up -d

5. Ejecutar la migración de la base de datos

docker exec -it glpi-app php bin/console db:update --no-interaction

6. Limpiar la caché

docker exec -it glpi-app php bin/console cache:clear

7. Verificar

Acceda a GLPI, verifique la versión en Configuración > General y pruebe las funcionalidades principales.

Rollback

Si algo falla:

docker compose down
# Restaurar la base de datos
gunzip < /backup/pre-update.sql.gz | docker exec -i glpi-db mysql -u root -pSENHA glpi
# Volver a la imagen anterior en docker-compose.yml
docker compose up -d

Preguntas Frecuentes

Cambie la etiqueta de la imagen en docker-compose.yml, haga una copia de seguridad, recree el contenedor y ejecute db:update vía consola. La base de datos se migra automáticamente.

Sí, brevemente. Detenga los contenedores, haga una copia de seguridad, inicie con la nueva imagen y ejecute la migración de la base de datos. El tiempo de inactividad típico es de 5-15 minutos.

Restaure la copia de seguridad de la base de datos y vuelva a la imagen anterior en docker-compose.yml. Por eso la copia de seguridad previa es obligatoria.

?Necesitas ayuda?