Activation de GitHub Packages avec AWS

Configurez GitHub Packages en faisant d’AWS votre stockage externe.

Dans cet article

Warning

  • Il est essentiel de configurer 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. Pour plus d’informations, consultez « Setting bucket and object access permissions » (Définition des autorisations d’accès aux compartiments et aux objets) dans la documentation AWS. 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.

Prérequis

Pour pouvoir activer et configurer GitHub Packages sur votre instance GitHub Enterprise Server, vous devez préparer votre compartiment de stockage AWS. Pour préparer votre compartiment de stockage AWS, nous vous recommandons de consulter la documentation AWS officielle.

Vérifiez que votre ID de clé d’accès et votre secret AWS 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 AWS

  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 « Packages GitHub », cochez la case Activer les packages GitHub.

  6. Sous « Stockage de packages », sélectionnez Amazon S3 et entrez les détails de votre compartiment de stockage :

    • URL du service AWS : URL du service pour votre compartiment. Par exemple, si votre compartiment S3 a été créé dans la us-west-2 region, cette valeur doit être https://s3.us-west-2.amazonaws.com.

      Pour plus d’informations, consultez « Points de terminaison de service AWS » dans la documentation AWS.

    • Compartiment AWS S3 : Nom de votre compartiment S3 dédié à GitHub Packages.

    • Clé d’accès AWS S3 et Clé secrète AWS S3 : ID de clé d’accès et clé secrète AWS permettant d’accéder à votre compartiment.

      Pour plus d’informations sur la gestion des clés d’accès AWS, consultez la « documentation relative à AWS Identity and Access Management ».

  7. 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.

  8. 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 GitHub. 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 ».