Prise en main des packages GitHub pour votre entreprise

Vous pouvez commencer à utiliser GitHub Packagesvotre 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.

Dans cet article

Remarque

GitHub Packages on GitHub Enterprise Server ne supporte pas actuellement le clustering.

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

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

É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% ressources d’UC supplémentaires 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, votre instance GitHub Enterprise Serverconsultez les considérations matérielles relatives à 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 d’objets blob externe pour stocker vos packages.

Après avoir activé GitHub Packages pour votre instance GitHub Enterprise Server, vous devrez préparer votre bucket de stockage tiers. La quantité de stockage requise dépend de votre utilisation, GitHub Packageset 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 paquets 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 devrez créer et téléverser un certificat TLS permettant d’utiliser l’URL d’hébergement du package pour chaque écosystème que vous souhaitez utiliser, tel que 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 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 téléchargement de certificats TLS vers 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 d’abord renommer un utilisateur ou une organisation nommé v2 sur votre instance GitHub Enterprise Server, avant d’activer la prise en charge de l’écosystème Docker dans le Console de gestion. 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 « À propos des noms d’utilisateur réservés pour GitHub Enterprise Server ».