Linia 1: |
Linia 1: |
− | #PATRZ [[Konto ASP]]
| + | Aby uzyskać konto svn należy napisać maila do [mailto:konta@wit.edu.pl konta@wit.edu.pl] z uzasadnieniem po co nam takie konto. |
| + | |
| + | Jako klienta svn polecamy:[http://tortoisesvn.net TortoiseSVN], natomiast pod linuxa [http://subversion.tigris.org Subversion]. |
| + | |
| + | ==Windows - TortoiseSVN== |
| + | Klient istnieje na platformy "32-bitowe":http://prdownloads.sourceforge.net/tortoisesvn/LanguagePack-1.4.1.7992-win32-pl.exe?download i "64-bitowe":http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.4.1.7992-x64-svn-1.4.2.msi?download. |
| + | Po instalacji <ins>konieczny</ins> jest restart komputera. |
| + | Można jeszcze dodatkowo zainstalować spolszczenie (odpowiednio do "32-bitowej":http://prdownloads.sourceforge.net/tortoisesvn/LanguagePack-1.4.1.7992-win32-pl.exe?download i "64-bitowej":http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.4.1.7992-x64-svn-1.4.2.msi?download wersji) oraz polski słownik. |
| + | |
| + | ===Ustalenie uprawnień=== |
| + | Bezpośrednio po uzyskaniu konta na szkolnym serwerze svn należy sciągnąć specjalne repozytorium w którym znajdują się pliki definiujące prawa dostępu do katalogów/repozytoriów. |
| + | |
| + | Utwórz katalog svn, a w nim svnaccess: |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok01.png" /> |
| + | Kliknij prawym przyciskiem myszy w wolne miejsce w katalogu, z menu wybierz "SVN Checkout" |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok02.png" /> |
| + | |
| + | W oknie które się pojawi wpisz "https://svn.wsisiz.edu.pl/repos/svnaccess" i kliknij OK |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok03.png" /> |
| + | |
| + | Jeżeli okno dialogowe nie pokaże żadnych błędów klikamy OK. |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok04.png" /> |
| + | |
| + | Katalog svnaccess powinien zawierać teraz podkatalogi z nazwami wszystkich użytkowników korzystających z svn |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok05.png" /> |
| + | |
| + | wchodzimy do katalogu z własną nazwą użytkownika |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok06.png" /> |
| + | |
| + | za pomocą edytora potrafiącego prawidłowo interpretować UNIX-owe końce linii (np. EditPlus) edytujemy plik svnaccess: |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok07.png" /> |
| + | |
| + | oraz groups: |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok08.png" /> |
| + | |
| + | ====Składnia pliku svnaccess==== |
| + | Plik svnaccess jest podzielony na sekcje. Nazwa sekcji zawiera się pomiędzy nawiasami "[" i "]". Tak więc w tym pliku są dwie sekcje: "kario:/" i "kario:/projekt/".<br /> Pierwsza z nich jest obowiązkowa i opisuje prawa dostępu do katalogu głównego na serwerze svn, pozostałe są opcjonalne, ta, która znajduje się w przykładzie definiuje prawa dostępu do podkatalogu "projekt". |
| + | |
| + | W każdej sekcji możemy zdefiniować użytkowników którzy będą mieć prawo zapisu i odczytu (rw), jedynie odczytu (r), lub nie będą mieć praw ( ). |
| + | |
| + | Dla pokazanego pliku konfiguracyjnego użytkownik kario ma pełne prawa do katalogu głównego i podkatalogu projekt. Użytkownik mojkolega ma pełne prawa do katalogu głównego. Wszystkich pozostałych użytkowników określa się przez ' * ', tak więc wszyscy mogą czytać katalog główny, jednak nie mają dostępu do podkatalogu projekt. Nazwę grupy użytkowników poprzedzamy znakiem "@", tak więc w tym przykładzie użytkownicy w grupie "kario-projekt" mają pełne prawa do katalogu projekt.</div> |
| + | |
| + | Oczywiście nazwy użytkowników muszą być zgodne z nazwami użytkownika w sieci WIT. |
| + | |
| + | ====Składnia pliku groups==== |
| + | W pliku groups definiujemy grupy użytkowników po to aby móc wygodniej zarządzać prawami dostępu do swoich katalogów. |
| + | |
| + | Każda linijka tego pliku określa jedną grupę użytkowników! Nie można "zawijać" wierszy enterem! |
| + | |
| + | Definicja grupy składa się z twojej nazwy użytkownika, pauzy oraz dowolnego ciągu znaków alfanumerycznych (polskie ogonki są niedozwolone), spacji, znaku równości, kolejnej spacji oraz listy użytkowników (szkolnych loginów) pooddzielanych przecinkami.</div> |
| + | |
| + | Aby nowe ustawienia zaczęły działać musisz przejść do katalogu nadrzędnego względem svnaccess (w naszym przykładzie do svn): |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok09.png" /> |
| + | |
| + | Kliknąć prawym przyciskiem myszy na katalog i z menu wybrać "SVN Commit..." |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok10.png" /> |
| + | |
| + | Nowa formatka w górnej części zawiera pole "Message", służące do opisywania zmian które poczyniliśmy w plikach. Dolna część zawiera listę plików które modyfikowaliśmy. Upewnij się, że pole przy "Select/Deselect All" jest zaznaczone i kliknij OK |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok11.png" /> |
| + | |
| + | Klient powinien poprosi o nazwę użytkownika i hasło. Wpisujesz swój szkolny login oraz hasło systemowe. |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok12.png" /> |
| + | |
| + | Po paru chwilach zawartość plików powinna zostać zaktualizowana, a tobie przedstawione okno podobne do tego poniżej. |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok13.png" /> |
| + | |
| + | ===Korzystanie z repozytorium=== |
| + | ====Uaktualnianie repozytorium==== |
| + | Utwórz katalog o nazwie zgodnej z twoją nazwą użytkownika w katalogu svn: |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok14.png" /> |
| + | |
| + | Kliknij na niego prawym przyciskiem myszy i wybierz opcję "SVN Checkout..." |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok15.png" /> |
| + | |
| + | Do paska adresu wpisz "https://svn.wsisiz.edu.pl/repos/user" zastępując "user" swoim szkolnym loginem. Kliknij OK. |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok16.png" /> |
| + | |
| + | W następnym okienku kliknij OK |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok17.png" /> |
| + | |
| + | Pozostałe kroki są nieobowiązkowe, służą jednie pokazaniu sposobu w jaki korzysta się z svn-a. |
| + | |
| + | Teraz utworzymy katalog projekt, a w nim plik main.c |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok18.png" /> |
| + | |
| + | Aby wysłać zmiany na serwer ponownie przechodzimy do katalogu svn, klikamy prawym przyciskiem myszy na folderze i wybieramy opcję "SVN Commit..." |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok19.png" /> |
| + | |
| + | W oknie które się pojawi w polu message wpisujemy "Utworzenie katalogu projekt oraz pliku main.c". Oraz upewniamy się, że pole przy "Select / Deselect All" jest zaznaczone. |
| + | |
| + | Jak widać tortoiseSVN podkreśla błędy ortograficzne i rozpoznaje wpisywane nazwy plików, w moim wypadku podkreśli większość słów ponieważ nie mam zainstalowanego polskiego słownika. |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok20.png" /> |
| + | |
| + | Jeżeli nie zaznaczyłeś(łaś) pola przy "Save authentication", program powinien się ponownie zapytać o hasło: |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok21.png" /> |
| + | |
| + | Po poprawnym uaktualnieniu repozytorium powiniene ujrzeć okno podobne do zamieszczonego poniżej: |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok22.png" /> |
| + | |
| + | ====Ściąganie nowych wersji==== |
| + | |
| + | Przejdź do katalogu svn, kliknij prawym przyciskiem myszy na katalog z repozytorium które chcesz uaktualnić i wybierz opcję "SVN Update" |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok23.png" /> |
| + | |
| + | Po klikniciu powinno pojawi się okno podobne do poniższego, oznacza to, że pliki w katalogu zostały zaktualizowane do wersji znajdującej się na serwerze. |
| + | |
| + | <img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok24.png" /> |
| + | |
| + | Dalsze informacje o TortoisseSVN możesz znaleźć na stronie internetowej projektu: "http://tortoisesvn.net/doc_release":http://tortoisesvn.net/doc_release |
| + | |
| + | ==Linux - subversion== |
| + | ===Ustalanie uprawnień=== |
| + | Utwórz katalog svn w folderze domowym: |
| + | <pre><code>cd |
| + | mkdir svn< |
| + | cd svn |
| + | </code> |
| + | </pre> |
| + | |
| + | Ściągnij repozytorium svnaccess: |
| + | |
| + | Jeżeli pracujesz na oceanicu wcześniej musisz wydać komendę <code>export LC_ALL=en_US</code>. |
| + | |
| + | <pre><code>svn co https://svn.wsisiz.edu.pl/repos/svnaccess</code></pre> |
| + | |
| + | przejdź do katalogu o nazwie zgodnej z twoim loginem: |
| + | |
| + | <code>cd svnaccess/user</code> |
| + | |
| + | zmień pliki svnaccess oraz groups tak aby odpowiadały twoim potrzebom. |
| + | |
| + | ===Składnia pliku svnaccess=== |
| + | <pre> |
| + | [kario:/] |
| + | kario = rw |
| + | * = r |
| + | [kario:/jacob/] |
| + | kario = rw |
| + | @kario-projekt = rw |
| + | * = |
| + | </pre> |
| + | |
| + | Plik svnaccess jest podzielony na sekcje. Nazwa sekcji zawiera się pomiędzy nawiasami "[" i "]". Tak więc w tym pliku s dwie sekcje: "kario:/" i "kario:/projekt/". |
| + | |
| + | Pierwsza z nich jest obowiązkowa i opisuje prawa dostępu do katalogu głównego na serwerze svn, pozostałe są opcjonalne, ta, która znajduje się w przykadzie definiuje prawa dostępu do podkatalogu "projekt". |
| + | |
| + | W każdej sekcji możemy zdefiniować użytkowników którzy będą mieć prawo zapisu i odczytu (rw), jedynie odczytu (r), lub nie będą mieć praw ( ). |
| + | |
| + | Dla pokazanego pliku konfiguracyjnego użytkownik kario ma pełne prawa do katalogu głównego i podkatalogu projekt. Użytkownik mojkolega ma pełne prawa do katalogu głównego. Wszystkich pozostałych użytkowników określa się przez "*", tak więc wszyscy mogą czytać katalog główny, jednak nie mają dostępu do podkatalogu projekt. Nazwę grupy użytkowników poprzedzamy znakiem "@", tak więc w tym przykładzie użytkownicy w grupie "kario-projekt" mają pełne prawa do katalogu projekt. |
| + | |
| + | ==Wizualizacja zawartości repozytorium== |
| + | Zawartość repozytoriów jest także wizualizowana pod adresem: [https://svn.wsisiz.edu.pl/viewvc https://svn.wsisiz.edu.pl/viewvc]. |
| + | |
| + | [[category:Zasoby_sieciowe]] |
| + | [[category:Instrukcje]] |