Client de synchronisation local

Vue d'ensemble

Sync Client est une application de bureau permettant de conserver les projets SDA Console disponibles sur un ordinateur local ou un partage réseau. Elle s'exécute avec un service en arrière-plan et propose une fenêtre pour sélectionner des projets, synchroniser des versions, extraire des projets en vue de les modifier et réintégrer les modifications.

Le flux de travail de l'application est identique sous Windows et sous Linux. Des instructions spécifiques à chaque plateforme sont fournies pour l'installation et la désinstallation ; les autres captures d'écran présentent l'interface commune.

Téléchargement

Téléchargez le dernier paquet correspondant à votre système d'exploitation :

• Programme d'installation Windows
• Paquet Linux AMD64

Installer Sync Client

Windows

1. Localisez sync-client-windows-setup.exe dans Téléchargements, cliquez dessus avec le bouton droit et sélectionnez Exécuter en tant qu'administrateur. Un accès administrateur est requis.

   

   

2. Poursuivez depuis l'écran d'accueil.

   

3. Choisissez le dossier d'installation. L'emplacement par défaut est recommandé.

   

4. Sélectionnez les composants disponibles, y compris le raccourci sur le bureau et le démarrage automatique.

   

5. Laissez l'option Run Sync Client sélectionnée et choisissez Finish.

   

Linux

1. Téléchargez sync-client-linux.tar.bz2 et extrayez-le :

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

2. Ouvrez un terminal dans le répertoire extrait :

   cd sync-client-linux

3. Exécutez le programme d'installation avec les privilèges d'administrateur :

   sudo ./install.sh

   

4. Vérifiez que le terminal affiche Installed Sync Client et répertorie le bundle installé, la CLI, l'entrée de bureau, le service et l'utilisateur du service. Sync Client s'ouvre automatiquement à la fin de l'installation.

5. Déconnectez-vous de la session de bureau Linux et reconnectez-vous avant d'utiliser Sync Client. Le programme d'installation ajoute votre utilisateur de bureau au groupe sync-client, et la nouvelle appartenance au groupe devient effective dans la nouvelle session.

6. Après vous être reconnecté, Sync Client peut être ouvert depuis le lanceur d'applications ou depuis son icône dans la zone de notification s'il n'est pas déjà en cours d'exécution.

   

Configuration initiale

La configuration initiale se déroule automatiquement selon l'enchaînement suivant :

Login → Storage → Filters / Policy

Les captures d'écran ci-dessous présentent la version Windows, mais les mêmes paramètres et commandes sont disponibles sous Linux.

Se connecter

Saisissez votre adresse e-mail et votre mot de passe SDA Console, confirmez l'URL de l'API, puis sélectionnez Connect.

Les icônes situées à côté des champs indiquent si les différentes valeurs ont été vérifiées. Après une connexion réussie, Sync Client ouvre automatiquement l'étape Storage.

Authentification multifacteur

Si l'authentification multifacteur est activée pour le compte, saisissez le jeton à six chiffres fourni par l'application d'authentification et sélectionnez Confirm.

Choisir le stockage

Sync Client peut stocker les projets synchronisés dans un dossier local ou sur un partage réseau SMB.

Système de fichiers local

Sélectionnez Local Filesystem, choisissez Browse, sélectionnez le dossier de projets, définissez l'intervalle de synchronisation, puis sélectionnez Save.

Stockage réseau SMB

Sélectionnez Network Location et indiquez :

• UNC Path : le partage réseau et un sous-dossier facultatif, par exemple \\fileserver\engineering
• Domain : le domaine Windows ou le groupe de travail, si nécessaire
• SMB Username et SMB Password : un compte disposant d'un accès en lecture et en écriture
• Sync Interval : la fréquence à laquelle Sync Client recherche des mises à jour de projets

Sélectionnez Save pour vérifier et appliquer les paramètres. Une fois la configuration du stockage enregistrée, Sync Client ouvre automatiquement Filters / Policy.

Sélectionner les projets et les versions

Utilisez Filters / Policy pour choisir les projets à synchroniser et le nombre de versions à conserver localement.

• Utilisez IDE, Vendor, Groups et Time Range pour restreindre la liste des projets.
• Recherchez dans l'arborescence des projets par nom.
• Développez les groupes et sélectionnez des groupes complets ou des projets individuels.
• Supprimez un filtre actif en sélectionnant son étiquette.

Sous Version policy, choisissez Last N versions pour conserver un nombre fixe de versions récentes.

Vous pouvez également choisir Since date pour conserver les versions créées après une date sélectionnée.

Sélectionnez Apply et vérifiez la confirmation, qui récapitule les filtres actifs, les projets sélectionnés, la règle de conservation et l'éventuelle suppression des versions locales plus anciennes.

Travailler avec les projets

Rechercher et synchroniser un projet

Ouvrez Projects et utilisez la recherche, All ou Groups pour trouver un projet. La sélection d'un projet affiche ses versions disponibles, les horodatages, les informations sur l'IDE, les chemins locaux, les messages de validation et l'état de synchronisation.

Utilisez Sync now pour demander une synchronisation immédiate au lieu d'attendre l'intervalle configuré.

Extraire et ouvrir un projet

Sélectionnez une version de projet et choisissez Checkout. Vous pouvez ajouter un message de verrouillage facultatif avant de confirmer.

Une fois l'extraction terminée, le projet est verrouillé pour votre travail. La vue du projet identifie la version extraite et active Open project, Checkin et Discard checkout.

Choisissez Open project pour ouvrir l'extraction locale à l'aide de l'application d'ingénierie enregistrée pour ce type de projet. L'IDE correspondant doit être installé sur l'ordinateur.

Sync Client démarre d'abord l'application d'ingénierie enregistrée, puis ouvre le projet extrait.

Réintégrer ou abandonner les modifications

Après la modification, revenez à Sync Client et choisissez Checkin. Saisissez un message décrivant les modifications et confirmez.

Avant la réintégration, fermez l'IDE d'ingénierie externe. Un IDE ouvert peut laisser des fichiers de verrouillage de projet dans l'extraction et empêcher Sync Client de préparer la réintégration.

Sync Client téléverse le projet modifié, ajoute la nouvelle version à l'historique des versions et libère le verrou du projet.

Pour abandonner au contraire les modifications locales, choisissez Discard checkout et confirmez.

Projets favoris

Utilisez l'étoile située à côté d'un projet pour l'ajouter aux Favorites ou l'en retirer. Les étoiles pleines identifient les projets favoris et permettent un accès plus rapide depuis la liste des projets.

Les marqueurs de favoris restent également visibles dans l'arborescence groupée des projets.

Aide et diagnostic

Utilisez Export logs pour créer un paquet de diagnostic destiné au support. L'export inclut les journaux de l'application et du service, mais n'expose pas les mots de passe enregistrés.

Ouvrez About pour consulter la version de l'application installée, les informations de licence et les mentions relatives aux tiers.

Sync Client peut continuer à s'exécuter dans la zone de notification. Utilisez le menu de la zone de notification pour ouvrir l'application, consulter son état ou la quitter.

Interface en ligne de commande

L'installation fournit également sync-cli, qui communique avec le même service en arrière-plan que l'application de bureau.

Vérifiez l'état du service et de la synchronisation :

sync-cli --status

Affichez les paramètres non confidentiels actuels :

sync-cli --show-settings

Demandez une synchronisation immédiate :

sync-cli --sync-now

Répertoriez les extractions de projets actives :

sync-cli --show-checkouts

Exécutez sync-cli --help pour afficher toutes les options de projet et de sortie prises en charge. Ajoutez --json lorsque la sortie de la commande est traitée par un script.

Désinstaller Sync Client

Windows

Fermez d'abord Sync Client depuis la zone de notification. Ouvrez ensuite Applications ou Programmes dans Windows, sélectionnez Sync Client et suivez les invites de désinstallation.

Linux

1. Fermez Sync Client depuis le menu de la zone de notification avant d'exécuter le programme de désinstallation.

2. Ouvrez un terminal dans le répertoire sync-client-linux extrait.

3. Exécutez le programme de désinstallation avec les privilèges d'administrateur :

   sudo ./uninstall.sh

   

Le programme de désinstallation supprime le bundle de l'application de /opt/sync-client. La configuration, les données synchronisées et les journaux sont conservés dans /etc/sync-client, /var/lib/sync-client et /var/log/sync-client afin de pouvoir être réutilisés ou examinés ultérieurement.