GitHub (TMS)

Le contenu est traduit de l’anglais par Phrase Language AI.

Disponible pour

les forfaits Team, Business et Enterprise

Contactez le service commercial pour toute question relative aux licences.

Disponible pour

les forfaits Ultimate et Enterprise (anciens)

Contactez le service commercial pour toute question relative aux licences.

Astuce

Pour des informations sur l'intégration de GitHub dans Phrase Strings, référez-vous à GitHub (Strings).

Le connecteur GitHub permet le téléchargement de fichiers source et le téléchargement de fichiers cibles directement vers/depuis le référentiel GitHub.

Le connecteur utilise l'API GitHub pour mettre en œuvre l'intégration. Le connecteur permet d'accéder à tous les référentiels associés à un compte GitHub. L'authentification du compte GitHub peut également être effectuée dans l'application GitHub.

Cas d'utilisation

Il existe un certain nombre de cas d'utilisation pour le connecteur :

Les chefs de projet peuvent ajouter des fichiers directement aux projets depuis un référentiel en ligne.
Configurez le portail de l’envoyeur pour permettre aux envoyeurs d’ajouter des fichiers aux demandes directement depuis le référentiel en ligne.
Utilisez la création de projets automatisée (APC) pour que de nouveaux projets soient automatiquement créés lorsqu'un changement dans la taille du fichier est détecté dans des fichiers ou un dossier suivis.
- Ce connecteur prend en charge la définition de chemins absolus. Les fichiers de traduction cibles ne peuvent être stockés que dans la même branche que le fichier source.
Configurez des tâches continues pour surveiller les fichiers sélectionnés pour des changements.

GitHub (Beta)

Remarque

Le connecteur est en version bêta depuis juin 2026.

Authentification

Le connecteur GitHub (Bêta) utilise le jeton d'installation de l'application GitHub plutôt qu'un compte utilisateur individuel. Les jetons sont de courte durée et se renouvellent automatiquement. Si un utilisateur quitte l'organisation ou perd l'accès au référentiel, le connecteur continue de fonctionner.

Le connecteur GitHub (Bêta) prend uniquement en charge l'authentification par application GitHub. L'option OAuth de l'ancien connecteur n'est pas prise en charge.

Exporter

Le connecteur GitHub (Bêta) regroupe tous les fichiers d'une seule exportation en un seul commit et une seule demande de tirage, donc l'intégration continue s'exécute une fois par exportation, quel que soit le nombre de fichiers.

Les fichiers sont regroupés en un seul commit lorsque tout le contenu partage le même propriétaire de référentiel, le même référentiel et la même branche.

Si l'APC est configuré pour charger des fichiers au fur et à mesure qu'ils sont terminés individuellement, chaque fichier sera engagé séparément plutôt que regroupé.

Les messages de commit sont générés automatiquement et ne peuvent pas être personnalisés. Si vous exportez en tant que demande de tirage, le nom de la demande de tirage et le nom de la branche cible peuvent être personnalisés.

Limitations connues

Le connecteur peut lister, télécharger et charger des fichiers uniquement. La suppression ou le déplacement de fichiers dans GitHub n'est pas pris en charge. Toute suppression ou renommage doit être effectué directement dans GitHub.
La liste des fichiers peut ne pas fonctionner correctement pour les référentiels contenant plus de 50 000 fichiers en raison des limitations de l'API GitHub.
GitHub Enterprise Server n'est actuellement pas pris en charge.
Le nouveau connecteur ne prend pas en charge le flux OAuth du connecteur ancien. Si votre organisation a des restrictions sur les installations d'applications GitHub, résolvez-les avant de migrer.

Migration vers le nouveau connecteur GitHub (Beta)

La migration automatisée n'est pas possible en raison du changement de modèle d'authentification.

Conditions préalables :

Accès administrateur à votre organisation GitHub pour installer une application GitHub. Installez-le au niveau de l'organisation afin qu'il couvre tous les référentiels que vos APC surveillent.
Paramètres APC existants visibles (gardez l'ancien connecteur ouvert dans un second onglet).
Une branche de test ou un référentiel non productif à valider avant de passer aux flux de travail en direct.

Suivez ces étapes :

Installez l'application GitHub Phrase.
1. Dans Phrase TMS, à partir de la page des paramètres , faites défiler vers le bas jusqu'à la section Intégrations.
2. Cliquez sur Connecteurs.
  
  La page Connecteurs s'ouvre.
3. Cliquez sur Nouveau connecteur.
  
  La page Créer un connecteur s'ouvre.
4. Changez le Type en GitHub (Beta).
5. Cliquez sur Connecter.
  
  Phrase redirige vers GitHub pour autoriser l'application GitHub Phrase.
6. Sur GitHub, sélectionnez l'organisation ou le compte et les référentiels auxquels accorder l'accès, puis confirmez l'installation. Inclure tous les référentiels actuellement surveillés par le(s) connecteur(s) existant(s).
  
  GitHub redirige automatiquement vers Phrase.
7. Sélectionnez le compte utilisateur ou organisation à connecter.
Créer un nouveau connecteur.
1. Dans Phrase TMS, à partir de la page des paramètres , faites défiler vers le bas jusqu'à la section Intégrations.
2. Cliquez sur Connecteurs.
3. Cliquez sur Nouveau connecteur.
4. Sélectionnez l'installation de l'application GitHub configurée lors de la première étape.
5. Copier les paramètres du connecteur existant :
  - Référentiel et branche
  - Chemin du sous-dossier (si vous utilisez la surveillance de sous-dossier)
  - Expression régulière de filtre de fichier (si configurée)
  - Mode d'exportation : commit direct ou demande de tirage, et branche cible
  - Nom de la demande de tirage et nom de la branche cible (si vous utilisez le mode PR)
  Il est possible de créer plusieurs connecteurs sous la même installation de l'application GitHub, chacun avec des paramètres indépendants.
Recréer les APC existants en utilisant le mode dry-run.

Ne supprimez pas ou ne désactivez pas encore les APC existants.
1. Créer de nouveaux APC pointant vers le nouveau connecteur, en miroir de la configuration des APC existants.
2. Activer le mode dry-run sur chaque nouvel APC avant de l'activer. Le mode dry-run analyse le référentiel et fait correspondre les fichiers sans déclencher de travaux de traduction.
3. Examinez les fichiers correspondants. Confirmer que la portée correspond à ce que surveillent les APC existants.
Valider avec un export de test.
1. Apportez un petit changement à un fichier dans le champ surveillé.
2. Déclenchez une exportation via le nouveau connecteur.
3. Confirmer :
  - Un seul commit est créé (pas un par fichier).
  - Le commit apparaît sous l'identité de l'application GitHub, pas d'un compte personnel.
  - CI s'exécute une fois, pas une fois par fichier.
Activez les workflows en direct.

Une fois la validation réussie :
1. Désactivez les APC sur le connecteur ancien.
2. Activez les APC sur le nouveau connecteur (retirez le mode dry-run).
3. Surveillez un ou deux cycles d'exportation avant de décommissionner le connecteur ancien.
Décommissionnez le connecteur ancien.

Après avoir confirmé que le nouveau connecteur est stable :
1. Supprimez les anciens APC.
2. Supprimez le connecteur ancien des Paramètres → Connecteurs → GitHub (ancien).
3. En option, révoquez le jeton OAuth pour le compte utilisateur qui a été utilisé par le connecteur ancien.

Paramètres GitHub (ancien)

Aucun changement n'est requis.

Paramètres Phrase TMS

Important

Si vous accédez à partir d'un domaine personnalisé (ex. mydomain.phrase.jp), ouvrez une fenêtre de navigateur incognito et connectez-vous via cloud.memsource.com ou us.cloud.memsource.com pour appliquer l'authentification requise pour la création ou l'enregistrement du connecteur. Après l'enregistrement, le connecteur peut être accessible via le domaine personnalisé.

À partir de la page des paramètres , faites défiler vers le bas jusqu'à la section Intégrations.
Cliquez sur Connecteurs.

La page Connecteurs s'ouvre.
Cliquez sur Nouveau connecteur.

La page Créer un connecteur s'ouvre.
Changez le Type en GitHub et fournissez un nom pour le connecteur.
Optionnellement, sélectionnez Exporter les traductions en tant que demandes de tirage et fournissez une branche de demande de tirage.
Si nécessaire, sélectionnez Utiliser l'application Github pour afficher l'URL de l'application Phrase GitHub et importer/exporter des fichiers en utilisant le flux d'autorisation de l'application GitHub :
1. Cliquez sur le lien pour ouvrir la page officielle du connecteur de l'application Phrase dans un nouvel onglet : https://github.com/apps/phrase-app-connector-eu (centre de données UE) ou https://github.com/apps/phrase-app-connector-us (centre de données US).
2. Installez l'application Phrase GitHub sur le compte GitHub cible.
  
  Remarque
  
  Si l'application GitHub n'est pas installée sur le compte GitHub cible de l'utilisateur, seules les dépôts publics seront visibles pour le connecteur GitHub.
3. Complétez la procédure d'installation en sélectionnant tous les dépôts privés qui seront visibles et accessibles pour le connecteur GitHub.
4. Retournez à la page Connecteurs/Créer de Phrase pour autoriser l'application GitHub et vous connecter à GitHub.
Cliquez sur Connecter à GitHub. Si vous n'êtes pas connecté en utilisant l'application GitHub, une fenêtre contextuelle ou un nouvel onglet apparaîtra pour demander l'autorisation.
Fournissez un message de validation si nécessaire.
Cliquez sur le bouton Autoriser Phrase.

Si vous utilisez l'application GitHub, cliquez sur le bouton Autoriser le connecteur de l'application Phrase.

Si cela réussit, la fenêtre/l'onglet disparaîtra et une petite coche apparaîtra à côté du bouton Connecter à GitHub.
Cliquez sur Enregistrer.

Le connecteur est ajouté à la liste de la page Connecteurs.

Important

Si le connecteur GitHub est créé en utilisant le flux d'autorisation de l'application GitHub, il n'est pas possible de changer la méthode d'autorisation après avoir enregistré les paramètres du connecteur.