Avertissements :
- Il est essentiel de définir les stratégies d’accès restrictives dont vous avez besoin pour votre compartiment de stockage, car GitHub n’applique pas d’autorisations d’objet spécifiques ou de listes de contrôle d’accès (ACL) supplémentaires à la configuration de votre compartiment de stockage. Par exemple, si vous rendez votre compartiment public, les données du compartiment sont accessibles sur l’Internet public. Si des restrictions par adresse IP ont été configurées, incluez les adresses IP pour votre instance GitHub Enterprise Server et les utilisateurs finaux qui utiliseront votre instance GitHub Enterprise Server.
- Nous vous recommandons d’utiliser un compartiment dédié pour GitHub Packages, séparé du compartiment que vous utilisez pour le stockage GitHub Actions.
- Veillez à configurer le compartiment à utiliser à l’avenir. Nous vous déconseillons de modifier votre stockage après avoir commencé à utiliser GitHub Packages.
- Nous vous recommandons de configurer le protocole TLS pour le compartiment afin d’éviter d’éventuels problèmes avec le registre de package, par exemple, en téléchargeant à partir de NuGet Registry.
Prérequis
Pour pouvoir activer et configurer GitHub Packages sur votre instance GitHub Enterprise Server, vous devez préparer votre compartiment de stockage MinIO. Pour configurer rapidement un compartiment MinIO et mieux vous orienter dans les options de personnalisation de MinIO, consultez « Démarrage rapide : Configuration de votre compartiment de stockage MinIO pour GitHub Packages ».
Vérifiez que votre ID de clé d’accès de stockage externe et votre secret MinIO disposent des autorisations suivantes :
s3:PutObject
s3:GetObject
s3:ListBucketMultipartUploads
s3:ListMultipartUploadParts
s3:AbortMultipartUpload
s3:DeleteObject
s3:ListBucket
Activation de GitHub Packages avec le stockage externe MinIO
Même si, pour le moment, MinIO n’apparaît pas dans l’interface utilisateur sous « Stockage de package », MinIO est bien pris en charge par GitHub Packages sur GitHub Enterprise. Notez également que le stockage d’objet de MinIO est compatible avec l’API S3 et que vous pouvez entrer les détails du compartiment MinIO à la place des détails d’AWS S3.
-
À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
-
Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
-
Dans la barre latérale « Administrateur de site », cliquez sur Management Console .
-
Dans la barre latérale gauche, cliquez sur Packages.
-
Sous « Packages GitHub », cochez la case Activer les packages GitHub.
-
Sous « Stockage de packages », sélectionnez Amazon S3.
-
Entrez les détails de votre compartiment de stockage MinIO dans les paramètres de stockage AWS.
- URL du service AWS : URL d’hébergement de votre compartiment MinIO.
- Compartiment AWS S3 : Nom de votre compartiment MinIO compatible S3 dédié à GitHub Packages.
- Clé d’accès AWS S3 et Clé secrète AWS S3 : Entrez l’ID de clé d’accès et la clé secrète MinIO permettant d’accéder à votre compartiment.
-
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.
-
Attendez la fin de l’exécution de la configuration.
Étapes suivantes
Vous pouvez ensuite personnaliser les écosystèmes de packages que vous souhaitez mettre à la disposition des utilisateurs finaux sur votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « Configuration de la prise en charge de l’écosystème de packages pour votre entreprise ».
Pour une vue d’ensemble de la prise en main de GitHub Packages sur GitHub, consultez « Bien démarrer avec GitHub Packages pour votre entreprise ».