À propos de l’utilisation d’actions dans votre entreprise

GitHub Enterprise Server inclut la plupart des actions créées par GitHub et propose des options permettant d’activer l’accès à d’autres actions provenant de GitHub.com et de GitHub Marketplace.

Dans cet article

Remarque

Les exécuteurs hébergés sur GitHub Enterprise Server ne sont pas pris en charge sur GitHub.

À propos des actions sur GitHub Enterprise Server

GitHub Actions les flux de travail peuvent utiliser des actions, qui sont des tâches individuelles que vous pouvez combiner pour créer des travaux et personnaliser votre flux de travail. Vous pouvez créer vos propres actions ou utiliser et personnaliser des actions partagées par la GitHub communauté.

GitHub Actions sur GitHub Enterprise Server est conçu pour fonctionner dans des environnements n’ayant pas un accès à Internet complet. Par défaut, les workflows ne peuvent pas utiliser les actions de GitHub.com et de GitHub Marketplace. Vous pouvez restreindre vos développeurs à l’utilisation d’actions stockées sur votre instance GitHub Enterprise Server, qui incluent la plupart des actions créées par l’auteur officiel GitHub, ainsi que les actions que vos développeurs créent. Vous pouvez également permettre à vos développeurs de bénéficier de l’écosystème complet d’actions créées par les leaders du secteur et la communauté open source, vous pouvez configurer l’accès à d’autres actions à partir de GitHub.com.

Nous vous recommandons d’autoriser l’accès automatique à toutes les actions à partir de GitHub.com. Toutefois, cela nécessite GitHub Enterprise Server d’établir des connexions sortantes vers GitHub.com. Si vous ne souhaitez pas autoriser ces connexions, ou si vous souhaitez avoir un meilleur contrôle sur les actions utilisées sur votre entreprise, vous pouvez synchroniser manuellement des actions spécifiques à partir de GitHub.com.

Actions officielles incluses avec votre instance d’entreprise

La plupart des actions officielles créées par GitHub sont automatiquement groupées avec GitHub Enterprise Server, et capturées à un moment donné à partir de GitHub Marketplace.

Voici les actions officielles regroupées, parmi d'autres.

  • actions/checkout
  • actions/upload-artifact
  • actions/download-artifact
  • actions/labeler
  • Diverses actions actions/setup-

Pour voir toutes les actions officielles incluses dans votre instance d’entreprise, accédez à l’organisation actions de votre instance : https://HOSTNAME/actions.

Aucune connexion entre votre instance GitHub Enterprise Server et GitHub.com n’est requise pour utiliser ces actions.

Chaque action est un dépôt dans l’organisation actions, et chaque dépôt d’actions comprend les étiquettes, les branches et les SHA de commit nécessaires dont peuvent se servir vos workflows pour référencer une action. Pour savoir comment mettre à jour les actions groupées officielles, consultez « Utilisation de la dernière version des actions groupées officielles ».

Remarque

  • Lorsque vous utilisez des actions d’installation (par exemple actions/setup-LANGUAGE) sur GitHub Enterprise Server des exécuteurs auto-hébergés, vous devrez peut-être configurer le cache des outils sur les exécuteurs qui n’ont pas d’accès à Internet. Pour plus d’informations, consultez « Configuration du cache d’outils sur les exécuteurs auto-hébergés sans accès à Internet ».
  • Tous les dépôts d’actions actions/setup-LANGUAGE prennent actuellement en charge trois plateformes : macOS, Windows et Ubuntu.
  • Lorsque GitHub Enterprise Server est mis à jour, les actions groupées sont automatiquement remplacées par des versions par défaut dans le package de mise à niveau.
  • Le fait d’être inclus dans GitHub Enterprise Server signifie que l’action est disponible au sein de cet environnement, mais cela ne garantit pas automatiquement sa compatibilité avec toutes les plateformes ou les runners auto-hébergés.

Configuration de l’accès aux actions sur GitHub.com

Dans votre entreprise, si les utilisateurs ont besoin d’accéder à d’autres actions de GitHub.com ou GitHub Marketplace, il existe quelques options de configuration.

L’approche recommandée consiste à activer l’accès automatique à toutes les actions à partir de GitHub.com. Vous pouvez le faire en utilisant GitHub Connect pour intégrer GitHub Enterprise Server à GitHub Enterprise Cloud. Pour plus d’informations, consultez « Activation de l’accès automatique aux actions de GitHub.com à l’aide de GitHub Connect ».

Remarque

Avant de pouvoir configurer l’accès aux actions sur GitHub.com, vous devez configurer votre instance GitHub Enterprise Server pour utiliser GitHub Actions. Pour plus d’informations, consultez « Prise en main de GitHub Actions pour GitHub Enterprise Server ».

Pour utiliser des actions provenant de GitHub.com, à la fois GitHub Enterprise Server et, vos exécuteurs auto-hébergés doivent être en mesure d’établir des connexions sortantes vers GitHub.com. Aucune connexion entrante depuis GitHub.com n’est requise. Pour plus d’informations, consultez « Documentation de référence relative aux runners auto-hébergés ».

Une fois que vous avez activé GitHub Connect, vous pouvez utiliser des stratégies pour restreindre les actions publiques qui peuvent être utilisées dans les référentiels de votre entreprise. Pour plus d’informations, consultez « Application de stratégies pour GitHub Actions dans votre entreprise ».

Sinon, si vous souhaitez un contrôle plus strict sur les actions autorisées dans votre entreprise, ou si vous ne souhaitez pas autoriser les connexions sortantes vers GitHub.com, vous pouvez télécharger et synchroniser manuellement des actions dans votre instance d’entreprise à l’aide de l’outil actions-sync. Pour plus d’informations, consultez « Synchronisation manuelle des actions à partir de GitHub.com ».