Unterstützung für Subversion-Clients

GitHub unterstützt Subversion-Clients über das HTTPS-Protokoll. Zur Übertragung von SVN-Befehlen an GitHub wird eine Subversion-Bridge verwendet.

Auf GitHub unterstützte Subversion-Funktionen

Auschecken

Dein erster Schritt in Verbindung mit Subversion ist der Checkout. Da das Arbeitsverzeichnis (wo Du Dateien bearbeitest) in Git-Klonen getrennt von den Repository-Daten geführt wird, enthält das Arbeitsverzeichnis jeweils nur einen Branch.

Subversion-Checkouts unterscheiden sich hier: In Subversion sind die Repository-Daten in den Arbeitsverzeichnissen enthalten, weswegen es für jeden Branch und jedes Tag, das Du ausgecheckt hast, ein eigenes Arbeitsverzeichnis gibt. Bei Repositorys mit vielen Branches und Tags kann das Auschecken zu einem Bandbreitenproblem werden. In diesem Fall empfiehlt sich zunächst ein teilweiser Checkout.

1. Navigiere in GitHub zur Hauptseite des Repository.

2. Klicke unter dem Repository-Namen auf Clone or download (Klonen oder herunterladen).

   

3. Um ein Repository mittels HTTPS zu klonen, klicke unter „Clone with HTTPS" (mit HTTPS klonen) auf . Um das Repository mittels einem SSH-Schlüssel zu klonen, einschließlich einem Zertifikat, das durch die SSH-Zertifizierungsstelle Deiner Organisation ausgestellt wurde, klicke auf Use SSH (SSH verwenden), dann klicke auf .

   

4. Erstelle einen leeren Checkout des Repositorys:

   $ svn co --depth empty https://github.com/user/repo
   > Checked out revision 1.
   $ cd repo

5. Rufe den trunk-Branch ab. Die Subversion-Bridge ordnet den Trunk dem Git HEAD-Branch (in der Regel master) zu.

   $ svn up trunk
   > A    trunk
   > A    trunk/README.md
   > A    trunk/gizmo.rb
   > Updated to revision 1.

6. Rufe einen leeren Checkout des Verzeichnisses branches ab. In diesem Verzeichnis befinden sich alle Nicht-HEAD-Branches, und hier erstellst Du auch die Funktions-Branches.

   $ svn up --depth empty branches
   Updated to revision 1.

Branches erstellen

Zur Erstellung der Branches kannst Du auch die Subversion-Bridge für GitHub verwenden.

Stelle auf Deinem SVN-Client sicher, dass „master“ der aktuelle Branch ist. Aktualisiere hierzu trunk:

$ svn up trunk
> At revision 1.

Nun kannst Du svn copy zur Erstellung eines neuen Branches verwenden:

$ svn copy trunk branches/more_awesome
> A    branches/more_awesome
$ svn commit -m 'Added more_awesome topic branch'
> Adding    branches/more_awesome

> Committed revision 2.

Im Branch-Dropdownmenü des Repositorys kannst Du überprüfen, ob der neue Branch erstellt wurde:

Dies kannst Du auch über die Befehlszeile überprüfen:

$ git fetch
> From https://github.com/user/repo/
> * [new branch]    more_awesome -> origin/more_awesome

Commits an Subversion

Nachdem Du einige Funktionen hinzugefügt und Bugs behoben hast, möchtest Du diese Änderungen auf GitHub freigeben. Dies funktioniert genauso, wie Du es von Subversion gewohnt bist. Verwende nach der Bearbeitung Deiner Dateien svn commit, um Deine Änderungen festzuschreiben:

$ svn status
> M    gizmo.rb
$ svn commit -m 'Guard against known problems'
> Sending    more_awesome/gizmo.rb
> Transmitting file data .
> Committed revision 3.
$ svn status
> ?    test
$ svn add test
> A    test
> A    test/gizmo_test.rb
$ svn commit -m 'Test coverage for problems'
> Adding    more_awesome/test
> Adding    more_awesome/test/gizmo_test.rb
> Transmitting file data .
> Committed revision 4.

Zwischen Branches wechseln

Um zwischen Branches zu wechseln, wirst Du vermutlich zunächst trunk auschecken wollen:

$ svn co --depth empty https://github.com/user/repo/trunk

Danach kannst Du zu einem anderen Branch wechseln:

$ svn switch https://github.com/user/repo/branches/more_awesome

Git-Commit-SHA für einen Subversion-Commit finden

Der Subversion-Server von GitHub stellt die Git-Commit-SHA für jeden Subversion-Commit bereit.

Um diese Commit-SHA zu finden, solltest Du nach der nicht versionierten Remote-Eigenschaft git-commit fragen.

$ svn propget git-commit --revprop -r HEAD https://github.com/user/repo
05fcc584ed53d7b0c92e116cb7e64d198b13c4e3

Mit dieser Commit-SHA kannst Du beispielsweise nach dem zugehörigen Git-Commit auf GitHub suchen.

Weiterführende Informationen

• „Von GitHub unterstützte Subversion-Eigenschaften“