INFORMACJE DLA STUDENTA

Repozytoria służą do przekazywania prowadzącym kodów źródłowych programów i innych ręcznie utworzonych plików (jak n.p. sprawozdania), stanowiących rozwiązania zadań.

Ustawianie hasła dostępu

W celu uzyskania możliwości ustawiania hasła dostępu do repozytorium, student musi wysłać ze swojego oficjalnego konta studenckiego swój klucz publiczny zgodnie z instrukcjami podanymi TUTAJ. (Umożliwi to również dostęp do innych serwisów tworzonych na potrzeby kursów.)

Ustawianie własnego hasła dostępu można wykonać przez VPN lub z sieci na PWR, poleceniem:

Nie wolno ujawniać swojego hasła innym osobom.

Adresy URL

Student ma dostęp przez przeglądarkę internetową do swojej kolekcji repozytoriów, w której znajdują się repozytoria dla poszczególnych prowadzących. Np. student o indeksie 000000 ma

• swoją kolekcję pod adresem: https://repo.cs.pwr.edu.pl/000000-dir/
• oraz swoje repozytorium dla prowadzącego mk1 dostępne przez URL: https://repo.cs.pwr.edu.pl/000000-dir/mk1/

Ostrzeżenia

• Ze względów bezpieczeństwa ważne jest aby przy dostępie używać protokołu "https://" a nie "http://"
• Repozytorium nie wysyła żadnych automatycznych powiadomień do prowadzącego. Student musi poinformować prowadzącego o umieszczeniu swoich plików z rozwiazaniami w repozytorium, niezależnie, w sposób wymagany przez prowadzącego. (Zależnie od decyzji prowadzącego, może to być np.: zgłoszenie w trakcie zajęć, email, albo inny sposób komunikacji.)
• Należy sobie zdawać sprawę, że użytkownik nie może usunąć niczego, co już wysłał do repozytorium. (Polecenie: `svn delete ...` usuwa element tylko z kolejnej zatwierdzonej wersji, ale pamiętane są wszystkie wcześniejsze wersje.)
• Co pewien czas (między semestrami lub w wyniku przepełnienia lub awarii serwera) repozytoria mogą być usuwane. Użytkownik powinien sobie zapewnić własne kopie zapasowe plików, które chce zachować. (Jedną z takich kopii jest kopia robocza, ale nie ma w niej poprzednich wersji i usuniętych plików.)

Krótka instrukcja dla początkujących:

1. Zainstalować sobie pakiet o nazwie subversion, który zawiera polecenie svn (klient svn-a)
2. Po ustawieniu hasła "${haslo}" student powinien utworzyć sobie kopię roboczą swojego (początkowo pustego) repozytorium dla prowadzącego "${id}", jako użytkownik o nazwie "${nr_indeksu}" poleceniem:
   $ svn checkout https://repo.cs.pwr.edu.pl/${nr_indeksu}-dir/${id} --username ${nr_indeksu} --password ${haslo}
   Polecenie to utworzy w bieżącym katalogu podkatalog o nazwie "${id}", zawierający kopię roboczą repozytorium. (Kopie robocze można rozpoznać po tym, że zawierają ukryty podkatalog .svn ) Na przykład student o indeksie 000000 tworzy kopię roboczą repozytorium dla prowadzącego mk1 poleceniem:
   $ svn checkout https://repo.cs.pwr.edu.pl/000000-dir/mk1
3. W kopii roboczej można tworzyć podkatalogi i umieszczać własne pliki z kodami źródłowymi programów. Pliki, które mają być przesyłane do repozytorium należy najpierw dodać lokalnie w kopii roboczej poleceniem:
   $ svn add ...
   (UWAGA: DO REPOZYTORIUM DODAJEMY TYLKO KODY ŹRÓDŁOWE I NIEAUTOMATYCZNIE UTWORZONE - NIE DODAWAĆ SKOMPILOWANYCH BINARNYCH PLIKÓW)
   Polecenie:
   $ svn status
   wyświetla stan kopii roboczej względem repozytorium (na przykład nowo dodane pliki są wyświetlane i oznaczone symbolem 'A', a pliki które nie podlegają wersjonowaniu są oznaczone symbolem '?').
4. Nowo dodane pliki (oraz zmodyfikowane pliki, które już podlegają wersjonowaniu) przesyłane są do repozytorium po wykonaniu polecenia:
   $ svn commit -m ""
5. Należy sobie przyswoić następujący cykl pracy w katalogu, który jest kopią roboczą:
   $ svn update # aktualizacja lokalnej kopii roboczej do najnowszej wersji z serwera
$ ... # praca nad projektem, modyfikacja kodów źródłowych (nowe pliki źródłowe dodajemy przez: svn add ...)
$ svn commit -m "..." # wysyłanie wprowadzonych zmian do repozytorium


Kompletny podręcznik SVN jest dostępny pod adresem: http://svnbook.red-bean.com/