À 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
-
Dans GitHub.com, accédez à la page principale du dépôt. 1. À droite de la liste des fichiers, cliquez sur Mises en production.
-
Cliquez sur Créer un brouillon d’une nouvelle mise en production.
-
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.
-
Si vous créez une nouvelle étiquette, cliquez sur Créer une nouvelle étiquette.
-
Si vous avez créé une étiquette, utilisez le menu déroulant pour sélectionner la branche qui contient le projet à publier.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
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. »
Pour en savoir plus sur GitHub CLI, consultez « À propos de GitHub CLI ».
-
Pour créer une mise en production, utilisez la sous-commande
gh release create
. Remplaceztag
par l’étiquette souhaitée pour la mise en production.gh release create TAG
-
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
- Dans GitHub.com, accédez à la page principale du dépôt. 1. À droite de la liste des fichiers, cliquez sur Mises en production.
- Sur la droite de la page, en regard de la mise en production à modifier, cliquez sur .
- 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.
Les mises en production ne peuvent pas être modifiées avec GitHub CLI.
Suppression d’une mise en production
- Dans GitHub.com, accédez à la page principale du dépôt. 1. À droite de la liste des fichiers, cliquez sur Mises en production.
- Sur la droite de la page, en regard de la mise en production à supprimer, cliquez sur .
- Cliquez sur Supprimer cette mise en production.
-
Pour supprimer une mise en production, utilisez la sous-commande
gh release delete
. Remplaceztag
par l’étiquette de la mise en production à supprimer. Utilisez l’indicateur-y
pour ignorer la confirmation.gh release delete TAG -y