Configuration de la prise en charge de l’écosystème de packages pour votre entreprise

Vous pouvez configurer GitHub Packages pour votre entreprise en activant ou en désactivant globalement des écosystèmes de packages individuels sur votre entreprise, notamment Container registry, Docker et npm. Découvrez les autres exigences de configuration pour prendre en charge des écosystèmes de package spécifiques.

Qui peut utiliser cette fonctionnalité ?

Site administrators can enable GitHub Packages and configure enterprise settings.

Dans cet article

À propos de la prise en charge de l’écosystème de packages

Vous pouvez choisir 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.

Prérequis

Avant de pouvoir configurer des écosystèmes de packages individuels, GitHub Packages doit être activé et configuré pour votre instance. Pour plus d’informations, consultez « Bien démarrer avec GitHub Packages pour votre entreprise ».

Activation ou désactivation d’écosystèmes de package individuels

Pour empêcher le chargement de nouveaux packages, vous pouvez définir un écosystème que vous avez précédemment activé en lecture seule et continuer à autoriser le téléchargement de packages existants.

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.

  2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.

  3. Dans la barre latérale «  Administrateur de site », cliquez sur Management Console .

  4. Dans la barre latérale gauche, cliquez sur Packages.

  5. Sous « Bascules d’écosystème », pour chaque type de package, sélectionnez Activé, Lecture seule ou Désactivé.

    Note

    L'isolation des sous-domaines doit être activée pour faire basculer les options Container registry.

    Capture d'écran de la section « Bascules de l'écosystème » sur la page Paramètres de la console de gestion.

  6. Sous la barre latérale « Paramètres », cliquez sur Enregistrer les paramètres.

    Remarque : l’enregistrement des paramètres dans la Management Console redémarre les services système, ce qui peut entraîner un temps d’arrêt visible pour l’utilisateur.

  7. Attendez la fin de l’exécution de la configuration.

Connexion au registre npm officiel

Si vous avez activé les packages npm sur votre entreprise et que vous souhaitez autoriser l’accès au registre npm officiel et au registre npm GitHub Packages, vous devez effectuer une configuration supplémentaire.

GitHub Packages utilise un proxy transparent pour le trafic réseau, qui se connecte au registre npm officiel sur registry.npmjs.com. Le proxy est activé par défaut et ne peut pas être désactivé.

Pour autoriser les connexions réseau au registre npm, vous devez configurer des listes de contrôle d’accès réseau autorisant GitHub Enterprise Server à envoyer le trafic HTTPS à registry.npmjs.com sur le port 443/TCP.

Notez que les connexions à registry.npmjs.com traversent le réseau Cloudflare et, par la suite, ne se connectent pas à une seule adresse IP statique. En fait, une connexion est établie à une adresse IP dans les plages CIDR listées ici : https://www.cloudflare.com/ips/.

Si vous souhaitez activer les sources npm en amont, sélectionnez Enabled pour npm upstreaming.

Étapes suivantes

Nous vous recommandons ensuite de vérifier si vous devez mettre à jour ou charger un certificat TLS pour l’URL hôte de vos packages. Pour plus d’informations, consultez « Bien démarrer avec GitHub Packages pour votre entreprise ».