Ir al contenido principal

Guía de migración V2

Esta guía explica cómo migrar Sync-in de la versión 1.x a la versión 2.x.

Actualización del servidor​

Los pasos a seguir dependen del método de instalación seleccionado al implementar Sync-in.

Docker Compose​

Servidor​

Para actualizar la imagen de Docker, edite el archivo docker-compose.yaml y establezca la versión de la imagen en 2:

services:
  sync_in:
    image: syncin/server:2

Luego aplique la actualización del servicio:

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

Repositorio de aplicaciones de escritorio (opcional)​

Si lo está utilizando, edite docker-compose.sync-in-desktop-releases.yaml y establezca la versión de la imagen en 2:

services:
  sync_in_desktop_releases:
    image: syncin/desktop-releases:2

Luego ejecute el comando ./config/sync-in-desktop-releases/update.sh desde el directorio que contiene el archivo docker-compose.yaml.

Node Package Manager​

En la raíz del paquete NPM, edite el archivo package.json y actualice la versión a ^2.0.0:

{
  "dependencies": {
    "@sync-in/server": "^2.0.0"
  }
}

Luego instale la nueva versión del paquete:

rm -rf node_modules package-lock.json && npm install

Actualización de aplicaciones de escritorio​

Las aplicaciones de escritorio de la versión 1.x siguen siendo compatibles con un servidor de la versión 2.x para los servidores registrados previamente.

Sin embargo, para volver a autenticar o registrar servidores desde las aplicaciones, los clientes deben actualizarse a la versión 2.x.

⚠️ Las aplicaciones de escritorio que ejecutan la versión 1.x no se actualizarán automáticamente a la versión 2.x.

Puede descargar la última versión de las aplicaciones desde la página de descarga.

Cambios incompatibles​

Configuración del servidor​

Algunas secciones del archivo de configuración environment.yaml se han reorganizado y renombrado para mejorar la claridad y la coherencia.

  • Se ha cambiado el nombre de la clave auth.method a auth.provider:

    auth:
      # method: mysql
      provider: mysql

  • La clave auth.ldap.adminGroup se ha movido a auth.ldap.options.adminGroup:

    auth:
      ldap:
        # adminGroup: admin
        options:
          adminGroup: admin

Mejoras​

Configuración de proxy inverso​

La configuración de Nginx proporcionada con el paquete Docker Compose se ha simplificado.
Si utilizó la plantilla de configuración de Nginx para adaptarla a su proxy inverso, asegúrese de aplicar estos cambios o sus equivalentes en su configuración.

Actualización del encabezado X-Forwarded-Proto​

  • Se debe utilizar la siguiente directiva:

    proxy_set_header X-Forwarded-Proto $scheme;

  • Reemplaza la configuración anterior:

    proxy_set_header X-Forwarded-Proto $xfp;

  • La siguiente sección se puede eliminar de la configuración:

      map $request_uri $xfp {
        # Este encabezado debe ser nulo en el URI de WebDAV
        # Provoca errores de autenticación con Microsoft-WebDAV-MiniRedir (Windows)
        ~^/webdav(?:/.*)?  "";
        default            $scheme;
      }

Esta simplificación corrige ciertas incompatibilidades relacionadas con WebDAV, reduce la complejidad de la configuración de Nginx y estandariza la gestión de X-Forwarded-Proto.