Skip to main content

Activation de GitHub Actions avec le stockage Amazon S3

Vous pouvez activer GitHub Actions sur GitHub Enterprise Server, et utiliser le stockage Amazon S3 pour stocker les données générées par les exécutions de workflow.

Who can use this feature

Site administrators can enable GitHub Actions and configure enterprise settings.

À propos du stockage externe pour GitHub Actions

GitHub Actions utilise un stockage d’objets blob externe pour stocker les données générées par les exécutions de workflows, comme les journaux de workflow, les caches, et les artefacts de build chargés par les utilisateurs. Pour plus d’informations, consultez « Bien démarrer avec GitHub Actions pour GitHub Enterprise Server ».

Prérequis

Remarque : Les seuls fournisseurs de stockage S3 pris en charge par GitHub sont Amazon S3 et MinIO Gateway pour NAS.

Il existe d’autres produits de stockage compatibles avec l’API S3 que ceux validés par les partenaires GitHub comme fonctionnant avec GitHub Actions sur GitHub Enterprise Server. Pour plus d’informations, consultez le référentiel Partenaires de stockage GHES.

Pour les produits de stockage validés via le programme de partenariat technologique GitHub, le fournisseur de stockage est responsable du support et de la documentation pour l’utilisation du produit de stockage avec GitHub Actions.

Avant d’activer GitHub Actions, vérifiez que vous avez effectué les étapes suivantes :

  • Créez votre compartiment Amazon S3 pour stocker les données générées par les exécutions de workflow. GitHub Actions requiert les autorisations suivantes pour la clé d’accès qui accédera au compartiment :

    • s3:PutObject
    • s3:GetObject
    • s3:ListBucketMultipartUploads
    • s3:ListMultipartUploadParts
    • s3:AbortMultipartUpload
    • s3:DeleteObject
    • s3:ListBucket
    • kms:GenerateDataKey(si le chiffrement du Service de gestion des clés (KMS) a été activé)
  • Passez en revue les exigences matérielles relatives à GitHub Actions. Pour plus d’informations, consultez « Bien démarrer avec GitHub Actions pour GitHub Enterprise Server ».

  • TLS doit être configuré pour le domaine de your GitHub Enterprise Server instance. Pour plus d’informations, consultez « Configuration du protocole TLS ».

    Remarque : Nous vous recommandons vivement de configurer TLS sur GitHub Enterprise Server avec un certificat signé par une autorité de confiance. Bien qu’un certificat autosigné puisse fonctionner, une configuration supplémentaire est nécessaire pour vos exécuteurs autohébergés. Elle n’est pas recommandée pour les environnements de production.

  • Si vous avez un serveur proxy HTTP configuré sur your GitHub Enterprise Server instance :

    • Vous devez ajouter localhost et 127.0.0.1 à la liste Exclusion du proxy HTTP.
    • Si votre emplacement de stockage externe n’est pas routable, vous devez également ajouter l’URL de votre stockage externe à la liste d’exclusion.

    Pour plus d’informations sur le changement de vos paramètres de proxy, consultez « Configuration d’un serveur proxy web de trafic sortant ».

Activation de GitHub Actions avec un stockage Amazon S3

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur dans le coin supérieur droit de n’importe quelle page.

    Capture d’écran de l’icône représentant une fusée qui donne accès aux paramètres d’administration du site

  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.

    Capture d’écran du lien « Administrateur du site » 1. Dans la barre latérale gauche, cliquez sur Management Console . Onglet Management Console dans la barre latérale gauche 1. Dans la barre latérale à gauche, cliquez sur Actions.

    Onglet Actions dans la barre latérale des paramètres 1. Sélectionnez Activer GitHub Actions. Case à cocher pour activer GitHub Actions

  3. Sous « Stockage d’artefacts et de journaux », 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 région us-west-2, 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.

    • Clé d’accès AWS S3 et Clé secrète AWS S3 : ID de clé d’accès et clé secrète AWS de votre compartiment. Pour plus d’informations sur la gestion des clés d’accès AWS, consultez la « documentation AWS Identity and Access Management ».

    Case d’option pour sélectionner Amazon S3 Storage et champs pour la configuration S3 1. Cliquez sur le bouton Tester les paramètres de stockage pour valider vos paramètres de stockage.

    En cas d’erreurs au moment de la validation des paramètres de stockage, vérifiez ces paramètres auprès de votre fournisseur de stockage, puis réessayez. 1. Sous la barre latérale gauche, cliquez sur Enregistrer les paramètres.

    Capture d’écran du bouton Enregistrer les paramètres de la Management Console

    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.

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

    Configuration de votre instance

Étapes suivantes

Une fois l’exécution de la configuration réussie, GitHub Actions est activé sur your GitHub Enterprise Server instance. Pour les prochaines étapes, par exemple la gestion des autorisations d’accès de GitHub Actions et l’ajout d’exécuteurs autohébergés, retournez à « Bien démarrer avec GitHub Actions pour GitHub Enterprise Server ».