Lokálny Sync Client

Prehľad

Sync Client je desktopová aplikácia na sprístupnenie projektov SDA Console v lokálnom počítači alebo na sieťovom zdieľanom úložisku. Beží so službou na pozadí a poskytuje okno na výber projektov, synchronizáciu verzií, rezerváciu projektov na úpravu (check out) a spätné odovzdanie zmien (check in).

Pracovný postup aplikácie je rovnaký v systémoch Windows aj Linux. Pokyny špecifické pre platformu sú uvedené pri inštalácii a odinštalovaní; ostatné snímky obrazovky zobrazujú spoločné rozhranie.

Stiahnutie

Stiahnite si najnovší balík pre váš operačný systém:

• Inštalátor pre Windows
• Balík pre Linux AMD64

Inštalácia Sync Client

Windows

1. Nájdite súbor sync-client-windows-setup.exe v priečinku Downloads, kliknite naň pravým tlačidlom myši a vyberte Run as administrator. Vyžaduje sa prístup správcu.

   

   

2. Pokračujte z uvítacej obrazovky.

   

3. Zvoľte inštalačný priečinok. Odporúča sa predvolené umiestnenie.

   

4. Vyberte dostupné komponenty vrátane zástupcu na ploche a automatického spustenia.

   

5. Ponechajte vybranú možnosť Run Sync Client a zvoľte Finish.

   

Linux

1. Stiahnite súbor sync-client-linux.tar.bz2 a rozbaľte ho:

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

2. Otvorte terminál v rozbalenom adresári:

   cd sync-client-linux

3. Spustite inštalátor s oprávneniami správcu:

   sudo ./install.sh

   

4. Skontrolujte, či terminál oznámi Installed Sync Client a vypíše nainštalovaný balík, CLI, položku pracovnej plochy, službu a používateľa služby. Po dokončení inštalácie sa Sync Client otvorí automaticky.

5. Pred použitím Sync Client sa odhláste z pracovnej plochy systému Linux a znova sa prihláste. Inštalátor pridá vášho používateľa pracovnej plochy do skupiny sync-client a nové členstvo v skupine sa aktivuje v novej relácii prihlásenia.

6. Po opätovnom prihlásení možno Sync Client otvoriť zo spúšťača aplikácií alebo z ikony v systémovej lište, ak ešte nie je spustený.

   

Prvotná konfigurácia

Prvotné nastavenie automaticky prechádza cez:

Login → Storage → Filters / Policy

Nasledujúce snímky obrazovky zobrazujú zostavenie pre Windows, rovnaké nastavenia a ovládacie prvky sú však dostupné aj v systéme Linux.

Prihlásenie

Zadajte svoju e-mailovú adresu a heslo pre SDA Console, potvrďte API URL a zvoľte Connect.

Ikony vedľa polí zobrazujú, či boli jednotlivé hodnoty overené. Po úspešnom pripojení Sync Client automaticky otvorí krok Storage.

Viacfaktorové overenie

Ak je pre účet povolené viacfaktorové overenie, zadajte šesťmiestny token z autentifikačnej aplikácie a zvoľte Confirm.

Voľba úložiska

Sync Client môže ukladať synchronizované projekty do lokálneho priečinka alebo na sieťové zdieľané úložisko SMB.

Lokálny súborový systém

Zvoľte Local Filesystem, kliknite na Browse, vyberte priečinok projektov, nastavte interval synchronizácie a zvoľte Save.

Sieťové úložisko SMB

Zvoľte Network Location a zadajte:

• UNC Path: sieťové zdieľanie a voliteľný podpriečinok, napríklad \\fileserver\engineering
• Domain: doména Windows alebo pracovná skupina, ak sa vyžaduje
• SMB Username a SMB Password: účet s právom čítania a zápisu
• Sync Interval: ako často má Sync Client kontrolovať aktualizácie projektov

Zvoľte Save na overenie a použitie nastavení. Po uložení konfigurácie úložiska Sync Client automaticky otvorí krok Filters / Policy.

Výber projektov a verzií

V kroku Filters / Policy zvoľte, ktoré projekty sa majú synchronizovať a koľko verzií má zostať dostupných lokálne.

• Pomocou položiek IDE, Vendor, Groups a Time Range zúžte zoznam projektov.
• V strome projektov vyhľadávajte podľa názvu.
• Rozbaľte skupiny a vyberte celé skupiny alebo jednotlivé projekty.
• Aktívny filter odstránite kliknutím na jeho štítok.

V časti Version policy zvoľte Last N versions, ak chcete ponechať pevný počet posledných verzií.

Prípadne zvoľte Since date, ak chcete ponechať verzie vytvorené po zvolenom dátume.

Zvoľte Apply a skontrolujte potvrdenie, ktoré zhŕňa aktívne filtre, vybrané projekty, pravidlo uchovávania a informáciu, či sa staršie lokálne verzie odstránia.

Práca s projektmi

Vyhľadanie a synchronizácia projektu

Otvorte Projects a pomocou vyhľadávania, možnosti All alebo Groups nájdite projekt. Po výbere projektu sa zobrazia jeho dostupné verzie, časové značky, informácie o IDE, lokálne cesty, správy commitov a stav synchronizácie.

Pomocou Sync now vyžiadate okamžitú synchronizáciu namiesto čakania na nakonfigurovaný interval.

Rezervácia a otvorenie projektu

Vyberte verziu projektu a zvoľte Checkout. Pred potvrdením môžete pridať voliteľnú správu k zámku.

Po dokončení rezervácie je projekt uzamknutý pre vašu prácu. Zobrazenie projektu identifikuje rezervovanú verziu a sprístupní možnosti Open project, Checkin a Discard checkout.

Zvoľte Open project, ak chcete otvoriť lokálnu rezerváciu pomocou inžinierskej aplikácie zaregistrovanej pre daný typ projektu. Príslušné IDE musí byť v počítači nainštalované.

Sync Client najprv spustí zaregistrovanú inžiniersku aplikáciu a potom otvorí rezervovaný projekt.

Odovzdanie alebo zahodenie zmien

Po úpravách sa vráťte do Sync Client a zvoľte Checkin. Zadajte správu popisujúcu zmeny a potvrďte.

Pred odovzdaním zmien zatvorte externé inžinierske IDE. Otvorené IDE môže v rezervácii ponechať súbory zámkov projektu a zabrániť tak Sync Client v príprave odovzdania.

Sync Client nahrá zmenený projekt, pridá novú verziu do histórie verzií a uvoľní zámok projektu.

Ak chcete lokálne zmeny namiesto toho zahodiť, zvoľte Discard checkout a potvrďte.

Obľúbené projekty

Pomocou hviezdičky vedľa projektu ho pridáte do Favorites alebo odstránite z nich. Vyplnené hviezdičky označujú obľúbené projekty a umožňujú rýchlejší prístup zo zoznamu projektov.

Označenia obľúbených položiek zostávajú viditeľné aj v zoskupenom strome projektov.

Pomoc a diagnostika

Pomocou Export logs vytvoríte diagnostický balík pre podporu. Export obsahuje protokoly aplikácie a služby, neodhaľuje však uložené heslá.

Otvorením About zobrazíte nainštalovanú verziu aplikácie, licenčné informácie a upozornenia tretích strán.

Sync Client môže ďalej bežať v systémovej lište. Pomocou ponuky v lište môžete aplikáciu otvoriť, zobraziť jej stav alebo ju ukončiť.

Rozhranie príkazového riadka

Inštalácia poskytuje aj nástroj sync-cli, ktorý komunikuje s tou istou službou na pozadí ako desktopová aplikácia.

Kontrola stavu služby a synchronizácie:

sync-cli --status

Zobrazenie aktuálnych nastavení, ktoré nie sú tajné:

sync-cli --show-settings

Vyžiadanie okamžitej synchronizácie:

sync-cli --sync-now

Výpis aktívnych rezervácií projektov:

sync-cli --show-checkouts

Spustením sync-cli --help zobrazíte všetky podporované možnosti projektov a výstupu. Ak spracúvate výstup príkazu zo skriptu, pridajte --json.

Odinštalovanie Sync Client

Windows

Najprv zatvorte Sync Client zo systémovej lišty. Potom otvorte v systéme Windows položku Apps alebo Programs, vyberte Sync Client a dokončite výzvy odinštalovania.

Linux

1. Pred spustením odinštalátora zatvorte Sync Client z ponuky v systémovej lište.

2. Otvorte terminál v rozbalenom adresári sync-client-linux.

3. Spustite odinštalátor s oprávneniami správcu:

   sudo ./uninstall.sh

   

Odinštalátor odstráni balík aplikácie z adresára /opt/sync-client. Konfigurácia, synchronizované údaje a protokoly zostávajú v adresároch /etc/sync-client, /var/lib/sync-client a /var/log/sync-client, aby ich bolo možné neskôr znova použiť alebo preskúmať.