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 (Legacy)

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 et de téléverser des fichiers cibles directement depuis/vers le référentiel GitHub.

Le connecteur utilise l'API GitHub pour implémenter l'intégration. Le connecteur permet d'accéder à tous les référentiels associés à un compte GitHub. L'authentification au 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 du soumissionnaire pour permettre aux soumissionnaires 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 créés automatiquement lorsqu’un changement de taille de fichier est détecté sur les fichiers ou le dossier surveillé.
- Ce connecteur prend en charge le paramétrage de 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 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 du connecteur d'origine n'est pas prise en charge.

Export

Le connecteur GitHub (bêta) regroupe tous les fichiers d'une même exportation dans un seul commit et une seule demande de tirage (pull request), de sorte que l'intégration continue (CI) s'exécute 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écharger les fichiers au fur et à mesure qu'ils sont terminés individuellement, chaque fichier sera validé séparément au lieu d'être regroupé.

Les messages de commit sont générés automatiquement et ne peuvent pas être personnalisés. En cas d'exportation sous forme de 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 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 fonctionner correctement pour les dépôts contenant plus de 50 000 fichiers en raison des limitations de l'API GitHub.
GitHub Enterprise Server n'est pas pris en charge actuellement.
Le nouveau connecteur ne prend pas en charge le flux OAuth de l'ancien connecteur. Si votre organisation impose des restrictions sur les installations d'applications GitHub, résolvez-les avant d'effectuer la migration.

Passage au nouveau connecteur GitHub (bêta)

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

Note

Le passage d'un APC continu de l'ancien connecteur au nouveau connecteur ne constitue pas une migration. Phrase le traite comme une nouvelle configuration de connecteur, de sorte que l'APC réimporte le fichier source en tant que nouveau travail au lieu de mettre à jour celui existant. Le fichier est traité comme un nouveau contenu, de sorte que les mots et les unités de traduction automatique (MTU) précédemment traités ne sont pas conservé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'installation de l'application GitHub doit avoir accès aux dépôts contenant du contenu à traduire, sinon l'importation via APC échouera.
Paramètres APC existants visibles (gardez l'ancien connecteur ouvert dans un deuxième onglet).
Une branche de test ou un dépôt hors production pour valider avant de basculer les flux de travail en direct.

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 GitHub de Phrase.
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 le(s) connecteur(s) existant(s).
  
  GitHub redirige automatiquement vers Phrase.
7. Sélectionnez le compte utilisateur ou 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-dossiers)
  - Expression régulière de filtre de fichier (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 vous utilisez le mode PR)
  Il est possible de créer plusieurs connecteurs sous la même installation d'application GitHub, chacun avec des paramètres indépendants.
Recréez les APC existants en utilisant le mode dry-run.

Ne supprimez pas ou ne désactivez pas encore les APC existants.
1. Créez de nouveaux APC pointant vers le nouveau connecteur, en reproduisant la configuration APC existante.
2. Activez le mode dry-run sur chaque nouvel APC avant de l'activer. Le mode dry-run analyse le dépôt et fait correspondre les fichiers sans déclencher de tâches de traduction.
3. Examinez les fichiers correspondants. Confirmez que le périmètre correspond à ce que l'APC existant surveille.
Validez avec un export de test.
1. Effectuez une petite modification sur un fichier dans le périmètre surveillé.
2. Déclenchez un export 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, et non d'un compte personnel.
  - L'intégration continue (CI) s'exécute une fois, et non une fois par fichier.
Basculez les workflows en production.

Une fois la validation réussie :
1. Désactivez les APC sur l'ancien connecteur.
2. Activez les APC sur le nouveau connecteur (supprimez le mode dry-run).
3. Surveillez 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 Settings → Connectors → GitHub (Legacy).
3. Optionnellement, révoquez le jeton OAuth pour le compte utilisateur qui était utilisé par l'ancien connecteur.

Paramètres GitHub (hérité)

Aucun changement n'est requis.

Paramètres Phrase TMS

Important

En cas d'accès depuis un domaine personnalisé (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 appliquer l'authentification requise pour la création ou l'enregistrement du 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 donnez un nom au connecteur.
Optionnellement, activez Use custom domain et indiquez API URL.
Vous pouvez 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/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 d'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, seuls les dépôts publics seront visibles par le connecteur GitHub.
3. Terminez la procédure d'installation en sélectionnant les dépôts privés qui seront visibles et accessibles par 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é à l'aide de l'application GitHub, une fenêtre contextuelle ou un nouvel onglet apparaîtra pour demander l'autorisation.
Fournissez un 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.

En cas de succès, la fenêtre/l'onglet disparaîtra et une petite coche apparaîtra à 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 flux d'autorisation de l'application GitHub, il n'est pas possible de modifier la méthode d'autorisation après avoir enregistré les paramètres du connecteur.

Supprimer un connecteur

Pour supprimer un connecteur :

Depuis la page Intégrations, sélectionnez le connecteur à supprimer.
Cliquez sur Supprimer.

La fenêtre Supprimer le connecteur s'ouvre.
Tapez « delete » et cliquez sur Supprimer.

Le connecteur est supprimé et la liste des connecteurs s'affiche.

Remarque

Un connecteur ne peut pas être supprimé tant qu'il est encore lié à des tâches incomplètes dans un projet, y compris les tâches se trouvant dans la corbeille. Tenter de supprimer un tel connecteur renvoie une erreur « Échec de la suppression du connecteur ».

Résolution : Ouvrez le projet associé au connecteur et terminez ou supprimez toutes les tâches restantes. Accédez à Paramètres/Corbeille et videz-la pour supprimer toutes les tâches encore liées au connecteur. Réessayez de supprimer le connecteur.