Správa verzí souborů na cvičení

Transkript

1 Správa verzí souborů na cvičení Úvod do problematiky, metodické pokyny Karel Šimerda Univerzita Pardubice, Fakulta elektrotechniky a informatiky 1. února 2010 Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

2 Úvod Komu je tento dokument určen Komu je tento dokument určen Tento dokument je určen pro studenty předmětu IOOP na bakalářském studiu a předmětu INPSW na navazujicím magisterském studiu pro rychlou orientaci v praktickém používání správy verzí při cvičeních. Tento text nenahrazuje uživatelskou příručku. Uživatelské příručky jsou součástí instalace správy verzí. Příručky obsahují informace o základním principu řízení verzí jak systém verzování používat podrobnou referenci příkazů Samozřejmě, že jsou v angličtině. V češtině jsou dostupné různé zjednodušené verze na Internetu. Doporučuji si příručky alespoň prohlédnout. Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

9 Úvod Zdůvodnění použití správy verzí Proč nebudeme používat Použití u na předání funkčního projektu je nepraktické (zip) nepřehledné hrozí ztráta Proč budeme používat správu verzí při cvičení Protože jen tak, lze zvládnout tak velký počet studentů. Studenti získají praktickou zkušenost se správou verzí. Garantovi předmětu to umožní efektivní sledování průběhu cvičení. Co budeme používat? Je celá řada softwarových produktů, které zajišt ují správu verzí: CVS Subversion Git SourceSafe PVCS... My budeme používat Subversion Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

22 Základní pojmy Subversion Základní pojmy Převzato Repository (repozitář, centrální úložiště) Umožňuje organizovat projekt a spravovat jeho verze. Fyzicky je uloženo na souborovém systému serveru. K repository se přistupuje přes Repository Access Layer (RA) systému Subversion a jeho správa se provádí klientskými nástroji. Branch (větev) Slouží k organizaci repository, jedná se o jakousi analogii s adresáři. Pokud se z repository vyzvedne větev, na klientovi vznikne adresářová struktura, která přesně odpovídá větvím v repository. Revision (revize) Revize je pořadové číslo každé změny. Slouží ke sledování změn ve větvích v čase. Každá změna v nějaké větvi vytvoří novou revizi v rámci celé repository. Revize obsahuje informace o tom, co bylo změněno, kdo změnu provedl, poznámku a čas. Pracovní kopie Kopie dat z určité větve z repository v aktuální revizi na pevný disk lokálního klienta. Do pracovní kopie je možné provádět změny, které je možné commitem uložit zpět do repository. Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

23 Základní pojmy Subversion Základní pojmy Commit Odeslání změn provedených od posledního commitu do repository. Commit je nejčastěji používaná změna při práci s repository. Pokud se provádí commit celé pracovní kopie, jedná se o atomickou operaci, jsou odeslány veškeré změny ve všech objektech ve správě verzí; pokud dojde k nějaké chybě při přenosu, není commit pro ostatní uživatele repository zviditelněn, není vytvořena nová revize. Konflikt Konflikt je stav, který signalizuje, že stejný objekt, který má být právě commitován, byl změněn někým jiným a nachází se v repository v aktuální revizi v jiné podobě, než jaký je v pracovní kopii. Nelze provést commit celé pracovní kopie, pokud se v ní nachází jeden nebo více souboru v konfliktu. Changeset Changeset je sada změn, které se posílají z pracovní kopie do repository (nebo sada změn provedená v rámci repository). Subversion ukládá vždy jen informace o provedených změnách, tedy rozdíly mezi jednotlivými revizemi. Tím se spoří místo na disku a snižuje objem dat přenášených z klienta na server. Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

24 Základní pojmy Subversion Základní pojmy Merge Sloučení změn z větve v repository do pracovní kopie. Lze specifikovat určitý rozsah změn, a to intervalem revizí. Cheap-copy Technika, kterou se realizují kopie prováděné v rámci repository. Objekty nejsou v repository fyzicky duplikovány, ale jsou vytvořeny tzv. odkazy (link) na kopírované objekty. Zjednodušeně lze chápat takovýto link jako informaci o URL s číslem revize. Díky tomu má SVN nízké nároky na datový prostor. Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

25 Základní použvání Subversion Charakteristika Subversion Charakteristika Subversion Co to je "Subverison" Je to systém na řízení verzí souborů s jedním centrálním úložištěm. Primárně je určen pro textové soubory zdrojových kódů softwarových projektů. Lze ukládat i jiné typy souborů, například binární, ale uložení změn nemusí být efektivní. Je to software pro různé platformy (Linux, Windows, Solaris). Je to open-source. Jak se se Subversion pracuje? Jedná se o aplikaci klient-server Používá protokoly: nativní SVN a dále http/s, SSH, lze i "file". My budeme používat https Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

33 Základní použvání Subversion Jak lze přistupovat k úložišti SVN? Jak lze přistupovat k úložišti SVN? Příkazovým řádkem klient se jmenuje svn ovládání je nezávislé na operačním systému Integrovaným klientem ve Windows TortoiseSVN je možno použít z jakéhokoliv prohlížeče souborů operačního systému Klienty s vlastním GUI rozhraním jsou volně dostupně nebo komerční např. SmartSVN,... Zabudované klienti ve vývojových prostředích NetBeans Enterprise Architect Visual Studio od MS Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

41 Základní použvání Subversion Jak se pracuje se Subversion Jak se pracuje se Subversion První stažení úložiště Aktualizace pracovní kopie Pracovní kopie checkout, update import, commit SVN úložiště Vložení nového obsahu/ složky do úložiště Promítnutí změn na server Server Pracovní kopie Pracovní kopie Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

42 Základní použvání Subversion 1. Příkaz "import" 1. Příkaz "import" Příkazem vložíme do úložiště obsah složky a včetně podsložek Příkaz ponechává vkládanou složku beze změn. Po vykonání příkazu není složka propojena s úložištěm. Tento příkaz se nebude běžně používat při cvičení IOOP, protože příklady budou připraveny v adresářích každého studenta Propojení zajistíme příkazem checkout (viz dále) Vložení nového obsahu/ složky do úložiště Složka import SVN úložiště Server Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

47 Základní použvání Subversion 1. Příkaz "import" 1. Příkaz "import" Syntaxe svn import [PATH] URL [-m TEXT] Kde PATH cesta ke složce která se bude importovat URL adresa do úložiště SVN kam se bude ukládat m volitelný příkaz pro uložení komentáře k revizi TEXT text s komentářem Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

48 Základní použvání Subversion 1. Příkaz "import" Použití 1. Příkaz "import" Příkazový řádek svn import ukol01 -m "Prvni cviceni" TortoiseSVN Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

49 2. Příkaz "checkout" Základní použvání Subversion 2. Příkaz "checkout" Příkaz stáhne obsah z úložiště SVN do vybrané nebo nové složky Vytvoří lokální/pracovní kopii ve složce Od tohoto okamžiku je nová složka propojena s úložištěm SVN V nové složce se dále vytvoří systémová podsložka.svn, která obsahuje informace o propojení s úložištěm SVN. POZOR: Podsložku.svn neměnit nekopírovat, protože se zachovává vazba na úložiště. První stažení úložiště do pracovní kopie Složka checkout data SVN úložiště Server Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

56 Základní použvání Subversion 2. Příkaz "checkout" 2. Příkaz "checkout" Syntaxe svn checkout [PATH] Kde URL adresa do úložiště SVN REV číslo revize PATH cesta ke složce s pracovní kopií Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

57 Základní použvání Subversion 2. Příkaz "checkout" Použití 2. Příkaz "checkout" Příkazový řádek svn checkout ukol01 TortoiseSVN Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

58 Základní použvání Subversion 3. Operace "commit 3. Operace "commit" Příkaz provede uložení změn do úložiště SVN Lze uložit všechny změněné soubory najednou nebo po částech nebo jednotlivě. Je výhodné, když příkaz provedeme vždy před vypnutím počítače Při každém provedení příkazu se zvýší číslo revize, které je jediné pro celé úložiště. Každé uložení lze/musíme opatřit vysvětlujícím komentářem. Promítnutí změn z pracovní kopie do SVN úložiště Složka s pracovní kopií commit SVN úložiště Klient Server Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

63 Základní použvání Subversion 3. Operace "commit 3. Příkaz "commit" Syntaxe svn commit [PATH] [-m TEXT] Kde PATH cesta ke složce s pracovní kopií m volitelný příkaz pro uložení komentáře k revizi TEXT text s komentářem Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

64 Základní použvání Subversion 3. Operace "commit" Použití 3. Operace "commit Příkazový řádek svn commit -m "konecna verze ukolu 01" tento příkaz musí být spuštěn ze složky s pracovní kopií TortoiseSVN Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

65 4. Příkaz "update" Základní použvání Subversion 4. Příkaz "update" Příkazem aktualizujeme pracovní kopii na svém počítači na poslední změny z úložiště SVN. Tento příkaz vykonáváme vždy když: zahajujeme práci nebo zapínáme počítač sami pracujeme na více počítačích a chceme mít na všech aktuální verze souborů kolegové ukončí práci na sdílených souborech V případě, že tytéž soubory upravuje více lidí, bude náš obsah v pracovní kopii bud automaticky sloučen nebo se nahlásí konflikty, které musíme ručně vyřešit. Aktualizace pracovní kopie Složka s pracovní kopií update data SVN úložiště Server Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

71 4. Příkaz "update" Základní použvání Subversion 4. Příkaz "update" Syntaxe svn update [PATH] Kde PATH cesta ke složce s pracovní kopií Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

72 Základní použvání Subversion 4. Příkaz "update" Použití 4. Příkaz "update" Příkazový řádek svn update Příkaz musí být spuštěn ve složce s pracovní kopií TortoiseSVN Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

73 Připojení k úložišti Subversion Autentizace Autentizace Autentizace je při správě verzí velmi důležitá protože: chceme mít zajištěno kdo provedl jakou změnu umožňuje řízený přístup k jednotlivým částem úložiště pro každého uživatele je možné nastavit, zda může číst nebo i zapisovat Protože je zvolen protokol HTTPS, je nutné při prvním přístupu převzít certifikát. Certifikát je vydán samotným serverem (prozatím) proto se při prohlížení úložiště internetovým prohlížečem se ještě musí schválit bezpečnostní výjimky. Jak se přihlásit? Studenti i vyučující se přihlašují svým účtem do domény UPCE (NetID). Heslo je stejné jako do UPCE Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

80 Připojení k úložišti Subversion Přístup k úložišti Odkud? Zatím pouze z tzv. "učeben a po drátu" Snažíme se o připojení jak z "eduroam"nebo po Internetu až se povede "zpracovat"ic, oznámíme to na cvičení nebo přednáškách Kam? Každý student má přidělen prostor na adrese nebo Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

81 Organizace úložišt Organizace úložišt Každý předmět (tj. IOOP a INPSW) má své úložiště. Úložiště jsou rozdělena na část věnované přednáškám dostupné literatuře (v pdf, MS Word apod) materiálům pro cvičení věnované každému studentovi tj. jeho pracovní prostor Každý student může měnit stav úložiště pouze ve svém pracovním prostoru. Každá změna je evidována, včetně toho kdo a kdy ji provedl. V úložišti se pamatují všechny přechozí stavy a lze se tedy i po destruktivním zásahu vrátit k jakémukoliv předchozímu stavu. Karel Šimerda (KST, FEI) IOOP/INPSW 1. února / 25

Zobrazit více