Cliente de sincronización local

Descripción general

Sync Client es una aplicación de escritorio para mantener los proyectos de SDA Console disponibles en un equipo local o en un recurso compartido de red. Se ejecuta con un servicio en segundo plano y ofrece una ventana para seleccionar proyectos, sincronizar versiones, desproteger proyectos para su edición y volver a protegerlos con los cambios.

El flujo de trabajo de la aplicación es el mismo en Windows y en Linux. Se proporcionan instrucciones específicas de cada plataforma para la instalación y la desinstalación; el resto de las capturas de pantalla muestran la interfaz común.

Descarga

Descargue el paquete más reciente para su sistema operativo:

• Instalador de Windows
• Paquete de Linux AMD64

Instalar Sync Client

Windows

1. Localice sync-client-windows-setup.exe en Descargas, haga clic con el botón derecho y seleccione Ejecutar como administrador. Se requiere acceso de administrador.

   

   

2. Continúe desde la pantalla de bienvenida.

   

3. Elija la carpeta de instalación. Se recomienda la ubicación predeterminada.

   

4. Seleccione los componentes disponibles, incluidos el acceso directo del escritorio y el inicio automático.

   

5. Mantenga seleccionada la opción Run Sync Client y elija Finish.

   

Linux

1. Descargue sync-client-linux.tar.bz2 y extráigalo:

   tar -xjvf sync-client-linux.tar.bz2

2. Abra un terminal en el directorio extraído:

   cd sync-client-linux

3. Ejecute el instalador con privilegios de administrador:

   sudo ./install.sh

   

4. Compruebe que el terminal indique Installed Sync Client y muestre el paquete instalado, la CLI, la entrada de escritorio, el servicio y el usuario del servicio. Sync Client se abre automáticamente al finalizar la instalación.

5. Cierre la sesión del escritorio de Linux y vuelva a iniciarla antes de utilizar Sync Client. El instalador añade su usuario de escritorio al grupo sync-client, y la nueva pertenencia al grupo se activa en la nueva sesión.

6. Tras volver a iniciar sesión, Sync Client se puede abrir desde el lanzador de aplicaciones o desde su icono en la bandeja del sistema si aún no se está ejecutando.

   

Configuración inicial

La configuración inicial avanza automáticamente por:

Login → Storage → Filters / Policy

Las capturas de pantalla siguientes muestran la versión de Windows, pero los mismos ajustes y controles están disponibles en Linux.

Iniciar sesión

Introduzca su dirección de correo electrónico y contraseña de SDA Console, confirme la URL de la API y seleccione Connect.

Los iconos situados junto a los campos indican si los distintos valores se han verificado. Tras una conexión correcta, Sync Client abre automáticamente el paso Storage.

Autenticación multifactor

Si la autenticación multifactor está habilitada para la cuenta, introduzca el token de seis dígitos de la aplicación de autenticación y seleccione Confirm.

Elegir el almacenamiento

Sync Client puede almacenar los proyectos sincronizados en una carpeta local o en un recurso compartido de red SMB.

Sistema de archivos local

Seleccione Local Filesystem, elija Browse, seleccione la carpeta de proyectos, defina el intervalo de sincronización y seleccione Save.

Almacenamiento en red SMB

Seleccione Network Location e indique:

• UNC Path: el recurso compartido de red y la subcarpeta opcional, por ejemplo \\fileserver\engineering
• Domain: el dominio o grupo de trabajo de Windows, cuando sea necesario
• SMB Username y SMB Password: una cuenta con acceso de lectura y escritura
• Sync Interval: la frecuencia con la que Sync Client comprueba si hay actualizaciones de proyectos

Seleccione Save para verificar y aplicar los ajustes. Una vez guardada la configuración de almacenamiento, Sync Client abre automáticamente Filters / Policy.

Seleccionar proyectos y versiones

Utilice Filters / Policy para elegir qué proyectos deben sincronizarse y cuántas versiones deben permanecer disponibles localmente.

• Utilice IDE, Vendor, Groups y Time Range para acotar la lista de proyectos.
• Busque en el árbol de proyectos por nombre.
• Expanda los grupos y seleccione grupos completos o proyectos individuales.
• Elimine un filtro activo seleccionando su etiqueta.

En Version policy, elija Last N versions para conservar un número fijo de versiones recientes.

Como alternativa, elija Since date para conservar las versiones creadas después de una fecha seleccionada.

Seleccione Apply y revise la confirmación, que resume los filtros activos, los proyectos seleccionados, la regla de retención y si se eliminarán las versiones locales más antiguas.

Trabajar con proyectos

Buscar y sincronizar un proyecto

Abra Projects y utilice la búsqueda, All o Groups para localizar un proyecto. Al seleccionar un proyecto se muestran sus versiones disponibles, marcas de tiempo, información del IDE, rutas locales, mensajes de confirmación y estado de sincronización.

Utilice Sync now para solicitar una sincronización inmediata en lugar de esperar al intervalo configurado.

Desproteger y abrir un proyecto

Seleccione una versión del proyecto y elija Checkout. Puede añadir un mensaje de bloqueo opcional antes de confirmar.

Una vez completada la desprotección, el proyecto queda bloqueado para su trabajo. La vista del proyecto identifica la versión desprotegida y habilita Open project, Checkin y Discard checkout.

Elija Open project para abrir la copia local desprotegida con la aplicación de ingeniería registrada para ese tipo de proyecto. El IDE correspondiente debe estar instalado en el equipo.

Sync Client inicia primero la aplicación de ingeniería registrada y después abre el proyecto desprotegido.

Proteger o descartar los cambios

Después de editar, vuelva a Sync Client y elija Checkin. Introduzca un mensaje que describa los cambios y confirme.

Antes de realizar el check-in, cierre el IDE de ingeniería externo. Un IDE abierto puede dejar archivos de bloqueo del proyecto en la copia desprotegida e impedir que Sync Client prepare el check-in.

Sync Client carga el proyecto modificado, añade la nueva versión al historial de versiones y libera el bloqueo del proyecto.

Para descartar en su lugar los cambios locales, elija Discard checkout y confirme.

Proyectos favoritos

Utilice la estrella situada junto a un proyecto para añadirlo o eliminarlo de Favorites. Las estrellas rellenas identifican los proyectos favoritos y permiten un acceso más rápido desde la lista de proyectos.

Los marcadores de favoritos también permanecen visibles en el árbol de proyectos agrupado.

Ayuda y diagnóstico

Utilice Export logs para crear un paquete de diagnóstico destinado al soporte. La exportación incluye los registros de la aplicación y del servicio, pero no expone las contraseñas guardadas.

Abra About para ver la versión instalada de la aplicación, la información de licencia y los avisos de terceros.

Sync Client puede seguir ejecutándose en la bandeja del sistema. Utilice el menú de la bandeja para abrir la aplicación, ver su estado o salir.

Interfaz de línea de comandos

La instalación también proporciona sync-cli, que se comunica con el mismo servicio en segundo plano que la aplicación de escritorio.

Comprobar el estado del servicio y de la sincronización:

sync-cli --status

Mostrar los ajustes no confidenciales actuales:

sync-cli --show-settings

Solicitar una sincronización inmediata:

sync-cli --sync-now

Enumerar las desprotecciones de proyecto activas:

sync-cli --show-checkouts

Ejecute sync-cli --help para ver todas las opciones de proyecto y de salida admitidas. Añada --json cuando procese la salida del comando desde un script.

Desinstalar Sync Client

Windows

Cierre primero Sync Client desde la bandeja del sistema. A continuación, abra Aplicaciones o Programas de Windows, seleccione Sync Client y complete las indicaciones de desinstalación.

Linux

1. Cierre Sync Client desde el menú de la bandeja del sistema antes de ejecutar el desinstalador.

2. Abra un terminal en el directorio extraído sync-client-linux.

3. Ejecute el desinstalador con privilegios de administrador:

   sudo ./uninstall.sh

   

El desinstalador elimina el paquete de la aplicación de /opt/sync-client. La configuración, los datos sincronizados y los registros permanecen en /etc/sync-client, /var/lib/sync-client y /var/log/sync-client para que puedan reutilizarse o inspeccionarse posteriormente.