Gestion de la stratégie de validation de commits pour votre dépôt

Vous pouvez demander aux utilisateurs de valider automatiquement les commits qu’ils effectuent dans votre dépôt avec l’interface web de GitHub.

Qui peut utiliser cette fonctionnalité ?

Organization owners and repository administrators can require all commits to a repository to be signed off by the commit author.

Dans cet article

À propos des validations de commits

Les validations de commits permettent aux utilisateurs d’affirmer la conformité de commits aux règles et licences régissant un dépôt. Vous pouvez activer les validations de commits obligatoires sur des dépôts individuels pour les utilisateurs qui effectuent des commits avec l’interface web de GitHub.com. La validation de commits fait alors partie intégrante du processus de commit. Une fois les validations de commits obligatoires activées pour un dépôt, chaque commit effectué dans ce dépôt avec l’interface web de GitHub.com est automatiquement validé par l’auteur du commit.

Les propriétaires d’organisation peuvent également activer les validations de commits obligatoires au niveau de l’organisation. Pour plus d’informations, consultez « Gestion de la stratégie de validation de commits pour votre organisation ».

Les validations de commits obligatoires ne s’appliquent qu’aux commits effectués avec l’interface web. Pour les commits effectués avec l’interface de ligne de commande Git, l’auteur du commit doit valider le commit avec l’option --signoff. Pour plus d’informations, consultez la documentation Git.

Pour déterminer si les validations de commits obligatoires sont activées sur un dépôt auquel vous contribuez, examinez l’en-tête du formulaire de commit au bas du fichier que vous modifiez. Si la validation de commits obligatoire est activée, l’en-tête indique « Valider et commiter les changements ».

Capture d’écran du formulaire de validation dans un dépôt. Le titre du formulaire est « Signer et valider les modifications ».

Avant de valider un commit, vous devez vérifier qu’il est conforme aux règles et licences régissant le dépôt où vous effectuez vos commits. Le dépôt peut utiliser un accord de validation, tel que le certificat d’origine du développeur de la fondation Linux. Pour plus d’informations, consultez le certificat d’origine du développeur.

La validation d’un commit et la signature d’un commit sont deux choses différentes. Pour plus d’informations sur la signature d’un commit, consultez « À propos de la vérification des signatures de commit ».

Activation ou désactivation des validations de commits obligatoires pour votre dépôt

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre dépôt, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Sélectionnez Exiger que les contributeurs valident les commits basés sur le web.