Actualizaciones

Esta documentación presenta los pasos para actualizar la solución LockSelf On-Premises.

____________________________________________________________________________________

Actualizaciones de versión

Los equipos de LockSelf le comunicarán las actualizaciones, que se planifican con antelación. Las actualizaciones se realizan mediante el envío de una nueva imagen Docker.

Al igual que en el despliegue inicial, los equipos de LockSelf le enviarán el paquete de actualización. Este paquete incluye:

  • La imagen del contenedor: lockself-api-X.X.X.tar.gz
  • La firma de la imagen del contenedor: lockself-api-X.X.X.tar.gz.sig
⚠️ Antes de realizar cualquier operación, debe verificar la firma de la imagen del contenedor.

El downtime (tiempo de inactividad) será de unos minutos, el tiempo necesario para reconstruir el contenedor (salvo en un entorno en clúster).

Para cargar la imagen de LockSelf en el servidor web:

docker load --input lockself-api-X.X.X.tar.gz

Puede comprobar la presencia de la imagen con el siguiente comando:

docker images | grep lockself-api

Antes de cualquier actualización

Antes de cualquier actualización, le recomendamos realizar una copia de seguridad completa de su entorno de acuerdo con sus procedimientos habituales de copia de seguridad.

Despliegue mediante inicio manual

Si LockSelf se instaló manualmente en su servidor (sin Docker Compose ni Docker Swarm), siga estos pasos:

  1. Detener el contenedor actual:

    # Listar los contenedores en ejecución
docker ps

# Detener el contenedor de LockSelf
docker stop CONTAINER_ID

  2. (Opcional) Eliminar el contenedor antiguo:

    # Eliminar el contenedor detenido (los datos se conservan si utiliza volúmenes)
docker rm CONTAINER_ID
  3. Iniciar el nuevo contenedor:
    Utilice el mismo comando que empleó en su último despliegue. Si es necesario, puede consultar el comando propuesto en nuestra documentación en la siguiente dirección: Apartado 6.5.1

    ⚠️ Importante: Utilice exactamente los mismos parámetros que en su comando docker run inicial:
    - Los mismos puertos (-p)
    - Los mismos volúmenes (-v)
    - Las mismas variables de entorno (-e)
    - Las mismas opciones de red
    - Solo cambia la versión de la imagen

    Si son necesarias modificaciones en la base de datos, se aplicarán automáticamente al iniciar el contenedor. No se requiere ninguna acción por su parte.

  4. Verificar el inicio:

    # Seguir los registros (logs) en tiempo real
docker logs -f CONTAINER_ID

  5. (Opcional) Limpiar las imágenes antiguas:

    # Listar las imágenes
docker images

# Eliminar la versión antigua
docker rmi lockself-api-v3:version-anterior


Despliegue mediante Docker Compose

Si LockSelf está instalado mediante Docker Compose, siga estos pasos:

  1. Actualizar el archivo docker-compose.yml:
    Modifique la versión de la imagen en su archivo docker-compose.yml:

    version: '3.8'

services:
  lockself-api-3:
    image: lockself-api-v3:X.X.X # ← Modificar esta línea con la nueva versión

  2. Reiniciar con la nueva versión:

    # Iniciar con la nueva imagen
docker-compose up -d

    Docker Compose recreará automáticamente el nuevo contenedor.

  3. Verificar el inicio:

    # Seguir los registros (logs) en tiempo real
docker logs -f lockself-api-3

  4. (Opcional) Limpiar las imágenes antiguas:

    # Listar las imágenes
docker images

# Eliminar la versión antigua
docker rmi lockself-api-v3:version-anterior

Despliegue mediante Docker Swarm

Como se indica en la documentación de instalación, Docker Swarm puede utilizarse de diferentes maneras. Por lo tanto, le corresponde a usted completar este procedimiento con sus propios comandos de despliegue y verificación. Encontrará todos los detalles sobre su funcionamiento en su sitio web oficial: https://docs.docker.com/engine/swarm/

Actualice su archivo de configuración de docker-swarm para modificar la versión utilizada:

version: '3.7'

services:
  lockself-api-3:
    image: lockself-api-v3:X.X.X # ← Modificar esta línea con la nueva versión

Optimización del espacio en disco

Después de cada actualización de los contenedores, puede, si lo desea, eliminar las imágenes antiguas progresivamente.

Actualización del certificado SSL

Se necesitan dos pasos para actualizar el certificado SSL (para la conexión HTTPS) en su instalación:

  • Cambiar los certificados en los servidores de aplicaciones. En nuestro ejemplo, en la carpeta /home/user/lockself/ssl/, cargue los nuevos archivos:
    • El certificado seguido de la cadena de certificación, con el nombre: ssl-certificate.crt
    • La clave privada, con el nombre: ssl-certificate.key
    • Solo en el caso de una conexión SSO:
      • El certificado SIN la cadena de certificación, con el nombre: sp.crt
  • Reiniciar el contenedor según el método utilizado.

Cambio del nombre de dominio

Si desea cambiar el nombre de dominio de su instalación de LockSelf, deberá seguir el siguiente procedimiento:

  • Vincular el nuevo nombre de dominio a la IP de su servidor de aplicaciones
  • En el archivo "env", modificar la variable "domain" con el nuevo dominio que desea utilizar
  • En la carpeta que contiene los certificados SSL (por ejemplo: /home/user/lockself/ssl/):
    • Modificar el certificado seguido de la cadena de certificación, con el nombre: ssl-certificate.crt
    • Modificar la clave privada sin cifrar, con el nombre: ssl-certificate.key
    • Solo en el caso de una conexión SSO:
      • Modificar el certificado SIN la cadena de certificación, con el nombre: sp.crt
  • Reiniciar el contenedor de la aplicación

Atención: si hay una interconexión SSO activa, deberá repetir el procedimiento de creación del conector.

¿Cómo verificar la firma de la imagen antes de actualizar?

La firma del archivo .sig asociado a la imagen del contenedor debe verificarse antes de cualquier actualización. Esta verificación requiere la clave pública oficial de LockSelf. Póngase en contacto con el soporte de LockSelf para obtener: la clave pública actualizada, el comando de verificación exacto y el procedimiento que debe seguir si la verificación falla.

No proceda con la actualización si la firma no puede verificarse correctamente.

Actualización