Gérer les versions avec GitHub Repos
Une partie du processus de mise en production commence par votre gestion de version. Vous comprenez comment gérer les versions dans le dépôt en utilisant GitHub.
Dans les modules suivants, vous voyez des détails sur le déploiement d’un logiciel après empaquetage de votre code, des fichiers binaires, des notes de publication et des tâches associées.
Les versions dans GitHub sont basées sur des étiquettes Git. Une étiquette est comme une photo de l’état actuel de votre dépôt. Si vous devez marquer une phase essentielle de votre code ou que votre code livrable suivant est terminé, vous pouvez créer une étiquette et l’utiliser pendant le processus de génération et de mise en production pour empaqueter et déployer cette version spécifique. Pour plus d’informations, consultez Consultation des versions et des étiquettes de votre dépôt.
Quand vous créez des versions avec des notes de publication, vous pouvez ajouter des @mentions des contributeurs, des liens vers des fichiers binaires, et modifier ou supprimer des versions existantes.
Référence d’image : Versions · Microsoft/azure-pipelines-agent (github.com)
Par ailleurs, vous pouvez :
- Publier une action à partir d’une version spécifique dans GitHub Marketplace.
- Choisir si les objets Git LFS sont inclus dans les fichiers ZIP et les tarballs que GitHub crée pour chaque version.
- Recevoir des notifications quand de nouvelles versions sont publiées dans un dépôt.
Création d’une version
Pour créer une version, utilisez la commande gh release create. Remplacez l’étiquette par le nom d’étiquette souhaité pour la version et suivez les invites interactives.
gh release create tag
Pour créer une préversion avec le titre et les notes spécifiés.
gh release create v1.2.1 --title
Si vous ajoutez une @mention d’un utilisateur GitHub dans les notes, la version publiée sur GitHub.com comprend une section Contributeurs avec une liste d’avatars de tous les utilisateurs mentionnés.
Vous pouvez voir d’autres commandes et arguments dans le Manuel GitHub CLI.
Modification d’une version
Vous ne pouvez pas modifier les versions avec GitHub CLI.
Pour les modifier, utilisez le navigateur web :
- Accédez à la page de dépôt principale sur GitHub.com.
- Cliquez sur Versions à droite de la liste des fichiers.
- Cliquez sur l’icône de modification à droite de la page, à côté de la version à modifier.
- Modifiez les détails de la version, puis cliquez sur Mettre à jour la version.
Suppression d’une version
Pour supprimer une version, utilisez la commande suivante, remplacez l’étiquette par l’étiquette de version à supprimer et utilisez l’indicateur -y pour ignorer la confirmation.
gh release delete tag -y
Pour plus d'informations, consultez les pages suivantes :
- Gestion des versions dans un dépôt - GitHub Docs : si vous voulez effectuer les mêmes étapes à partir d’un navigateur web au lieu de GitHub CLI.
- Publication d’une action dans GitHub Marketplace.
- Gestion des objets Git LFS dans les archives de votre dépôt.
- Consultation de vos abonnements.