Skip to main content

Publication d'un package

Vous pouvez publier un package dans GitHub Packages pour que d'autres puissent le télécharger et le réutiliser.

Qui peut utiliser cette fonctionnalité ?

Anyone with write permissions for a repository can publish a package to that repository.

GitHub Packages est disponible avec GitHub Free, GitHub Pro, GitHub Free pour les organisations, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server 3.0 ou ultérieur.
GitHub Packages n’est pas disponible pour les référentiels privés appartenant à des comptes qui utilisent des plans par référentiel hérités. En outre, les comptes utilisant des plans hérités par référentiel ne peuvent pas accéder aux registres qui prennent en charge les autorisations granulaires, car ces comptes sont facturés par référentiel. Enterprise Managed Users n’ont pas d’allocation de stockage individuelle pour publier des packages dans l’espace de noms de leur compte, mais peuvent publier dans l’espace de noms d’une organisation. Pour plus d’informations sur Enterprise Managed Users, consultez « À propos d’Enterprise Managed Users ». Pour obtenir la liste des registres qui prennent en charge les autorisations granulaires, consultez « À propos des autorisations pour les packages GitHub. » Pour plus d’informations, consultez « Plans de GitHub ».

À propos des packages publiés

Vous pouvez aider les personnes à comprendre et à utiliser votre package en fournissant une description et d'autres détails tels que les instructions d'installation et d'utilisation dans la page du package. GitHub Enterprise Cloud fournit des métadonnées pour chaque version, telles que la date de publication, l'activité de téléchargement et les versions récentes. Pour obtenir un exemple de page de package, consultez @Codertocat/hello-world-npm.

Vous pouvez publier des packages dans un référentiel public (packages publics) à partager avec tout GitHub, ou dans un référentiel privé (packages privés) à partager avec des collaborateurs ou une organisation. Un dépôt peut être connecté à plusieurs packages. Pour éviter toute confusion, assurez-vous que le fichier LISEZMOI et la description fournissent clairement des informations sur chaque package.

Si une nouvelle version d'un package corrige une faille 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 ».

Publication d'un package

GitHub Packages prend uniquement en charge l’authentification à l’aide d’un personal access token (classic). Pour plus d’informations, consultez « Gestion de vos jetons d'accès personnels ».

Vous pouvez publier un package sur GitHub Packages à l'aide de tout client de package pris en charge en suivant les mêmes instructions générales.

  1. Créez ou utilisez un personal access token (classic) existant avec les étendues appropriées pour la tâche que vous souhaitez accomplir. Pour plus d'informations, consultez « À propos des autorisations pour les packages GitHub ».
  2. Authentifiez-vous auprès de GitHub Packages avec votre personal access token (classic) et les instructions de votre client de package.
  3. Publiez le package à l'aide des instructions de votre client de package.

Pour obtenir des instructions spécifiques à votre client de package, consultez « Utilisation d’un registre GitHub Packages ».

Après avoir publié un package, vous pouvez l'afficher sur GitHub. Pour plus d'informations, consultez « Affichage de packages ».