Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

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

Dans cet article

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.

À 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 « Mises en production » dans la documentation de l’API REST.

Vous pouvez également publier une action à partir d’une mise en production spécifique dans GitHub Marketplace. Pour plus d’informations, consultez « Publication d’une action dans GitHub Marketplace ».

Vous pouvez choisir si les objets Stockage Fichiers volumineux Git (Git LFS) sont inclus ou pas dans les fichiers ZIP et les tarballs créés par GitHub Enterprise Cloud pour chaque mise en production. Pour plus d’informations, consultez « Gestion des objets Git LFS dans les archives de votre dépôt ».

Création d’une mise en production

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. À droite de la liste des fichiers, cliquez sur Mises en production. Section Mises en production dans la barre latérale droite

  2. Cliquez sur Créer un brouillon d’une nouvelle mise en production.

    Bouton Brouillon de mises en production

  3. Cliquez sur Choisir une étiquette, tapez un numéro de version pour votre mise en production, puis appuyez sur Entrée. Vous pouvez aussi sélectionner une étiquette existante.

    Entrer une étiquette

  4. Si vous créez une nouvelle étiquette, cliquez sur Créer une nouvelle étiquette.

    Capture d’écran de la confirmation de la création d’une étiquette

  5. Si vous avez créé une étiquette, utilisez le menu déroulant pour sélectionner la branche qui contient le projet à publier.

    Capture d’écran de la liste déroulante permettant de choisir une branche

  6. Si vous le souhaitez, en haut à droite de la zone 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 montrant comment sélectionner une étiquette pour identifier la version précédente

  7. Tapez un titre et une description pour votre mise en production. Si vous @mention quelqu’un dans la description, la mise en production publiée inclut une section Contributeurs avec une liste d’avatars de tous les utilisateurs mentionnés. Vous pouvez également générer automatiquement vos notes de publication en cliquant sur Générer des notes de publication.

    Capture d’écran de la description des mises en production

  8. 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.

    GIF animé de La fourniture d’un DMG avec la mise en production

  9. 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.

    Capture d’écran de la case à cocher pour marquer une mise en production en tant que préversion

  10. Si vous le souhaitez, vous pouvez sélectionner 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.

    Capture d’écran de la case à cocher pour marquer une mise en production en tant que version la plus récente

  11. Si vous le souhaitez, si GitHub Discussions est activé dans le référentiel, sélectionnez Créer une discussion pour cette mise en production, puis sélectionnez le menu déroulant Catégorie et cliquez sur une catégorie pour la discussion sur la mise en production.

    Capture d’écran de la case à cocher pour créer une discussion de mise en production et du menu déroulant pour choisir une catégorie

  12. 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. Boutons Publier la mise en production et Enregistrer un brouillon de la mise en production Vous pouvez ensuite afficher vos mises en production publiées ou les brouillons dans le flux de mises en production de votre dépôt. Pour plus d’informations, consultez « Capture d’écran des mises en production et étiquettes de votre dépôt. »

    Mise en production publiée avec des contributeurs @mentioned

Pour en savoir plus 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 @mention des utilisateurs GitHub Enterprise Cloud dans les remarques, la mise en production publiée sur GitHub.com inclut une section Contributeurs avec la liste des avatars de tous les utilisateurs mentionnés.

Modification d’une mise en production

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. À droite de la liste des fichiers, cliquez sur Mises en production. Section Mises en production dans la barre latérale droite
  2. Sur la droite de la page, en regard de la mise en production à modifier, cliquez sur . Modifier une mise en production
  3. 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 l’un des utilisateurs @mentions GitHub dans la description, ces utilisateurs seront ajoutés ou supprimés de la liste des avatars dans la section Contributeurs de la mise en production. Mettre à jour une mise en production

Les mises en production ne peuvent pas être modifiées avec GitHub CLI.

Suppression d’une mise en production

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. À droite de la liste des fichiers, cliquez sur Mises en production. Section Mises en production dans la barre latérale droite
  2. Sur la droite de la page, en regard de la mise en production à supprimer, cliquez sur . Supprimer une mise en production
  3. Cliquez sur Supprimer cette mise en production. Confirmer la suppression de la 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