Difference between revisions of "Subversion"

From Cncz
Jump to: navigation, search
Line 3: Line 3:
 
----
 
----
  
[[OldSubversionPage]]
+
== Migrating from Subversion ==
 +
We have automated the migration from [[Subversion]] to GitLab. Contact postmaster@science.ru.nl if you whish to have clone access to your migrated repository.
  
==[Introductie][Introduction]==
 
[[Bestand:subversion.png|thumb|alt=Subversion logo|Subversion]]
 
  
[nl]
+
== Manual migration from Subversion ==
Subversion (SVN) is een revisiebeheersysteem waarmee het mogelijk is om bestanden met een of meerdere gebruikers te delen.
+
Inspired by [https://gist.github.com/leftclickben/322b7a3042cbe97ed2af this short manual], an SVN to git conversion could boil down to something like:
  
Hoewel de doelgroep van SVN voornamelijk in de software ontwikkeling zit, is het ook mogelijk om subversion te gebruiken voor het beheren van allerhande bestandssoorten.
+
<syntaxhighlight lang="bash">
 +
cd /tmp/
 +
git svn clone --no-metadata -A users.txt https://svn.science.ru.nl/repos/myproject
 +
cd myproject
 +
git remote add gitlab git@gitlab.science.ru.nl:yourscienceloginname/myproject.git
 +
git push --set-upstream gitlab master
 +
</syntaxhighlight>
  
We hebben voor FNWI een eigen subversionserver ingericht. Hierop staat ook administratieve software voor het beheer van repositories en gebruikersaccounts.
+
Git URLs (https and ssh) are shown on the top of the project page in gitlab.
[/nl]
+
The generic repository URL for the [[Subversion|science SVN server]] is:
  
[en]
+
<code>https://svn.science.ru.nl/repos/{repository}</code>
Subversion (SVN) is an open source revision control system that allows one or
 
more users to easily share and maintain collections of files.  
 
  
Although SVN focusses on the software development community it is very well
+
And for CS:
possible to use it as a general purpose centralized system for sharing and
 
maintaining information contained in all kinds of data files.
 
  
We have set up a [https://svn.science.ru.nl/ subversion server for FNWI]
+
<code>https://svn.cs.ru.nl/repos/{repository}</code>
including an administrative interface to manage repositories and repository
 
users.
 
[/en]
 
  
  
==Getting started==
+
You can also see this for public svn repositories on https://svn.science.ru.nl (viewing private repositories requires authentication).
  
[nl]
 
Voor het gebruik van de subversionserver heeft u de volgende zaken nodig:
 
* De URL van de repository;
 
* een SVN gebruikersnaam en wachtwoord;
 
* een SVN client applicatie.
 
Neem [mailto:postmaster@science.ru.nl contact op met C&CZ] om een repository aan te maken en een eigenaar toe te wijzen.
 
[/nl]
 
  
[en]
+
[nl]De oude subversion wiki pagina is [[OldSubversionPage|hier]] gearchiveerd.[/nl]
To be able to use our SVN server you need the following:
+
[en]The old subversion wiki page is archived [[OldSubversionPage|here]][/en]
 
 
* The URL of the repository;
 
* an SVN username and password;
 
* an SVN client installed on your computer.
 
 
 
[mailto:postmaster@science.ru.nl Contact C&CZ] to create a repository and appoint an owner.
 
[/en]
 
 
 
===[De repository][The repository]===
 
 
 
[nl]
 
Voor netwerktoegang tot subversionserver wordt het HTTPS protocol gebruikt.
 
Het web adres voor een repository van onze subversion server is gewoonlijk in de volgende vorm:
 
[/nl]
 
[en]
 
For remote access to our SVN repository the HTTPS protocol is used. The web address (or URL) of our repositories is typically of the form:
 
[/en]
 
{| border="1"
 
|-
 
|<nowiki>https://svn.science.ru.nl/repos/{[nl]naam van de repository[/nl][en]repository name[/en]}</nowiki>
 
|}
 
 
 
===WebSVN===
 
[nl]
 
Op de subversion-server staat ook [http://www.websvn.info/ WebSVN] geinstalleerd. Met WebSVN kunt online door de repository bladeren, commit overzichten, fraai gekleurde broncode bestanden en verschillen tussen bestanden bekijken. WebSVN is te bereiken met de volgende URL:
 
[/nl]
 
 
 
[en]
 
[http://www.websvn.info/ WebSVN] offers a view onto your subversion repositories that's been designed to reflect the Subversion methodology. You can view the log of any file or directory and see a list of all the files changed, added or deleted in any given revision. You can also view compare two versions of a file so as to see exactly what was changed in a particular revision. The URL of our WebSVN installation is:
 
[/en]
 
{| border="1"
 
|-
 
|<nowiki>https://svn.science.ru.nl/wsvn/{[nl]naam van de repository[/nl][en]repository name[/en]}</nowiki>
 
|}
 
 
 
===[Authenticatie en autorisatie][Authentication and Authorization]===
 
[nl]
 
Een subversion gebruiker kan een of meerdere repositories in eigendom hebben. Repository eigenaren kunnen lees- of lees-en-schrijfrechten aan gebruikers toekennen. Indien nodig kunnen repository-eigenaren ook nieuwe svn gebruikersaccounts aanmaken.
 
In de webinterface kunnen zaken zoals de volledige naam, het email adres en het wachtwoord worden aangepast:
 
[/nl]
 
[en]
 
A subversion user can be owner of one or more repositories. Repository owners can grant user read or read-write access to the repository. New svn user accounts can be created if necessary. Account details such as your full name, email address and password can be changed through the web interface:
 
[/en]
 
https://svn.science.ru.nl
 
 
 
 
 
====[Repository eigenaren][Repository owners]====
 
[nl]
 
We raden repository-eigenaren aan om de science login namen aan te houden voor nieuwe subversion accounts. Gelieve accounts voor externe gebruikers met een laat streepje (_) te laten beginnen:
 
[/nl]
 
[en]
 
We urge repository owners to use science account names for users who already have a science account and to use account names starting with an underscore (_) for external users:
 
[/en]
 
{| border="1"
 
|+[nl]svn gebruikersnamen[/nl][en]svn usernames[/en]
 
|-
 
![nl]voor science gebruikers[/nl][en]for science users[/en]
 
![nl]externe gebruikers[/nl][en]external users[/en]
 
|-
 
|{[nl]science gebruikersnaam[/nl][en]science username[/en]}
 
|_{[nl]gebruikersnaam[/nl][en]username[/en]}
 
|}
 
 
 
====[Repository gebruikers][Repository Users]====
 
[nl]
 
Heeft u een science account? Dan heeft de repository eigenaar waarschijnlijk een svn account met dezelfde loginnaam voor u gemaakt. Op dit moment is er nog geen koppeling tussen svn en science accounts. Dat wil zeggen dat u de bijbehorende wachtwoorden onafhankelijk van elkaar kunt instellen. Dit zal in de toekomst waarschijnlijk gelijk getrokken worden.
 
 
 
Bij het eerste gebruik van de repository zal de svn client applicatie vragen naar uw svn gebruikersnaam en wachtwoord. Net als bij email programma's zullen de meeste svn clients de inloggegevens bewaren en hoeven ze niet elke keer ingevoerd te worden.
 
[/nl]
 
 
 
[en]
 
If you have a science login name, the repository owner should have created an account for you with the same account name. At the moment your SVN and science accounts are not connected, i.e. you can change the passwords of both independently.  In the future this will probably change.
 
 
 
When you first connect to  the repository your SVN client will prompt you for your account name and
 
password.  Most SVN clients will store/remember your credentials for subsequent repository access.
 
[/en]
 
 
 
===SVN client software===
 
[nl]
 
Voor de voornaamste besturingsystemen is svn beschikbaar als command line programma. Onder Linux meestal als onderdeel van de distributie, voor andere platforms kan het [http://subversion.apache.org/packages.html apart geinstalleerd worden]. Typ het volgende commando in om na te gaan of subversion up uw systeem geinstalleerd staat:
 
[/nl]
 
[en]
 
For all major platforms, the svn command line client is either available as part of the distribution or can [http://subversion.apache.org/packages.html downloaded seperately].
 
To determine if you have subversion installed on your system, type:
 
[/en]
 
$ svn --version
 
 
 
[nl]
 
Er zijn ook veel verschillende grafische svn clients beschikbaar. Voor beginnende gebruikers kan dit makkelijker in gebruik zijn dan de command line versie.
 
[/nl]
 
[en]
 
There are many graphical clients available, which are perhaps easier or more intuitive to use.
 
[/en]
 
 
 
====[Grafische SVN clients][Graphical SVN clients]====
 
{| border="1"
 
|+[nl]Aanbevolen grafische SVN clients[/nl][en]Suggested Graphical SVN clients[/en]
 
|-
 
!Platform
 
![nl]Applicatie[/nl][en]Application[/en]
 
![nl]bij FNWI[/nl][en]at FNWI[/en]
 
![nl]Beschrijving[/nl][en]Description[/en]
 
|-
 
|Windows
 
|[http://tortoisesvn.net/ TortoiseSVN]
 
|[nl]Optioneel voor [[Windows_beheerde_werkplek| beheerde PC's]][/nl][en]Optional for [[Windows_beheerde_werkplek| Managed PC's]][/en]
 
|[nl]TortoiseSVN integreert naadloos in de Windows shell (Verkenner) en voorziet bestandsiconen van een stempel die de revisiestatus aan geeft. Daarnaast is voegt het items toe aan het context menu voor bestanden (rechter-muis-klik-menu). Licentie: GPL. [/nl][en]TortoiseSVN is a Windows shell extension, which gives feedback on the state of versioned items by adding overlays to the icons in the Windows Explorer. Repository commands can be executed from the enhanced context menu provided by Tortoise; GPL license.[/en]
 
|-
 
|Linux
 
|rowspan=2 |[http://www.rapidsvn.org/ RapidSVN]
 
|[nl]Ubuntu systemen[/nl][en]Ubuntu systems[/en]
 
|rowspan=2 |[nl]Het is al weer een tijdje geleden dat er een nieuwe versie van RapidSVN uit is gekomen. Desondanks een prima grafische client, uitgegeven onder de GPL licentie.[/nl][en]It's a while since the latest release. Still one of the easiest to use open source SVN gui's for Linux and OSX; GPL license.[/en]
 
|-
 
|Mac OSX
 
| -
 
|}
 
 
 
==[SVN gebruiken][Using SVN]==
 
[nl]
 
O'Reilly heeft "Version control with Subversion" uitgebracht onder de Creative Commons Attribution License. Het boek is in verschillende formaten te downloaden van http://svnbook.red-bean.com/.
 
[/nl]
 
[en]
 
O'Reilly has published "Version control with Subversion" under the Creative Commons Attribution License. It's available in different formats from http://svnbook.red-bean.com/.
 
[/en]
 
 
 
==F.A.Q.==
 
 
 
====[Hoe log ik in op de Administratieve Interface?][How do I login to the Administrative Interface?]====
 
[nl]Ga naar https://svn.science.ru.nl/ en klik op 'Authenticate'.
 
[/nl]
 
[en]Visit https://svn.science.ru.nl/; Click 'Authenticate'.[/en]
 
 
 
====[Ik ben m'n wachtwoord vergeten. Hoe kan ik het wijzigen?][I forgot my password, how can I reset it?]====
 
[nl]
 
Als u uw wachtwoord vergeten bent, kunt u het wijzigen met de ''"Forgot your password?"'' optie op de administratieve interface. U wordt verzocht uw login naam en email adres op te geven zoals u in de SVN administratie bekend staat. U ontvangt dan een email met een nieuw wachtwoord. Mocht dit niet lukken, neem dan [[Contact|contact op met C&CZ]].
 
[/nl]
 
[en]
 
If you forgot your password you can reset it with the ''"Forgot your password?"'' option.  You have to specify your login name and the exact e-mail address as registered in the SVN database. You'll recieve an email with a new password. If this fails, please [[Contact|contact C&CZ]].
 
[/en]
 

Revision as of 12:38, 26 April 2016

GitLab is the successor of our Subversion service!


Migrating from Subversion

We have automated the migration from Subversion to GitLab. Contact if you whish to have clone access to your migrated repository.


Manual migration from Subversion

Inspired by this short manual, an SVN to git conversion could boil down to something like:

cd /tmp/
git svn clone --no-metadata -A users.txt https://svn.science.ru.nl/repos/myproject
cd myproject
git remote add gitlab :yourscienceloginname/myproject.git
git push --set-upstream gitlab master

Git URLs (https and ssh) are shown on the top of the project page in gitlab. The generic repository URL for the science SVN server is:

https://svn.science.ru.nl/repos/{repository}

And for CS:

https://svn.cs.ru.nl/repos/{repository}


You can also see this for public svn repositories on https://svn.science.ru.nl (viewing private repositories requires authentication).


The old subversion wiki page is archived here