Git
Git-Client-Side-Hooks
Suche…
Einführung
Wie viele andere Versionskontrollsysteme bietet Git die Möglichkeit, bei bestimmten wichtigen Aktionen benutzerdefinierte Skripts auszulösen. Es gibt zwei Gruppen dieser Hooks: clientseitig und serverseitig. Clientseitige Hooks werden durch Vorgänge wie das Festschreiben und Zusammenführen ausgelöst, während serverseitige Hooks bei Netzwerkoperationen wie dem Empfang von Push-Commits ausgeführt werden. Sie können diese Haken aus allen möglichen Gründen verwenden.
Einen Haken installieren
Die Hooks werden alle im hooks
Unterverzeichnis des Git-Verzeichnisses gespeichert. In den meisten Projekten ist das .git/hooks
.
Um ein Hook-Skript zu aktivieren, legen Sie eine Datei in das hooks
Unterverzeichnis Ihres .git
Verzeichnisses, das entsprechend benannt ist (ohne Erweiterung) und ausführbar ist.
Git Pre-Push-Haken
Pre-Push- Skript wird von git push
aufgerufen git push
nachdem der Remote-Status geprüft wurde, bevor etwas gedrückt wurde. Wenn dieses Skript mit einem Status ungleich Null beendet wird, wird nichts weitergeleitet.
Dieser Hook wird mit den folgenden Parametern aufgerufen:
$1 -- Name of the remote to which the push is being done (Ex: origin)
$2 -- URL to which the push is being done (Ex: https://<host>:<port>/<username>/<project_name>.git)
Informationen zu den übertragenen Commits werden als Zeilen an die Standardeingabe in der folgenden Form geliefert:
<local_ref> <local_sha1> <remote_ref> <remote_sha1>
Beispielwerte:
local_ref = refs/heads/master
local_sha1 = 68a07ee4f6af8271dc40caae6cc23f283122ed11
remote_ref = refs/heads/master
remote_sha1 = efd4d512f34b11e3cf5c12433bbedd4b1532716f
Das folgende Beispiel für das Pre-Push-Skript wurde dem Standard-Pre-Push-Beispiel entnommen, das automatisch erstellt wurde, wenn ein neues Repository mit git init
initialisiert wird
# This sample shows how to prevent push of commits where the log message starts
# with "WIP" (work in progress).
remote="$1"
url="$2"
z40=0000000000000000000000000000000000000000
while read local_ref local_sha remote_ref remote_sha
do
if [ "$local_sha" = $z40 ]
then
# Handle delete
:
else
if [ "$remote_sha" = $z40 ]
then
# New branch, examine all commits
range="$local_sha"
else
# Update to existing branch, examine new commits
range="$remote_sha..$local_sha"
fi
# Check for WIP commit
commit=`git rev-list -n 1 --grep '^WIP' "$range"`
if [ -n "$commit" ]
then
echo >&2 "Found WIP commit in $local_ref, not pushing"
exit 1
fi
fi
done
exit 0