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 (ancienne version)

Contactez le service commercial pour toute question relative aux licences.

Astuce

Pour plus d'informations sur l'intégration GitHub dans Phrase Strings, reportez-vous à GitHub (Strings).

Le connecteur GitHub permet de télécharger des fichiers sources depuis le dépôt GitHub et d’y téléverser des fichiers cibles.

Le connecteur utilise l'API GitHub pour implémenter l'intégration. Le connecteur permet d'accéder à tous les dépôts associés à un compte GitHub. L'authentification au compte GitHub peut également être effectuée dans la GitHub App.

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 dépôt en ligne.
Configurez le portail des demandeurs pour permettre aux demandeurs d’ajouter directement des fichiers aux demandes depuis le dépôt en ligne.
Utilisez la création automatisée de projets (APC) pour créer automatiquement de nouveaux projets lorsqu’une modification de la taille de fichier est détectée dans les fichiers ou le dossier surveillés.
- Ce connecteur prend en charge la configuration d'un chemin absolu. Les fichiers de traduction cible ne peuvent être stockés que dans la même branche que le fichier source.
Configurez des tâches continues pour que les fichiers sélectionnés soient surveillés en cas de modification.

GitHub (Bêta)

Remarque

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

Authentification

Le connecteur GitHub (Bêta) utilise le jeton d'installation de la GitHub App 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 dépôt, le connecteur continue de fonctionner.

Le connecteur GitHub (Bêta) prend uniquement en charge l'authentification via la GitHub App. L'option OAuth du connecteur d'origine n'est pas prise en charge.

Exportation

Le connecteur GitHub (Bêta) regroupe tous les fichiers d’une même exportation dans un seul commit et une seule pull request. L’intégration continue ne s’exécute ainsi qu’une fois par exportation, quel que soit le nombre de fichiers.

Les fichiers sont regroupés dans un seul commit lorsque tout le contenu partage le même propriétaire de dépôt, le même dépôt et la même branche.

Si l'APC est configuré pour téléverser les fichiers au fur et à mesure qu'ils sont terminés individuellement, chaque fichier fera l'objet d'un commit distinct au lieu d'être regroupé avec les autres.

Les messages de commit sont générés automatiquement et ne peuvent pas être personnalisés. En cas d'exportation sous forme de pull request, le nom de la pull request et le nom de la branche cible peuvent être personnalisés.

Chemin d'exportation et sous-dossiers

Lorsque le chemin d'exportation des fichiers du dépôt en ligne commence par / (un chemin absolu), le connecteur GitHub (Bêta) conserve la structure des sous-dossiers des fichiers sources. Chaque fichier traduit est exporté dans un sous-dossier du chemin d’exportation correspondant à celui du fichier source dans le dossier surveillé par la création automatisée de projets (APC).

Un fichier situé directement dans le dossier surveillé est exporté directement vers le chemin d'exportation. Aucun sous-dossier n'est ajouté pour un chemin d'exportation relatif ou lorsque les sous-dossiers ne sont pas inclus.

Un chemin d'exportation absolu commence à la racine du dépôt de la branche source.

Limitations connues

Le connecteur peut uniquement lister, télécharger et téléverser des fichiers. La suppression ou le déplacement de fichiers dans GitHub n'est pas pris en charge. Toute suppression ou tout renommage doit être effectué directement dans GitHub.
La liste des fichiers peut ne pas s’afficher correctement dans les dépôts 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 hérité. Si votre organisation impose des restrictions concernant l’installation d’applications GitHub, levez-les avant de procéder à la migration.

Passage au nouveau connecteur GitHub (Bêta)

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

Note

Le passage d'une APC continue de l'ancien connecteur au nouveau connecteur n'est pas une migration. Phrase le traite comme une nouvelle configuration de connecteur : l'APC réimporte donc le fichier source en tant que nouvelle tâche au lieu de mettre à jour la tâche existante. Le fichier est traité comme un nouveau contenu, donc les mots précédemment traités et les unités de traduction automatique (MTU) ne sont pas transférés. Lors du changement de connecteur en cours de projet, attendez-vous à ce que le nombre de mots et la consommation de MTU/crédits pour les fichiers concernés reflètent une réimportation complète.

Prérequis :

Accès administrateur à votre organisation GitHub pour installer une application GitHub. Installez-la au niveau de l'organisation afin qu'elle couvre tous les dépôts surveillés par vos APC.
L’application GitHub installée doit avoir accès aux dépôts contenant du contenu à traduire. Sans cet accès, l’importation via une APC échouera.
Les paramètres des APC existantes à portée de main (gardez l’ancien connecteur ouvert dans un autre onglet).
Une branche de test ou un dépôt hors production pour effectuer des vérifications avant de basculer les flux de travail en production.

Suivez ces étapes :

Installez l'application Phrase GitHub.
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. Modifiez le Type en GitHub (Beta).
5. Cliquez sur Connecter.
  
  Phrase redirige vers GitHub pour autoriser l'application Phrase GitHub.
6. Sur GitHub, sélectionnez l'organisation ou le compte et les dépôts auxquels accorder l'accès, puis confirmez l'installation. Incluez tous les dépôts actuellement surveillés par les connecteurs existants.
  
  GitHub redirige automatiquement vers Phrase.
7. Sélectionnez le compte utilisateur ou le compte d'organisation à connecter.
Créez 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. Copiez les paramètres du connecteur existant :
  - Dépôt et branche
  - Chemin du sous-dossier (si vous utilisez la surveillance de sous-dossier)
  - Expression régulière de filtrage des fichiers (si configurée)
  - Mode d'exportation : commit direct ou pull request, et branche cible
  - Nom de la pull request et nom de la branche cible (si le mode PR est utilisé)
  Vous pouvez créer plusieurs connecteurs pour une même installation de l’application GitHub, chacun avec ses propres paramètres.
Recréez les APC existantes en mode dry-run.

Ne supprimez ni ne désactivez les APC existantes pour le moment.
1. Créez de nouvelles APC utilisant le nouveau connecteur, en reprenant la configuration des APC existantes.
2. Activez le mode dry-run sur chaque nouvelle APC avant de l’activer. Le mode dry-run analyse le dépôt et repère les fichiers correspondants sans déclencher de travaux de traduction.
3. Examinez les fichiers correspondants. Vérifiez que le périmètre correspond à celui surveillé par l’APC existante.
Effectuez une validation à l'aide d'une exportation de test.
1. Apportez une petite modification à un fichier dans le périmètre surveillé.
2. Déclenchez une exportation via le nouveau connecteur.
3. Vérifiez les points suivants :
  - Un seul commit est créé (pas un par fichier).
  - Le commit apparaît sous l'identité de l'application GitHub, et non sous un compte personnel.
  - L'intégration continue (CI) s'exécute une fois, et non une fois par fichier.
Basculez les flux de travail actifs.

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

Après avoir confirmé que le nouveau connecteur est stable :
1. Supprimez les anciens APC.
2. Supprimez l'ancien connecteur depuis Paramètres → Connecteurs → GitHub (Legacy).
3. Si vous le souhaitez, révoquez le jeton OAuth du compte utilisateur utilisé par l’ancien connecteur.

Paramètres GitHub (ancienne version)

Aucune modification n'est requise.

Paramètres Phrase TMS

Important

En cas d'accès depuis un domaine personnalisé (par ex. mydomain.phrase.jp), ouvrez une fenêtre de navigation privée et connectez-vous via cloud.memsource.com ou us.cloud.memsource.com pour effectuer l'authentification requise pour créer ou enregistrer le connecteur. Après l'enregistrement, le connecteur est 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.
Modifiez le Type en GitHub et indiquez un nom pour le connecteur.
Vous pouvez également activer Use custom domain et indiquer l’API URL.
Vous pouvez également sélectionner Export translations as pull requests et indiquer une Pull request branch.
Si nécessaire, sélectionnez Use Github app pour afficher l’URL de l’application Phrase GitHub et importer et exporter des fichiers à l’aide du processus d’autorisation de l’application GitHub :
1. Cliquez sur le lien pour ouvrir la page officielle de Phrase App Connector dans un nouvel onglet : https://github.com/apps/phrase-app-connector-eu (centre de données de l’UE) ou https://github.com/apps/phrase-app-connector-us (centre de données des États-Unis).
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, seuls les dépôts publics seront visibles dans le connecteur GitHub.
3. Terminez la procédure d'installation en sélectionnant les dépôts privés que vous souhaitez rendre visibles et accessibles dans le connecteur GitHub.
4. Revenez à la page Connectors/Create de Phrase pour autoriser l'application GitHub et vous connecter à GitHub.
Cliquez sur Connect to GitHub. Si vous n'êtes pas connecté via l'application GitHub, une fenêtre contextuelle ou un nouvel onglet apparaîtra pour demander l'autorisation.
Renseignez le champ Commit message si nécessaire.
Cliquez sur le bouton Authorize Phrase.

Si vous utilisez l’application GitHub, cliquez sur le bouton Authorize Phrase App Connector.

Si l’opération réussit, la fenêtre ou l’onglet disparaît et une petite coche apparaît à côté du bouton Connect to GitHub.
Cliquez sur Enregistrer.

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

Important

Si le connecteur GitHub est créé à l’aide du processus d’autorisation de l’application GitHub, il n’est pas possible de modifier la méthode d’autorisation après l’enregistrement des paramètres du connecteur.