Nieoficjalne
Na tej stronie
  1. 01Włącz moduł
  2. 02Utwórz repozytorium lub bucket
  3. 03Nadaj uprawnienia
  4. 04Pobierz repozytorium SVN (check out)
  5. 05Podłącz bucket jako dysk sieciowy
  6. 06Historia i starsze wersje
  7. 07Pokaż repozytorium w internecie
  8. 08Uwierzytelnianie dwuskładnikowe i hasło aplikacji

Repozytoria SVN i wersjonowane buckety na Twoim NAS-ie

Bucket & Code Server IDE udostępnia repozytoria Subversion i wersjonowane buckety. Bucket to folder, który przechowuje każdą zapisaną wersję pliku jako rewizję i jest dostępny przez WebDAV, jak dysk sieciowy. Dzięki temu możesz odczytać lub przywrócić dowolną wcześniejszą wersję. Do obu usług logujesz się kontem panelu.

  1. ModułSVN & Bucket włączony
  2. Utwórzrepozytorium lub bucket
  3. Uprawnieniadla każdego konta
  4. Połączsvn, Finder, davfs2, rclone
  5. Cofnijdowolną starszą wersję

Zrzut karty hasła aplikacji pochodzi z danych testowych panelu. W przykładach repozytorium nazywa się docs, bucket shared, a NAS ma adres 192.168.1.20.

01Włącz moduł

Na stronie Przegląd administrator naciska Włącz SVN & Bucket na kafelku. Kafelek pokazuje działa, gdy moduł jest gotowy.

Kafelek SVN & Bucket na Przeglądzie, gdy jest wyłączony: httpd z mod_dav_svn, co daje, oraz przycisk Włącz SVN & Bucket

02Utwórz repozytorium lub bucket

Na stronie SVN i Bucket administrator naciska Nowe repozytorium lub bucket.

  1. Wybierz Repozytorium SVN jeśli chcesz używać svn checkout i commit, albo Bucket, jeśli chcesz dysku sieciowego, do którego nie potrzeba klienta SVN.
  2. W polu Nazwa wpisz nazwę. Z niej powstaje adres: /svn/docs lub /bucket/shared.
  3. Dla bucketu zostaw zaznaczone Odrzucaj pliki ._* i .DS_Store z macOS. Finder zapisuje takie pliki obok każdego kopiowanego pliku. Odrzucone pliki nie tworzą rewizji. Tego ustawienia nie da się później zmienić.
  4. Naciśnij Utwórz.
Nowe repozytorium lub bucket: wybrano repozytorium SVN, Nazwa docs, adres /svn/docs oraz przycisk UtwórzNowe repozytorium lub bucket: wybrano Bucket, Nazwa shared, adres /bucket/shared, zaznaczona opcja odrzucania plików ._* i .DS_Store z macOS

Usunięte repozytorium lub bucket trafia do kosza w folderze danych. Wbudowane zadanie opróżnia kosz po 7 dniach.

03Nadaj uprawnienia

Do nowego repozytorium lub bucketu dostęp mają tylko administratorzy. Ikona osób w jego wierszu otwiera okno Uprawnienia do docs. W polu Wszyscy pozostali ustaw dostęp dla kont spoza listy. Każdemu kontu, które potrzebuje więcej, ustaw read albo odczyt i zapis, a potem naciśnij Zapisz. Ten sam dostęp obowiązuje w SVN, w WebDAV i w przeglądarce plików w panelu. Administratorzy zawsze mają odczyt i zapis, a konto z rolą viewer najwyżej odczyt.

Uprawnienia do docs: Wszyscy pozostali bez dostępu, deweloper ola z odczytem i zapisem oraz przycisk Zapisz

04Pobierz kopię roboczą repozytorium SVN

Strona SVN i Bucket pokazuje polecenie checkout z adresem repozytorium. Możesz użyć dowolnego klienta Subversion (svn, TortoiseSVN, obsługa SVN w dowolnym IDE): logujesz się nazwą konta i hasłem z panelu. Do commitu potrzebny jest dostęp do odczytu i zapisu.

Repozytorium SVN: svn checkout "https://192.168.1.20:9951/svn/docs"

Na początku NAS używa dla HTTPS certyfikatu z podpisem własnym, więc klient pyta, czy mu zaufać, albo go odrzuca. Odcisk palca certyfikatu, do porównania, pokazuje strona Sieć.

05Podłącz bucket jako dysk sieciowy

Ta sama strona podaje adres bucketu dla każdego systemu.

  • macOS: w Finderze Przejdź → Połącz z serwerem (⌘K), następnie https://192.168.1.20:9951/bucket/shared/. Bucket jako dysk sieciowy, macOS: w Finderze Przejdź, Połącz z serwerem, potem https://192.168.1.20:9951/bucket/shared/
  • Linux: zamontuj go przez davfs2 albo dodaj w rclone zdalny zasób (remote) typu webdav z dostawcą „other” i zamontuj go. Bucket jako dysk sieciowy, Linux: sudo mount -t davfs z adresem bucketu albo rclone mount nas-shared: ~/shared --vfs-cache-mode writes
  • Windows: Usługa WebClient, z której korzysta Eksplorator, loguje się tylko przez HTTPS z certyfikatem, któremu ufa Windows. Dlatego Eksplorator potrzebuje przed NAS-em odwrotnego proxy z prawdziwym certyfikatem. Bez takiego proxy użyj WinSCP lub Cyberduck (WebDAV z TLS) albo rclone; rclone mount na Windows wymaga WinFsp. Bucket jako dysk sieciowy, Windows: uwaga o Eksploratorze i zaufanym certyfikacie, WinSCP lub Cyberduck lub rclone oraz adres bucketu

Każdy zapis tworzy rewizję z nazwą konta i godziną. Wiele klientów najpierw zapisuje pusty plik, a dopiero potem dane, więc jeden zapis może utworzyć dwie rewizje. Przy odrzuconym pliku z macOS klient nie dostaje błędu: plik po prostu nie trafia do historii.

06Historia i starsze wersje

Otwórz plik i naciśnij Historia tego pliku. Każda rewizja ma komunikat, autora, przycisk Pokaż, różnice względem poprzedniej rewizji oraz przyciski Pobierz i Przywróć.

Historia /trunk/README.md: r3 Popraw polecenie budowania, r2 Opisz kroki wydania, r1 Dodaj README, każda z przyciskami Zobacz, Różnica, Pobierz i Przywróć

Przy starszej wersji konto z dostępem do odczytu i zapisu widzi przycisk Przywróć tę wersję. Przycisk pyta o komunikat commitu i zapisuje starą treść jako nową rewizję, więc późniejsze wersje zostają w historii.

README.md w wersji r2, z przyciskami Historia tego pliku, Pobierz r2 i Przywróć tę wersję Przywrócić tę wersję?: Komunikat zatwierdzenia Przywróć /trunk/README.md do r2 oraz przycisk Przywróć r2

Bucket ma taką samą historię. Jego rewizje mają oznaczenie autowersjonowana, bo plik zapisał klient WebDAV.

Historia pliku /price-list.txt z bucketu: trzy rewizje, każda oznaczona jako autowersja

07Pokaż repozytorium w sieci

Przełącznik W sieci w wierszu (admin) udostępnia stronę tylko do odczytu z plikami, historią i różnicami. Otworzy ją bez konta każdy, kto zna adres. Zobacz w sieci otwiera tę stronę: https://192.168.1.20:9951/svn-web/docs/ dla repozytorium, /bucket-web/<name>/ dla bucketu.

Repozytoria i buckety: docs, SVN, r3, W sieci włączone z Zobacz w sieci; shared, Bucket, r3, Pliki ._* z macOS nieprzechowywane, W sieci wyłączone Publiczna strona docs: Pliki w r3 w trunk, README.md, 105 B, zmieniony w r3 przez olaPubliczna strona rewizji 3: Fix the build command, /trunk/README.md zmodyfikowany oraz jego różnice
  • Na tych stronach nie da się niczego zmienić. Klienty svn i WebDAV nadal muszą się logować, także do publicznego repozytorium.
  • Repozytorium niepubliczne i nieistniejąca nazwa dają tę samą odpowiedź, więc strony nie zdradzają, jakie nazwy istnieją. Strony proszą wyszukiwarki, żeby ich nie indeksowały.

08Uwierzytelnianie dwuskładnikowe i hasło aplikacji

W klientach SVN i WebDAV konto z uwierzytelnianiem dwuskładnikowym nie używa swojego hasła. Na stronie konta przycisk Utwórz hasło aplikacji pokazuje losowe hasło, tylko raz. Nowe hasło aplikacji zastępuje poprzednie. Zmiana hasła konta albo wyłączenie uwierzytelniania dwuskładnikowego usuwa hasło aplikacji.

Hasło aplikacji dla WebDAV i SVN: Hasła aplikacji jeszcze nie ma, oraz przycisk Utwórz hasło aplikacji

Pięć błędnych haseł w ciągu 15 minut blokuje na 15 minut to konto z tego adresu, a także sam adres, tak jak przy logowaniu do panelu. Przewodnik wymienia klienty WebDAV i ich limity.