repo.cs.pwr.edu.pl

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:


	  ssh -i klucz_prywatny -p 59002 auth@156.17.7.16

gdzie 'klucz_prywatny' był wygenerowany w parze z dostarczonym kluczem publicznym ssh i zwykle ma postać: '~/.ssh/id_rsa'.

Nie wolno ujawniać swojego hasła innym osobom.

Adres URL

Repozytorium ma adres URL postaci https://repo.cs.pwr.edu.pl/${id}-${numer_indeksu} . Do takiego repozytorium dostęp mają:

student o numerze indeksu ${numer_indeksu} oraz
prowadzący o identyfikatorze ${id}.

Na przykład prowadzący o identyfikatorze mk1 i student o numerze indeksu 000000 mają repozytorium o adresie: https://repo.cs.pwr.edu.pl/mk1-000000

Ten adres może też służyć do oglądania zawartości repozytorium przez przeglądarkę internetową. Należy podać ${nr_indeksu} jako nazwę użytkownika oraz swoje hasło do repozytorium.

Student ma dostęp przez przeglądarkę internetową do swojej kolekcji repozytoriów 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:

Zainstalować sobie pakiet o nazwie subversion, który zawiera polecenie svn (klient svn-a)
Po ustawieniu hasła "$haslo" student powinien utworzyć sobie kopię roboczą swojego (początkowo pustego repozytorium) jako użytkownik o nazwie "${nr_indeksu}" poleceniem:
$ svn checkout https://repo.cs.pwr.edu.pl/${id}-${nr_indeksu} --username $nr_indeksu --password $haslo
Polecenie to utworzy w bieżącym katalogu katalog o nazwie "${nr_indeksu}", zawierający kopię roboczą repozytorium. (Kopie robocze można rozpoznać po tym, że zawierają ukryty podkatalog .svn )
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 '?').
Nowo dodane pliki (oraz zmodyfikowane pliki, które już podlegają wersjonowaniu) przesyłane są do repozytorium po wykonaniu polecenia:
$ svn commit -m ""
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/