Skip to main content

Bien démarrer avec GitHub Packages pour votre entreprise

Vous pouvez commencer à utiliser GitHub Packages sur votre instance GitHub Enterprise Server en activant la fonctionnalité, en configurant le stockage tiers, en configurant les écosystèmes que vous souhaitez prendre en charge et en mettant à jour votre certificat TLS.

Qui peut utiliser cette fonctionnalité ?

Site administrators can enable and configure GitHub Packages.

Remarque : pour le moment, GitHub Packages sur GitHub Enterprise Server ne prend pas en charge le clustering.

Étape 1 : Vérifier si GitHub Packages est disponible pour votre entreprise

GitHub Packages est disponible dans GitHub Enterprise Server 3.0 et versions supérieures. Si vous utilisez une version antérieure de GitHub Enterprise Server, vous devez effectuer une mise à niveau pour utiliser GitHub Packages. Pour plus d’informations sur la mise à niveau de votre instance de GitHub Enterprise Server, consultez « À propos des mises à niveau vers de nouvelles mises en production ».

Étape 2 : Passer en revue la configuration matérielle requise

Si vous envisagez d’activer Container registry pour les utilisateurs de votre instance, au moins 10 % de ressources processeur en plus sont requises.

Nous vous recommandons de passer en revue les niveaux d’activité des utilisateurs et des automatisations sur l’instance pour vous assurer que vous avez provisionné le processeur adéquat pour vos utilisateurs. Pour plus d’informations, consultez « Surveillance de votre instance ».

Pour plus d’informations sur la configuration matérielle minimale requise pour votre instance GitHub Enterprise Server, prenez connaissance des considérations matérielles concernant la plateforme de votre instance.

Pour plus d’informations sur l’ajustement des ressources pour une instance existante, consultez « Augmentation des ressources processeur ou mémoire ».

Étape 3 : Activer GitHub Packages et configurer le stockage externe

GitHub Packages sur GitHub Enterprise Server utilise un stockage blob externe pour stocker vos packages.

Après avoir activé GitHub Packages pour votre instance GitHub Enterprise Server, vous devez préparer votre compartiment de stockage tiers. La quantité de stockage nécessaire dépend de votre utilisation de GitHub Packages et les instructions d’installation peuvent varier selon le fournisseur de stockage.

Fournisseurs de stockage externes pris en charge

  • Amazon Web Services (AWS) S3
  • Stockage Blob Azure
  • MinIO

Pour activer GitHub Packages et configurer le stockage tiers, consultez :

Étape 4 : Spécifier les écosystèmes de packages à prendre en charge sur votre instance

Choisissez les écosystèmes de packages que vous souhaitez activer, désactiver ou définir en lecture seule sur votre instance GitHub Enterprise Server. Les options disponibles sont Container registry, Docker, RubyGems, npm, Apache Maven, Gradle et NuGet. Pour plus d’informations, consultez « Configuration de la prise en charge de l’écosystème de packages pour votre entreprise ».

Étape 5 : Veiller à avoir un certificat TLS pour l’URL hôte de votre package si nécessaire

Si l’isolation de sous-domaine est activée pour votre instance GitHub Enterprise Server, vous devez créer et charger un certificat TLS qui autorise l’URL hôte du package pour chaque écosystème que vous souhaitez utiliser, par exemple containers.HOSTNAME. Vérifiez que chaque URL hôte de package inclut https://.

Vous pouvez créer le certificat manuellement ou utiliser Let’s Encrypt. Si vous utilisez déjà Let’s Encrypt, vous devez demander un nouveau certificat TLS après l’activation de GitHub Packages. Pour plus d’informations sur les URL hôte de package, consultez « Activation de l’isolation de sous-domaine ». Pour plus d’informations sur le chargement de certificats TLS dans GitHub Enterprise Server, consultez « Configuration de TLS ».

Étape 6 : Rechercher et renommer des noms réservés

Si vous souhaitez utiliser l’écosystème Docker avec l’isolation de sous-domaine désactivée, vous devez commencer par renommer tout utilisateur ou organisation nommé v2 sur votre instance GitHub Enterprise Server avant d’activer la prise en charge de l’écosystème Docker dans Management Console. Docker utilise un nom de compte v2 pour gérer les conflits de chemin d’accès avec l’API Docker. Une fois la prise en charge du registre Docker activée, vous ne pouvez plus utiliser ce nom.

Vous pouvez afficher la liste complète des connexions réservées à une utilisation interne en accédant à la page « Connexions réservées » dans le tableau de bord d’administrateur du site. Pour plus d’informations, consultez « Tableau de bord d’administration de site ».