Cette version de GitHub Enterprise Server n'est plus disponible depuis le 2024-03-26. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Gestion des mises en production dans un référentiel

Vous pouvez créer des mises en production pour grouper et remettre des itérations d’un projet aux utilisateurs.

Qui peut utiliser cette fonctionnalité ?

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

Tool navigation

Dans cet article

À propos de la gestion des mises en production

Vous pouvez créer de nouvelles mises en production avec des notes de publication, @mentions des contributeurs et des liens vers des fichiers binaires, ainsi que modifier ou supprimer des mises en production existantes. Vous pouvez également créer, modifier et supprimer des mises en production avec l’API Mises en production. Pour plus d’informations, consultez « Points de terminaison d’API REST pour les versions » dans la documentation de l’API REST.

Création d’une mise en production

  1. Dans votre instance GitHub Enterprise Server, accédez à la page principale du dépôt.

  2. À droite de la liste des fichiers, cliquez sur Mises en production.

    Capture d’écran de la page principale d’un dépôt. Un lien, intitulé « Versions », est mis en évidence avec un encadré orange.

  3. En haut de la page, cliquez sur Brouillon d’une nouvelle version.

  4. Pour choisir une étiquette pour la version, sélectionnez le menu déroulant Choisir une étiquette.

    • Pour utiliser une étiquette existante, cliquez sur l’étiquette.
    • Pour créer une étiquette, tapez un numéro de version pour votre version, puis cliquez sur Créer une étiquette.

  5. Si vous avez créé une étiquette, utilisez le menu déroulant Cible, puis cliquez sur la branche qui contient le projet à publier.

  6. Si vous le souhaitez, au-dessus du champ du texte de description, sélectionnez le menu déroulant Étiquette précédente, puis cliquez sur l’étiquette qui identifie la version précédente.

    Capture d’écran du formulaire « Nouvelle version ». Un menu déroulant, intitulé « Previous tag: auto », est mis en évidence avec un encadré orange.

  7. Dans le champ « Titre de la mise en production », tapez un titre pour votre version.

  8. Dans le champ « Décrire cette mise en production », tapez une description pour votre mise en production. Si vous mentionnez une personne avec @mention dans la description, la mise en production publiée inclut une section Contributeurs avec une liste d’avatars de l’ensemble des utilisateurs mentionnés. Vous pouvez également générer automatiquement vos notes de publication en cliquant sur Générer des notes de publication.

  9. Vous pouvez aussi ajouter des fichiers binaires comme des programmes compilés dans votre mise en production, pour ce faire, faites un glisser-déposer ou sélectionnez les fichiers manuellement dans la boîte Fichiers binaires.

  10. Éventuellement, pour avertir les utilisateurs que la mise en production n’est pas prête pour la production et peut être instable, sélectionnez Il s’agit d’une préversion.

  11. Si vous le souhaitez, sélectionnez Définir comme version la plus récente. Si vous ne sélectionnez pas cette option, l’étiquette de version la plus récente est automatiquement attribuée en fonction du versioning sémantique.

  12. Si vous le souhaitez, si GitHub Discussions est activé pour le dépôt, créez une discussion pour la version.

    • Sélectionnez Créer une discussion pour cette version.
    • Sélectionnez le menu déroulant Catégorie, puis cliquez sur une catégorie pour la discussion sur la version.

  13. Si vous êtes prêt à rendre publique votre mise en production, cliquez sur Publier la mise en production. Pour travailler sur la mise en production par la suite, cliquez sur Enregistrer le brouillon.

Pour plus d’informations sur GitHub CLI, consultez « À propos de GitHub CLI ».

  1. Pour créer une mise en production, utilisez la sous-commande gh release create. Remplacez tag par l’étiquette souhaitée pour la mise en production.

    gh release create TAG

  2. Suivez les invites interactives. Vous pouvez également spécifier des arguments pour ignorer ces invites. Pour plus d’informations sur les arguments possibles, consultez le manuel GitHub CLI. Par exemple, cette commande crée une préversion avec le titre et les notes spécifiés.

    gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a beta release" --prerelease

Si vous utilisez @mention pour mentionner des utilisateurs GitHub Enterprise Server dans les remarques, la mise en production publiée sur GitHub.com inclut une section Contributeurs avec la liste des avatars de l’ensemble des utilisateurs mentionnés.

Modification d’une mise en production

  1. Dans votre instance GitHub Enterprise Server, accédez à la page principale du dépôt.

  2. À droite de la liste des fichiers, cliquez sur Mises en production.

    Capture d’écran de la page principale d’un dépôt. Un lien, intitulé « Versions », est mis en évidence avec un encadré orange.

  3. En regard de la version que vous souhaitez modifier, cliquez sur .

    Capture d’écran d’une mise en production dans la liste des mises en production. Une icône représentant un crayon est mise en évidence avec un encadré orange.

  4. Modifiez les détails de la mise en production dans le formulaire, puis cliquez sur Mettre à jour la mise en production. Si vous ajoutez ou supprimez des utilisateurs @mentions GitHub dans la description, ces utilisateurs sont ajoutés ou supprimés dans la liste des avatars de la section Contributeurs de la mise en production.

  1. Pour modifier une mise en production, utilisez la sous-commande gh release edit. Remplacez TAG par la balise qui représente la version que vous souhaitez modifier. Par exemple, pour modifier le titre d’une version, utilisez le code suivant, en remplaçant NEW-TITLE par le titre mis à jour :

    gh release edit TAG -t "NEW-TITLE"

    Pour plus d’informations sur les arguments possibles, consultez le manuel GitHub CLI.

Suppression d’une mise en production

  1. Dans votre instance GitHub Enterprise Server, accédez à la page principale du dépôt.

  2. À droite de la liste des fichiers, cliquez sur Mises en production.

    Capture d’écran de la page principale d’un dépôt. Un lien, intitulé « Versions », est mis en évidence avec un encadré orange.

  3. Sur la droite de la page, à côté de la mise en production à supprimer, cliquez sur .

    Capture d’écran d’une mise en production dans la liste des mises en production. Une icône représentant une poubelle est mise en évidence avec un encadré orange.

  4. Cliquez sur Supprimer cette mise en production.

  1. Pour supprimer une mise en production, utilisez la sous-commande gh release delete. Remplacez tag par l’étiquette de la mise en production à supprimer. Utilisez l’indicateur -ypour ignorer la confirmation.

    gh release delete TAG -y