Actualizaciones

Saber cuándo sale una versión

La búsqueda de actualizaciones está desactivada por defecto, como todas las conexiones a Internet. Actívela en Configuración › Plataforma › General › Conexiones › Buscar actualizaciones. Solo lee las etiquetas de las versiones publicadas: no se envía nada sobre la instancia.

Una vez activada:

• el pie de la barra lateral muestra Actualización disponible: … cuando hay una versión más reciente;
• Configuración › Plataforma › Actualización enumera las versiones más recientes con Lo que aporta;
• la búsqueda se ejecuta sola cada seis horas; Buscar actualizaciones en la página Actualización la ejecuta de inmediato y le notifica el resultado.

La pestaña Versión muestra la Versión actual, el Canal, la Última versión y el estado del Actualizador. La pestaña Notas de versión enumera todas las versiones publicadas, de la más reciente a la más antigua, con lo que aporta cada una y lo que hay que hacer a mano, si procede.

Actualizar desde la configuración

Para ello se necesita el servicio updater del stack de producción (la página muestra Actualizador: En marcha) y la búsqueda de actualizaciones activada.

1. Abra Configuración › Plataforma › Actualización. En Actualizaciones disponibles, lea lo que aporta la versión.

2. Haga clic en Actualizar a … y confirme con Actualizar.

3. La página sigue los pasos: Copia de seguridad (la base de datos se guarda en la carpeta de copias de seguridad de la instalación), Descarga, Reinicio, Comprobación. Auditix no está disponible durante uno o dos minutos mientras se reinician sus servicios y, después, la página se recarga sola.

Si la nueva versión no arranca, la anterior vuelve por sí sola. Una versión también puede requerir un cambio en compose.yaml: sus notas de versión lo indican, y se aplica a mano (consulte Notas de actualización).

La forma en que el actualizador reinicia los servicios depende de AUDITIX_VERSION en .env:

• latest (cualquier instalación, Portainer incluido): la versión elegida pasa a ser latest en el host y el actualizador vuelve a crear los contenedores de Auditix con ella. El stack sigue indicando latest: no hay nada que cambiar en Portainer.
• Una versión fija (vX.Y.Z), con la carpeta de instalación montada en /install: el actualizador escribe la nueva versión en .env y, después, descarga y reinicia los servicios.

Versiones de desarrollo

Cuando la licencia incluye Versiones de desarrollo, el Canal de la página Actualización ofrece Producción (las versiones publicadas, por defecto) y Desarrollo (la última versión de desarrollo, por delante de las versiones publicadas). Las versiones de desarrollo pueden contener trabajo inacabado, y sus cambios en la base de datos pueden llegar antes que la siguiente versión publicada: volver a Producción espera a una versión publicada más reciente que la versión instalada. Resérvelas para las instancias de prueba.

Actualizar a mano

Sin el servicio de actualización, o si lo prefiere:

Versión fija

Indique la nueva versión en .env y, después, descargue y reinicie:

.env

AUDITIX_VERSION=v0.13.0

docker compose pull
docker compose up -d
docker image prune -f

latest

Mantenga AUDITIX_VERSION=latest y vuelva a descargar:

docker compose pull
docker compose up -d
docker image prune -f

El backend aplica por sí mismo los cambios de la base de datos al arrancar, desde cualquier versión anterior. Haga antes una copia de seguridad de la base de datos (consulte Copia de seguridad).

Para volver atrás, indique la versión anterior y ejecute los mismos comandos. Los cambios de la base de datos solo avanzan: al volver atrás por encima de un cambio de la base de datos, restaure la copia de seguridad realizada antes de la actualización.

Nota

Las etiquetas de versión empiezan por v (v0.13.0). Las etiquetas sin v de las versiones hasta la 0.4.0 ya no existen.

Notas de actualización

Cambios que hay que aplicar a mano en compose.yaml, según la versión desde la que se instaló:

• Instalada antes de la 0.11.1: añada cookie_name auditix_live a las MERCURE_EXTRA_DIRECTIVES del servicio mercure. Sin ello, los navegadores acceden a las actualizaciones en tiempo real a través de un relé más lento y registran una solicitud /.well-known/mercure rechazada.

  mercure:
    environment:
      MERCURE_EXTRA_DIRECTIVES: |
        resource_identifier http://mercure/.well-known/mercure
        cookie_name auditix_live
        transport bolt {
          path /data/mercure.db
          size 1000
          cleanup_frequency 0.3
        }
        heartbeat 15s

• 0.6 o anterior: elimine el servicio worker, añada el servicio orchestrator y elimine el contenedor que dejó el servicio worker (docker rm -f <project>-worker-1; con Portainer: Containers).

• 0.2 o anterior: añada el bloque x-logging y el logging de cada servicio; los servicios gateway, rabbitmq, mercure, developer y logs y sus volúmenes; MESSENGER_TRANSPORT_DSN, GATEWAY_SECRET, RABBITMQ_PASSWORD y MERCURE_JWT_SECRET (openssl rand -hex 32), como en el archivo compose actual. Ahora es el gateway quien publica los puertos: elimine los del frontend y, si tiene un proxy inverso, apúntelo al puerto HTTP del gateway.