Git: Unterschied zwischen den Versionen

Aus schokokeks.org Wiki
Zur Navigation springen Zur Suche springen
(vom Client pushen)
(Unsinnigen ssh-link nicht erstellen mit nowiki)
 
(6 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{UnderConstruction}}
{{Box
| title = Warning
| content = Diese Anleitung wurde von einem Kunden bereitgestellt. Wir empfehlen wenn dies möglich ist Gitolite nicht manuell zu installieren, sondern die von uns zentral verwaltete Instanz zu nutzen. Sie können Repositories und Accounts in unserem Konfigurationsinterface unter dem Punkt Benutzeraccounts / Git-Zugänge einrichten.
| image = Construction.png
| background = white
| border_color = red
| border_thickness = 2px
}}


= Git =
== erste Konfiguration ==
Zunächst sollte man sich Git vorstellen (am Besten sowohl auf dem Server, als auch auf dem eigenen Rechner).
git config --global user.name "Ihr Name"
git config --global user.email yourmail@example.com"


== Repository lokal erstellen ==
= Git über SSH =
Dieser Abschnitt soll und kann die Lektüre einer ordentlichen Anleitung nicht ersetzen und dient eher zur Erinnerung.
REPOSITORY="my-repository.git"
mkdir $REPOSITORY
cd $REPOSITORY
git init
git add .
git commit -a


Weitere Dateien/Verzeichnisse/Muster hinzufügen:
== Direkt im Benutzeraccount ==
  git add foo
Die einfachste Methode ohne besondere Konfiguration besteht darin, ein GIT-Repository in Ihrem Benutzeraccount anzulegen und per SSH darauf zuzugreifen. Der Zugriff erfolgt dann z.B. mittels
git add *bar
  <nowiki>git remote add origin ssh://benutzer@zucker.schokokeks.org/~/git/my-repo.git</nowiki>
git commit -a
Diese Methode steuert den Zugriff nicht separat sondern erfordert eine SSH-Anmeldung um das Repository lesen und schreiben zu können. Ein Arbeiten mit mehreren Entwicklern ist damit nicht empfehlenswert.


== Gitosis / Gitolite ==
Auf unseren Servern ist Gitolite bzw. Gitosis intalliert und kann von jedem Benutzer in seinem eigenen Home-Verzeichnis benutzt werden.


= Git-Server einrichten =
Bei diesem Verfahren authentifizieren sich die Entwickler per SSH-Key, somit kann einem Entwickler Zugriff auf ein Repository eingeräumt werden ohne Shell-Zugriff zu erlauben. Es gibt einige Unwegsamkeiten um einen normal betriebenen Benutzeraccount mit gitosis bzw. gitolite zu nutzen. Wir raten davon ab.


Dieser Artikel erläutert, wie man auf schokokeks.org einen Git-Server über HTTP mit [[WebDAV]] einrichten kann.
== zentral administriertes Gitolite ==
Sie können ebenfalls unsere zentrale Installation von Gitolite nutzen. Das Verfahren arbeitet ebenfalls über SSH-Keys.  


== WebDAV-Verzeichnis einrichten ==
Im Webinterface finden Sie unter "Benutzeraccounts" den Unter-Punkt "GIT-Zugänge". Dort können Sie öffentliche SSH-Schlüssel hinterlegen und Repositories anlegen.
Zunächst wird ein Verzeichnis eingerichet, auf das später mit Hilfe von WebDAV zugegriffen werden soll.
 
VIRTUALHOST="webdav.example.com"
mkdir ~/websites/$VIRTUALHOST
mkdir ~/websites/$VIRTUALHOST/htdocs
cd ~/websites/$VIRTUALHOST
setfacl -m default:u:$USER:rwx,default:u:apache:rwx htdocs
touch webdav.users
touch webdav.groups
touch .htaccess
 
Der Wert von VIRTUALHOST ist hierbei die Domain, die später im Config-Interface für WebDAV eingerichtet wird. Die Datei ''.htaccess'' dient zur Rechteverwaltung, damit nicht jeder das Verzeichnis lesen und/oder beschreiben kann.
 
Sie sollte folgenden Text enthalten:
 
AuthUserFile /home/mitja/websites/webdav.example.com/webdav.users
AuthGroupFile /home/mitja/websites/webdav.example.com/webdav.groups
AuthName "WebDAV on webdav.example.com"
AuthType Basic
require group read
 
<Limit POST PUT DELETE MKCOL COPY MOVE PROPPATCH>
          require group write
</Limit>
 
Die Datei ''webdav.users'' enthält die Benutzernamen und Passwörter, wie jede .htpasswd-Datei. Näheres erläutert ''man htpasswd''.
''webdav.groups'' fasst mehrere Benutzernamen zu Gruppen zusammen in dem Stil
 
gruppe1: benutzer1 benutzer2 benutzer3
gruppe2: benutzer3
 
In dem obigen Beispiel hat die Gruppe "write" Schreibzugriff, die Gruppe "read" Lesezugriff. Anonymer Zugriff ist gesperrt.
 
Soll jedes einzelne Repository gesondert verwaltet werden, müssen für jedes Repository eigene Zugriffsrechte wie in dem Beispiel definiert werden.
 
Zum Schluss sollte der gewünschte VHost im [https://config.schokokeks.org/ Konfigurationsinterface] erstellt und auf WebDAV gestellt werden.
 
== Repository erstellen ==
Bisher kann git-http-push noch kein Git-Repository erstellen, deshalb muss es auf dem Server erstellt oder manuell hochgeladen werden.
 
REPOSITORY="my-first-repo.git"
mkdir $REPOSITORY
cd $REPOSITORY
git --bare init
 
 
== Client konfigurieren ==
 
Damit man nicht jedes Mal das WebDAV-Passwort eingeben muss, schreibt man den folgenden Text in die Datei ''~/.netrc''.
machine <servername>
login <username>
password <password>
 
''<servername>'' entspricht dem VirtualHost.
 
Nicht vergessen:
chmod 600 ~/.netrc
 
 
== Erster ''push'' ==
 
Das vorhandene lokale Repository benötigt zunächst noch die URL, zu der gepusht werden soll. Wir befinden uns im lokalen Repository-Verzeichnis.
git-config remote.upload.url http://<username>@<servername>/my-first-repo.git/
 
'upload' ist ein beliebiger Name. Der letzte Slash ("/") ist hierbei '''unbedingt''' erforderlich!
 
Nach dem ganzen Vorgeplänkel ist es nun soweit:
git push upload master
 
Mit diesem Befehl wird der 'master' Branch gepusht. 'upload' ist wieder der im vorigen Befehl konfigurierte und frei gewählte Name.

Aktuelle Version vom 10. Februar 2019, 13:26 Uhr

Warning

Diese Anleitung wurde von einem Kunden bereitgestellt. Wir empfehlen wenn dies möglich ist Gitolite nicht manuell zu installieren, sondern die von uns zentral verwaltete Instanz zu nutzen. Sie können Repositories und Accounts in unserem Konfigurationsinterface unter dem Punkt Benutzeraccounts / Git-Zugänge einrichten.


Git über SSH

Direkt im Benutzeraccount

Die einfachste Methode ohne besondere Konfiguration besteht darin, ein GIT-Repository in Ihrem Benutzeraccount anzulegen und per SSH darauf zuzugreifen. Der Zugriff erfolgt dann z.B. mittels 

git remote add origin ssh://benutzer@zucker.schokokeks.org/~/git/my-repo.git

Diese Methode steuert den Zugriff nicht separat sondern erfordert eine SSH-Anmeldung um das Repository lesen und schreiben zu können. Ein Arbeiten mit mehreren Entwicklern ist damit nicht empfehlenswert.

Gitosis / Gitolite

Auf unseren Servern ist Gitolite bzw. Gitosis intalliert und kann von jedem Benutzer in seinem eigenen Home-Verzeichnis benutzt werden.

Bei diesem Verfahren authentifizieren sich die Entwickler per SSH-Key, somit kann einem Entwickler Zugriff auf ein Repository eingeräumt werden ohne Shell-Zugriff zu erlauben. Es gibt einige Unwegsamkeiten um einen normal betriebenen Benutzeraccount mit gitosis bzw. gitolite zu nutzen. Wir raten davon ab.

zentral administriertes Gitolite

Sie können ebenfalls unsere zentrale Installation von Gitolite nutzen. Das Verfahren arbeitet ebenfalls über SSH-Keys.

Im Webinterface finden Sie unter "Benutzeraccounts" den Unter-Punkt "GIT-Zugänge". Dort können Sie öffentliche SSH-Schlüssel hinterlegen und Repositories anlegen.

Abgerufen von „https://wiki.schokokeks.org/wiki/index.php?title=Git&oldid=9250“