Synchronisation manuelle des actions à partir de GitHub.com

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.

Nous recommandons d'activer l'accès automatique aux actions publiques en utilisant GitHub Connect pour intégrer GitHub Enterprise Server avec GitHub Enterprise Cloud. Consultez Activer l’accès automatique aux actions GitHub.com à l’aide de GitHub Connect.

Si vous souhaitez avoir un contrôle plus strict sur les actions autorisées dans votre entreprise, vous pouvez suivre ce guide pour utiliser notre outil open source actions-sync afin de synchroniser les référentiels d’actions individuels de GitHub.com avec votre entreprise.

Lorsque vous mettez à niveau GitHub Enterprise Server, les actions regroupées sont automatiquement remplacées par les versions par défaut dans le paquet de mise à niveau. Il ne s’agit pas nécessairement des dernières versions disponibles. En guise de bonne pratique, si vous utilisez actions-sync pour mettre à jour les actions, vous devez toujours réexécuter la commande actions-sync après toute GitHub Enterprise Server mise à jour (majeure ou mineure) pour s'assurer que les actions restent à jour.

À propos de l’outil actions-sync

L’outil actions-sync doit être exécuté sur une machine qui peut accéder à l'API GitHub.com et à l'API de votre instance GitHub Enterprise Server. et à l'API de votre instance GitHub Enterprise Server. La machine n’a pas besoin d’être connectée aux deux en même temps.

Si votre machine a accès aux deux systèmes en même temps, vous pouvez effectuer la synchronisation avec une seule commande actions-sync sync. Si vous ne pouvez accéder qu’à un seul système à la fois, vous pouvez utiliser les commandes actions-sync pull et push.

L’outil actions-sync ne peut télécharger que des actions sur GitHub.com stockées dans des référentiels publics.

Prérequis

• Avant d’utiliser l’outil actions-sync, vous devez vous assurer que toutes les organisations de destination existent déjà dans votre entreprise. L’exemple suivant montre comment synchroniser des actions avec une organisation nommée synced-actions. Consultez « Création d’une organisation à partir de zéro ».

• Vous devez créer un personal access token dans votre entreprise, qui peut créer et écrire sur les dépôts des organisations de destination. Consultez Gestion de vos jetons d'accès personnels.

• Si vous souhaitez synchroniser les actions groupées dans l’organisation actions sur votre instance GitHub Enterprise Server, vous devez être propriétaire de l’organisation actions.

  Remarque

  Par défaut, même les administrateurs de site ne sont pas propriétaires de l’organisation groupée actions.

  Les administrateurs de site peuvent utiliser la commande ghe-org-admin-promote dans l’interpréteur de commandes d’administration pour promouvoir un utilisateur comme propriétaire de l’organisation groupée actions. Consultez « Accès à l’interpréteur de commandes d’administration (SSH) » et « Utilitaires de ligne de commande».

  ghe-org-admin-promote -u USERNAME -o actions
  

Exemple : utilisation de l’outil actions-sync

Cet exemple montre comment utiliser l’outil actions-sync pour synchroniser une action individuelle depuis GitHub.com vers une instance d’entreprise.

1. Téléchargez et extrayez la dernière version de actions-sync pour le système d’exploitation de votre machine.

2. Créez un répertoire pour stocker des fichiers de cache pour l’outil.

3. Dans votre terminal, accédez au répertoire bin dans le répertoire de version que vous venez d’extraire. Par exemple :

   cd PATH/TO/gh_DATETIME_OS_ARCHITECTURE/bin
   

4. Exécutez la commande actions-sync sync :

   ./actions-sync sync \
     --cache-dir "cache" \
     --destination-token "aabbccddeeffgg" \
     --destination-url "https://my-ghes-instance" \
     --repo-name "actions/stale:synced-actions/actions-stale"
   

   La commande ci-dessus utilise les arguments suivants :

   • --cache-dir : répertoire de cache sur la machine exécutant la commande.

   • --destination-token : personal access token pour l’instance d’entreprise de destination.

   • --destination-url : URL de l’instance d’entreprise de destination.

   • --repo-name : référentiel d’actions à synchroniser. Prend le format owner/repository:destination_owner/destination_repository.

     • L’exemple ci-dessus synchronise le référentiel actions/stale vers le référentiel synced-actions/actions-stale sur l’instance d’entreprise de destination. Vous devez créer l’organisation nommée synced-actions dans votre entreprise avant d’exécuter la commande ci-dessus.
     • Si vous omettez :destination_owner/destination_repository, l’outil utilise le nom du propriétaire et du référentiel d’origine pour votre entreprise. Avant d’exécuter la commande, vous devez créer une organisation dans votre entreprise qui correspond au nom du propriétaire de l’action. Envisagez d’utiliser une organisation centrale pour stocker les actions synchronisées dans votre entreprise, car cela signifie que vous n’aurez pas besoin de créer plusieurs organisations si vous synchronisez des actions de différents propriétaires.
     • Vous pouvez synchroniser plusieurs actions en remplaçant le paramètre --repo-name par --repo-name-list ou --repo-name-list-file. Consultez le fichier README actions-sync.

5. Une fois le référentiel d’actions créé dans votre entreprise, les personnes de votre entreprise peuvent utiliser le référentiel de destination pour référencer l’action dans leurs workflows. Pour l’exemple d’action présenté ci-dessus :

   uses: synced-actions/actions-stale@v1
   

   Consultez « Workflow syntax for GitHub Actions ».