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 vous recommandons d’activer l’accès automatique à toutes les actions avec GitHub Connect pour intégrer GitHub Enterprise Server à GitHub Enterprise Cloud. Consultez « Activer l’accès automatique aux actions GitHub.com à l’aide de GitHub Connect ».

Si vous souhaitez 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 pour synchroniser des référentiels d’actions individuels de GitHub.com avec votre entreprise.

Lorsque vous mettez à niveau GitHub Enterprise Server, les actions groupées sont automatiquement remplacées par des versions par défaut dans le package 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 des actions, vous devez toujours réexécuter actions-sync après toute mise à niveau (majeure ou mineure) de GitHub Enterprise Server pour vous 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. 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. Voir « 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.

  Note

  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
  

Example: Using the actions-sync tool

This example demonstrates using the actions-sync tool to sync an individual action from GitHub.com to an enterprise instance.

1. Download and extract the latest actions-sync release for your machine's operating system.

2. Create a directory to store cache files for the tool.

3. In your terminal, change to the bin directory within the release directory you just extracted. For example:

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