git-notifier - En ligne dans le Cloud

PROGRAMME:

Nom

git-notifier - script à utiliser avec git comme hook post-réception

SYNOPSIS

git-notifier [Options]

DESCRIPTION

git-notifier est un script à utiliser avec Git comme hook post-réception. Une fois installé, il
envoie par courrier électronique un résumé de toutes les modifications chaque fois qu'un utilisateur envoie une mise à jour au référentiel.
Différent des autres scripts similaires, git-notifier envoie exactement un e-mail par modification,
chacun d'entre eux comprenant un diff complet de toutes les modifications ainsi que l'ensemble des branches
à partir duquel la nouvelle révision peut être atteinte. Les scripts garantissent que chaque modification est
envoyé une seule fois par courrier en conservant un fichier d'état des révisions déjà signalées.

Par ailleurs, git-notifier envoie également des mises à jour par courrier électronique lorsque des branches ou des balises annotées sont créées
ou supprimé ; et il envoie en outre un résumé de révision si une tête se déplace pour inclure désormais
commits déjà signalés précédemment (par exemple, sur des avances rapides).

Si un message de validation contient [nodiff], le courrier généré n'inclura pas de diff. Si un
le message de validation contient [nomail], aucun courrier ne sera envoyé pour ce changement.

git-notifier prend en charge les options ci-dessous. Au lieu de les saisir en ligne de commande,
tous peuvent également être définis via jet config crochets.. Par exemple, pour définir un destinataire
adresse, faire jet config hooks.liste de diffusion [email protected].

Pour une documentation complète, consultez la page d'accueil à l'adresse : http://www.icir.org/robin/git-notifier/.

INSTALLATION

L'installation de base est simple : il suffit d'exécuter le script depuis crochets/post-réception, un péché:

#!/ Bin / sh

/chemin/complet/vers/git-notifier

Par défaut, le script enverra ses mails à l'utilisateur exécutant le git-notifier (c.-à-d. le
(celui qui effectue la mise à jour). Comme ce n'est généralement pas le destinataire souhaité, une adresse e-mail alternative
l'adresse peut être spécifiée via la ligne de commande ou les options git, voir l'option mailinglist
ci-dessous.

OPTIONS

--tous les changements
Liste pour lesquels toutes les modifications qui leur sont apportées doivent être envoyées par courrier
différences directes avec leur état précédent, indépendamment du fait que le correspondant
La validation a déjà été signalée. Pour les validations de fusion, les courriels incluent
la différence complète (c'est-à-dire celle de git) diff -m). Cela pourrait par exemple avoir du sens pour le master
si l’on veut suivre de près toute modification appliquée.

est une liste de noms de têtes séparés par des virgules à traiter de cette manière.

--branches
Liste à inclure/exclure dans les rapports. Par défaut, toutes les branches sont
inclus. Si cette option est spécifiée, seules les branches répertoriées sont incluses.
Alternativement, on peut préfixer une branche avec - pour l'exclure : alors tout sauf le
les exclus sont signalés.

est une liste de noms de têtes séparés par des virgules à traiter de cette manière.

--config=PATH
PATH vers un fichier de configuration alternatif.

--déboguer
Exécutez le script en mode débogage, ce qui signifie qu'il (1) se connectera de manière plus détaillée et
à stderr, et (2) exécuter git-notifier grâce à la fonction --déboguer et --Pas de mise à jour options.

--diff [rév1...] rev2
Envoie par courrier les différences entre toutes les révisions sur le chemin du premier parent depuis rev1 à rev2.
Cette option produit une sortie similaire à celle d'une tête se déplaçant vers l'avant, ce qui est
répertorié avec --tous les changements. Si rev1 est ignoré, rev2~1 est assumé.

Cette option est principalement destinée au débogage et à la (re)génération rétrospective de ce
outut, et ne modifie en aucune façon l'état actuel du notificateur. Le principal
différence avec --Manuel c'est qu'il ne considère que la révision du premier parent
chemin et envoie par courrier électronique les différences réelles entre ceux-ci.

--préfixe de courrier électronique
Spécifie un préfixe pour la ligne d'objet des e-mails. Si le préfixe contient un %r, Que
sera remplacé par le nom du dépôt. La valeur par défaut est [git/%r]. Notez que le nom
cette option est compatible avec certains autres scripts de notification git.

--nom d'hôte
Définit le nom d'hôte à utiliser lors de la création du chemin du référentiel affiché dans le
Courriels de notification. La valeur par défaut est le nom canonique du système sur lequel le script est installé.
en cours d'exécution.

--ignoreremotes
Si donné, git-notifier ne signalera aucun commit déjà connu de quiconque
référentiel distant configuré.

--gitbasedir=ANNUAIRE
Spécifie une base ANNUAIRE pour le dépôt Git. Si ce paramètre n'est pas spécifié, le répertoire actuel
Le répertoire est la valeur par défaut.

-h, --Aidez-moi
afficher le message d'aide et quitter

--relier
Spécifie un qui sera inclus dans les e-mails de notification pour localiser un
modifications en ligne. Le peut contenir un %s espace réservé qui sera remplacé par
le numéro de révision git correspondant. Le peut également contenir un %r espace réservé
qui sera remplacé par le nom du référentiel.

--Journal
Écrire les informations de journalisation dans le champ donné . La valeur par défaut est git-notifier.log à l'intérieur
le référentiel.

--mailcmd
Spécifie la commande à utiliser pour envoyer du courrier. La valeur par défaut est /usr/sbin/sendmail.

--liste de diffusion
Spécifie le destinataire de tous les e-mails générés. Par défaut, l'envoi est effectué au système.
compte qui exécute le script.

--serveur de messagerie
Serveur SMTP à utiliser pour les e-mails sortants. La valeur par défaut est Aucun, auquel cas le courrier est reçu
envoyé par le biais du service local sendmail (ou quoi que ce soit --mailcmd définit alternativement).

--mailsubjectlen
Limite les sujets des mails générés à caractères. Système d'exploitation par défaut sans limite.

--Manuel [rév1..] rev2
Envoie des notifications par courrier électronique pour toutes les révisions en cours de route rev1 à rev2. Si rev1 is
sauté, rev2~1 est assumé.

Cette option est principalement destinée au débogage et à la (re)génération rétrospective de ce
sortie et ne modifie en aucune façon l'état actuel du notificateur.

--âge maximal
Limite l'âge des commits à signaler. Aucun commit plus ancien que ce nombre de jours ne sera
Déclencher une notification de validation. La valeur par défaut est de 30 jours ; zéro désactive la vérification de l'âge.

--maxdiffsize
Limite la de mails by donnant a maximales nombre of kilooctets qui a diff Au cours de cette réunion, Matthew a obtenu de précieux conseils et Linda lui a demandé de la tenir au courant de ses progrès.
avoir. If le diff pour un changement supérieur à cette valeur, un mail de notification est envoyé
envoient toujours mais le diff est exclu (et remplacé par une note le précisant).
La valeur par défaut est 50 K.

--mergediffs
Liste pour lesquels les fusions doivent inclure l'intégralité diff, y compris tous
modifications qui font déjà partie des commits de branche.

est une liste de noms de têtes séparés par des commandes à traiter de cette manière.

--Pas de mise à jour
Ne met pas à jour le fichier d'état interne, ce qui signifie que toutes les mises à jour seront signalées
à nouveau la prochaine fois que le script est exécuté.

--répondre à
Ajoute une réponse à : en-tête des courriers sortants.

--repouri=URI
plein URI pour le référentiel

--expéditeur
Définit l'expéditeur pour tous les e-mails générés. Par défaut, c'est l'utilisateur qui effectue la
mettre à jour (si gitolite est utilisé, c'est le compte gitolite qui fait le push, pas le
compte système en cours d'exécution git-notifier.)

--mise à jour uniquement
N'envoie aucune notification par e-mail, mais met à jour l'index. En d'autres termes,
En d'autres termes, tous les changements récents seront marqués comme « vus », sans les signaler.

--utilisateurs
Ceci est uniquement pour les installations utilisant gitolite , pour lequel l'expéditeur par défaut
L'adresse pour tous les courriers électroniques serait normalement le nom du compte utilisateur gitolite du
personne effectuant la poussée. Cette option permet également de spécifier un fichier
mappe ces noms de compte à des adresses alternatives, qui seront ensuite utilisées comme
expéditeur de courriers électroniques.

Notez que même si --utilisateurs n'est pas donné, git-notifier je chercherai toujours un tel
fichier dans ../conf/sender.cfg, par rapport au répertoire du référentiel de niveau supérieur. Dans
en d'autres termes, vous pouvez vérifier un fichier expéditeur.cfg contenant les mappages dans
gitolites config / répertoire et cela devrait simplement fonctionner.

--version
Affiche le numéro de version du programme et quitte

Utiliser git-notifier en ligne avec les services onworks.net