Activation de l’accès automatique aux actions de GitHub.com à l’aide de GitHub Connect

Pour permettre à GitHub Actions dans votre entreprise d’utiliser les actions de GitHub.com, vous pouvez connecter votre instance d’entreprise à GitHub Enterprise Cloud.

Qui peut utiliser cette fonctionnalité ?

Enterprise owners can enable access to public GitHub.com actions.

Dans cet article

Remarque

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

À propos de l’accès automatique aux GitHub.com actions

Par défaut, les workflows sur GitHub Enterprise Server ne peuvent pas utiliser directement les actions de GitHub.com ou de GitHub Marketplace. Pour rendre disponibles sur votre instance d’entreprise les actions publiques de GitHub.com, vous pouvez utiliser GitHub Connect pour intégrer GitHub Enterprise Server à GitHub Enterprise Cloud.

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

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

À propos de la résolution des actions utilisant GitHub Connect

Lorsqu’un workflow utilise une action en référençant le dépôt où l’action est stockée, GitHub Actions tente d’abord de trouver le dépôt sur votre instance GitHub Enterprise Server. Si le dépôt n’existe pas sur votre instance GitHub Enterprise Server, et si vous avez activé l’accès automatique à GitHub.com, GitHub Actions tente de trouver le dépôt sur GitHub.com.

Si un utilisateur a déjà créé une organisation et un référentiel dans votre entreprise qui correspond à un nom d’organisation et de dépôt sur GitHub.com, le référentiel de votre entreprise sera utilisé au lieu du GitHub.com référentiel. Pour plus d’informations, consultez Retrait automatique des espaces de noms pour les actions accessibles sur GitHub.com.

Activation de l’accès automatique aux actions publiques GitHub.com

Avant d’activer l’accès aux actions publiques à partir de GitHub.com pour votre entreprise, vous devez :

  1. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
  2. En haut de la page, cliquez sur GitHub Connect.
  3. Sous « Les utilisateurs peuvent utiliser des actions à partir de GitHub.com dans les exécutions de flux de travail », utilisez le menu déroulant et sélectionnez Enabled.
  4. 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 ».

Retrait automatique des espaces de noms pour les actions accessibles sur GitHub.com

Lorsque vous activez GitHub Connect, les utilisateurs ne voient aucun changement de comportement pour les flux de travail existants, car GitHub Actions recherche votre instance GitHub Enterprise Server chaque action avant de revenir à GitHub.com. Cela garantit que toutes les versions personnalisées des actions créées par votre entreprise sont utilisées en préférence pour leurs équivalents sur GitHub.com.

Pour garantir que les flux de travail utilisent les actions prévues et bloquer les risques d'abus, lorsqu'une action sur GitHub.com est utilisée pour la première fois, l'espace de noms associé à cette action est supprimé dans votre entreprise. Cela empêche les utilisateurs de créer une organisation et un référentiel dans votre entreprise qui correspondent à l'espace de noms de l'action sur GitHub.com.

Après avoir utilisé une action dans GitHub.com, si vous souhaitez créer dans votre instance GitHub Enterprise Server une action portant le même nom, vous devez d’abord rendre disponible l’espace de noms de cette organisation et de ce dépôt.

  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 de gauche, sous Administrateur de site, cliquez sur Espaces de noms mis hors service.

  4. À droite de l’espace de noms dans lequel vous souhaitez l’utiliser votre instance GitHub Enterprise Server, cliquez sur Annuler l’utilisation.

  5. Accédez à l’organisation appropriée et créez un dépôt.

    Conseil

    Quand vous annulez la mise hors service d’un espace de noms, créez toujours le nouveau référentiel avec ce nom le plus vite possible. Si un workflow appelle l’action associée sur GitHub.com avant que vous ne créiez le dépôt local, l’espace de noms sera de nouveau retiré. Pour les actions utilisées dans des workflows fréquemment exécutés, il peut arriver qu’un espace de noms se retrouve à nouveau hors service avant même que le dépôt local ait pu être créé. Si cela vous arrive, vous pouvez désactiver temporairement les workflows en question, le temps de créer le nouveau dépôt.