À propos des versions
Les versions sont des itérations logicielles déployables que vous pouvez empaqueter et rendre disponibles au téléchargement pour un public plus large.
Les versions sont basées sur des étiquettes Git, qui marquent un point spécifique dans l’historique de votre dépôt. Une date d’étiquette peut être différente d’une date de publication, car elles peuvent être créées à des moments différents. Pour plus d’informations sur la consultation de vos étiquettes existantes, consultez « Affichage des versions et étiquettes de votre dépôt ».
Vous pouvez recevoir des notifications quand de nouvelles versions sont publiées dans un dépôt, mais pas forcément pour les autres mises à jour du dépôt. Pour plus d’informations, consultez « Affichage de vos abonnements ».
Toute personne avec un accès en lecture sur un dépôt peut voir et comparer les versions, mais seules les personnes avec des autorisations d’écriture sur un dépôt peuvent gérer les versions. Pour plus d’informations, consultez « Gestion des mises en production dans un référentiel ».
Vous pouvez créer des notes de publication manuellement quand vous gérez une version. Vous pouvez également générer automatiquement des notes de publication à partir d’un modèle par défaut ou personnaliser votre propre modèle de notes de publication. Pour plus d’informations, consultez « Notes de publication générées automatiquement ».
Lorsque vous consultez les détails d’une version, la date de création de chaque ressource de version est affichée à côté de la ressource en question.
GitHub inclut automatiquement des liens pour télécharger un fichier zip et un tarball contenant le contenu du dépôt au moment de la création de la balise.
Les personnes qui ont des autorisations d’administrateur sur un dépôt peuvent choisir si les objets Stockage Fichiers volumineux Git (Git LFS) sont ajoutés dans les fichiers ZIP et les tarballs que GitHub crée pour chaque version. Pour plus d’informations, consultez « Gestion des objets Git LFS dans les archives de votre dépôt ».
Si une version corrige une vulnérabilité de sécurité, vous devez publier un avis de sécurité dans votre dépôt. GitHub passe en revue chaque avis de sécurité publié et peut l’utiliser pour envoyer des Dependabot alerts aux dépôts affectés. Pour plus d’informations, consultez « À propos des avis de sécurité des référentiels ».
Vous pouvez regarder l’onglet Dépendants du graphe des dépendances pour voir les dépôts et packages qui dépendent du code de votre dépôt et qui peuvent donc être affectés par une nouvelle version. Pour plus d’informations, consultez « À propos du graphe de dépendances ».
Vous pouvez également utiliser l’API Releases pour collecter des informations, comme le nombre de fois que les personnes téléchargent une ressource de version. Pour plus d’informations, consultez « Points de terminaison d’API REST pour les versions et les ressources de mise en production ».
Quotas de bande passante et de stockage
Chaque fichier inclus dans une version doit être inférieur à 2 Gio. Il n’y a pas de limite de la taille totale d’une version, ni d’utilisation de la bande passante.