Onofficieel
Op deze pagina
  1. 01Schakel de module in
  2. 02Maak een repository of een bucket aan
  3. 03Geef toegang
  4. 04Check een SVN-repository uit
  5. 05Verbind een bucket als netwerkstation
  6. 06Geschiedenis en oudere versies
  7. 07Toon een repository op het web
  8. 08Tweefactorauthenticatie en het app-wachtwoord

SVN-repositories en versiegebaseerde buckets op je NAS

Bucket & Code Server IDE biedt Subversion-repositories en buckets aan. Een bucket is een netwerkschijf (WebDAV) die elk opgeslagen bestand als revisie bewaart, zodat elke eerdere versie kan worden gelezen of teruggezet. Gebruikers melden zich bij beide diensten aan met hun paneelaccount.

  1. ModuleSVN & Bucket aan
  2. Makeneen repository of een bucket
  3. Machtigingenper account
  4. Verbindensvn, Finder, davfs2, rclone
  5. Terugkijkenelke oudere versie

De kaart met het app-wachtwoord komt uit de testgegevens van het paneel. De repository heet docs, de bucket shared, en de NAS staat op 192.168.1.20.

01Schakel de module in

Op het Overzicht drukt een beheerder op SVN & Bucket aanzetten op de tegel. De tegel toont actief wanneer de module klaar is.

De SVN & Bucket-tegel op het Overzicht terwijl die uit staat: httpd met mod_dav_svn, wat het biedt, en de knop SVN & Bucket aanzetten

02Maak een repository of een bucket

Op de pagina SVN & Bucket drukt een beheerder op Nieuwe repository of bucket.

  1. Kies SVN-repository voor svn checkout en commit, of Bucket voor een netwerkschijf die geen SVN-client nodig heeft.
  2. Typ een Naam. Die wordt het adres: /svn/docs of /bucket/shared.
  3. Laat voor een bucket De macOS-bestanden ._* en .DS_Store weigeren aangevinkt. Finder zet die bestanden naast elk bestand dat het kopieert; worden ze geweigerd, dan worden ze ook nooit revisies. Deze keuze kun je later niet meer wijzigen.
  4. Druk op Aanmaken.
Nieuwe repository of bucket: SVN-repository gekozen, Naam docs, het adres /svn/docs en de knop AanmakenNieuwe repository of bucket: bucket gekozen, Naam shared, het adres /bucket/shared, De macOS-bestanden ._* en .DS_Store weigeren aangevinkt

Als je een repository of bucket verwijdert, gaat die naar de prullenbak in de datamap. Een ingebouwde taak leegt de prullenbak na 7 dagen.

03Toegang geven

Een nieuwe repository of bucket geeft alleen de beheerders toegang. Het pictogram met de poppetjes in de rij opent Machtigingen voor docs. Bij Alle anderen kies je de toegang voor accounts die niet in de lijst staan. Geef elk account dat meer nodig heeft read of lezen en schrijven en druk dan op Opslaan. Dezelfde toegang geldt via SVN, WebDAV en de bestandsbrowser van het paneel. Beheerders kunnen altijd lezen en schrijven; een viewer kan hooguit lezen.

Machtigingen voor docs: alle anderen geen toegang, de developer ola krijgt lezen en schrijven, en de knop Opslaan

04Een SVN-repository uitchecken

De pagina SVN & Bucket toont het uitcheckcommando met het adres van de repository. Elke Subversion-client werkt (svn, TortoiseSVN, de SVN-ondersteuning van een IDE) met de gebruikersnaam en het wachtwoord van het paneel. Voor een commit is lees- en schrijftoegang nodig.

Een SVN-repository: svn checkout "https://192.168.1.20:9951/svn/docs"

Via HTTPS gebruikt de NAS eerst een zelfondertekend certificaat. Een client vraagt dan of je het vertrouwt, of weigert het. De pagina Netwerk toont de vingerafdruk van het certificaat, zodat je die kunt vergelijken.

05Een bucket als netwerkschijf verbinden

Dezelfde pagina geeft het adres van de bucket voor elk systeem.

  • macOS: in Finder, Ga → Verbind met server (⌘K), en vul daarna https://192.168.1.20:9951/bucket/shared/ in. Een bucket als netwerkschijf, macOS: in Finder, Ga, Verbind met server, daarna https://192.168.1.20:9951/bucket/shared/
  • Linux: koppel de bucket met davfs2, of voeg in rclone een remote van het type webdav toe met leverancier “other” en koppel die. Een bucket als netwerkschijf, Linux: sudo mount -t davfs met het adres van de bucket, of rclone mount nas-shared: ~/shared --vfs-cache-mode writes
  • Windows: de WebClient van Verkenner meldt zich alleen via HTTPS aan met een certificaat dat Windows vertrouwt, dus Verkenner heeft een reverse proxy met een echt certificaat vóór de NAS nodig. Zonder die proxy gebruik je WinSCP of Cyberduck (WebDAV met TLS), of rclone; rclone mount op Windows heeft WinFsp nodig. Een bucket als netwerkschijf, Windows: de opmerking over Verkenner en een vertrouwd certificaat, WinSCP of Cyberduck of rclone, en het adres van de bucket

Elke keer dat je opslaat, ontstaat een revisie met de naam van het account en het tijdstip. Veel clients schrijven eerst een leeg bestand en daarna de gegevens, dus één keer opslaan kan twee revisies opleveren. Een geweigerd macOS-bestand geeft de client geen foutmelding; het wordt gewoon nooit een revisie.

06Geschiedenis en oudere versies

Open een bestand en druk op Geschiedenis van dit bestand. Elke revisie heeft zijn bericht, zijn auteur, Bekijken, een diff met de vorige, Downloaden en Herstellen.

Geschiedenis van /trunk/README.md: r3 Het buildcommando repareren, r2 De releasestappen beschrijven, r1 Het README toevoegen, elk met Bekijken, Diff, Downloaden en Herstellen

Bij een oudere versie zien accounts met lees- en schrijftoegang de knop Deze versie herstellen. Die vraagt om een commitbericht en slaat de oude inhoud op als nieuwe revisie, zodat de latere versies in de geschiedenis blijven.

README.md zoals het was in r2, met de knoppen Geschiedenis van dit bestand, r2 downloaden en Deze versie herstellen Deze versie herstellen?: Commitbericht /trunk/README.md herstellen naar r2, en de knop r2 herstellen

Een bucket houdt dezelfde geschiedenis bij. De revisies zijn gemarkeerd als autoversioned: een WebDAV-client heeft het bestand opgeslagen.

Geschiedenis van /price-list.txt in de bucket: drie revisies, elk gemarkeerd als autoversioned

07Een repository op het web tonen

De schakelaar Op het web bij een rij (beheerder) geeft iedereen met het adres een alleen-lezen pagina met de bestanden, de geschiedenis en de diffs, zonder account. Bekijken op het web opent die pagina: https://192.168.1.20:9951/svn-web/docs/ voor een repository, /bucket-web/<name>/ voor een bucket.

Repository’s en buckets: docs, SVN, r3, Op het web aan met Bekijken op het web; shared, Bucket, r3, macOS-bestanden ._* niet bewaard, Op het web uit De openbare pagina van docs: Bestanden in r3 in trunk, README.md, 105 B, gewijzigd in r3 door olaDe openbare pagina van revisie 3: Het buildcommando repareren, /trunk/README.md gewijzigd, en de diff
  • De pagina's wijzigen niets. svn- en WebDAV-clients melden zich nog steeds aan, ook voor een openbare repository.
  • Een repository die niet openbaar is en een naam die niet bestaat, geven hetzelfde antwoord, dus de pagina's laten niet zien welke namen bestaan. Zoekmachines wordt gevraagd ze niet te indexeren.

08Tweefactorauthenticatie en het app-wachtwoord

Een account met tweefactorauthenticatie gebruikt zijn wachtwoord niet in SVN- en WebDAV-clients. Op de pagina van het account toont Een app-wachtwoord maken eenmalig een willekeurig wachtwoord. Een nieuw app-wachtwoord vervangt het oude. Als je het wachtwoord wijzigt of tweefactorauthenticatie uitzet, wordt het app-wachtwoord verwijderd.

App-wachtwoord voor WebDAV en SVN: nog geen app-wachtwoord, en de knop Een app-wachtwoord maken

Na vijf verkeerde wachtwoorden binnen 15 minuten worden dat account (vanaf dat adres) en het adres zelf 15 minuten geblokkeerd, net als bij de aanmelding op het paneel. De gebruikershandleiding somt de WebDAV-clients en hun limieten op.